Set Assignees

Sets the assignees for a specific entity. This is a full replacement — the provided list of user IDs completely replaces any existing assignees. Pass an empty array to remove all assignees.

Previously removed assignees are soft-deleted (preserved for audit history) and can be re-assigned.

Required permission: Permission depends on entity type:

• policies → policy:update
• submissions → submission:update
• insureds → insured:update
• events → claim:update

PUT /api/external/companies/{companyId}/{entityType}/{entityId}/assignees

cURL

assignUsers

curl --request PUT \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/{entityType}/{entityId}/assignees \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assigneeIds": [
    "google-oauth2|123456789",
    "google-oauth2|987654321"
  ]
}
'

200

success

{
  "assigneeIds": [
    "google-oauth2|123456789",
    "google-oauth2|987654321"
  ]
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

entityType · enum<string> · required

The type of entity (policies, submissions, insureds, or events) The type of entity to manage assignees for

Available options: policies, submissions, insureds, events

entityId · string<uuid> · required

The ID of the entity

Body

application/json

assigneeIds · string[] · required

Array of user IDs to assign. Replaces all current assignees. Pass an empty array to remove all assignees.

Response

200

application/json

Assignees updated successfully

assigneeIds · string[]

The user IDs that were set as assignees