Skip to main content
PATCH
/
api
/
external
/
companies
/
{companyId}
/
attorneys
/
{attorneyId}
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"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "companyId": "660e8400-e29b-41d4-a716-446655440000",
  "name": "Updated Attorney Name",
  "email": "jane@smithlaw.com",
  "phoneNumber": "+1-555-123-4567",
  "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 key in the Authorization header: Authorization: ApiKey YOUR-API-KEY

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

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)