Update Attorney

Updates an existing attorney. Only send fields you want to change. Send null for nullable fields to clear them.

Optional update fields:

• name - Update attorney name
• email - Update email address (send null to clear)
• phoneNumber - Update phone number (send null to clear)
• lawFirmId - Update law firm association (send null to clear)

Required permission: company.attorney:update

PATCH /api/external/companies/{companyId}/attorneys/{attorneyId}

cURL

updateName

curl --request PATCH \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/attorneys/{attorneyId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Updated Attorney Name"
}
'

200

success

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "companyId": "660e8400-e29b-41d4-a716-446655440000",
  "name": "Updated Attorney Name",
  "email": "[e-mail]",
  "phoneNumber": "[phone]",
  "lawFirmId": "770e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2026-01-15T10:30:00.000Z",
  "updatedAt": "2026-02-16T09:00:00.000Z"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

companyId · string<uuid> · required

Company identifier

attorneyId · string<uuid> · required

Attorney identifier

Body

application/json

name · string

Attorney name

email · string<email> | null

Attorney email address (send null to clear)

phoneNumber · string | null

Attorney phone number (send null to clear)

lawFirmId · string<uuid> | null

ID of an existing payee (law firm) to associate (send null to clear). Use GET /payees to find valid IDs.

Response

200

application/json

Attorney updated successfully

An attorney in the system

id · string<uuid>

Attorney identifier

companyId · string<uuid>

Company identifier

name · string

Attorney name

email · string<email> | null

Attorney email address

phoneNumber · string | null

Attorney phone number

lawFirmId · string<uuid> | null

Associated law firm payee identifier

createdAt · string<date-time> | null

When the attorney was created (ISO 8601)

updatedAt · string<date-time> | null

When the attorney was last updated (ISO 8601)