Update Defendant

Updates a defendant. Only provided fields are updated. Send null for a field to clear its value. Omit a field to preserve its existing value.

Required permission: company.event:export

PATCH /api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants/{defendantId}

cURL

updateContact

curl --request PATCH \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants/{defendantId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[e-mail]",
  "phoneNumber": "[phone]"
}
'

200

success

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "companyId": "660e8400-e29b-41d4-a716-446655440000",
  "lawsuitId": "770e8400-e29b-41d4-a716-446655440000",
  "insuredId": null,
  "nonInsuredName": "John Doe",
  "phoneNumber": "[phone]",
  "email": "[e-mail]",
  "attorneyId": "880e8400-e29b-41d4-a716-446655440000",
  "lawFirmId": null,
  "createdAt": "2026-02-15T10:30:00.000Z",
  "updatedAt": "2026-02-19T14:20: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

eventId · string<uuid> · required

Event identifier

defendantId · string<uuid> · required

Defendant identifier

Body

application/json

insuredId · string<uuid> | null

Update associated insured (send null to clear; mutually exclusive with nonInsuredName)

nonInsuredName · string | null

Update non-insured defendant name (send null to clear; mutually exclusive with insuredId)

phoneNumber · string | null

Update phone number (send null to clear)

email · string | null

Update email address (send null to clear)

attorneyId · string<uuid> | null

Update associated attorney (send null to clear; must reference an existing attorney)

lawFirmId · string<uuid> | null

Update associated law firm (send null to clear; must reference an existing payee)

Response

200

application/json

Updated defendant details

A defendant associated with a lawsuit

id · string<uuid>

Defendant identifier

companyId · string<uuid>

Company identifier

lawsuitId · string<uuid>

Associated lawsuit identifier

insuredId · string<uuid> | null

Associated insured identifier (mutually exclusive with nonInsuredName)

nonInsuredName · string | null

Name of non-insured defendant (mutually exclusive with insuredId)

phoneNumber · string | null

Defendant phone number

email · string<email> | null

Defendant email address

attorneyId · string<uuid> | null

Associated attorney identifier

lawFirmId · string<uuid> | null

Associated law firm payee identifier

createdAt · string<date-time> | null

When the defendant was created (ISO 8601)

updatedAt · string<date-time> | null

When the defendant was last updated (ISO 8601)