Calls

Update Call

Update an existing call record by UUID.

This endpoint is designed for the voice agent to update call details after the call is created. Requires a per-customer agent token for authentication. The customer_id is automatically extracted from the agent token.

All fields are optional - only provided fields will be updated. The call must belong to the customer associated with the agent token.

Returns:

success: True if the call was updated successfully
call_id: The UUID of the updated call record

patch/calls/{call_id}

Path parameters

call_idstring uuid required

Request body

phone_numberstring nullable

Phone number associated with the call

duration_secondsinteger nullable

Duration of the call in seconds

case_idstring uuid nullable

Case ID associated with the call

forwarded_call_sidstring nullable

Forwarded Twilio CallSid (for SIP forwarding)

session_idstring nullable

Unique session identifier from voice agent

end_timestring date-time nullable

When the call ended

caller_namestring nullable

Name of the caller if collected

caller_emailstring nullable

Email of the caller if collected

has_errorboolean nullable

Whether any errors occurred during the call

error_descriptionstring nullable

Description of the error if one occurred

caller_client_statusstring nullable

Client status of the caller: 'existing_client', 'new_client', or null

transferredboolean nullable

Whether the call was transferred live to a human

transfer_destination_numberstring nullable

E.164 number the call was transferred to

hit_voicemailboolean nullable

Whether an outbound call reached voicemail

hung_up_before_connectboolean nullable

Whether the caller hung up before the call connected

Response

Successful Response

successboolean required

Whether the call was updated successfully

call_idstring uuid required

The ID of the updated call record

Changes

No recorded changes to this endpoint across all 1 revision of this API.