Observability

Update a call

Update mutable fields on an existing call observation. Immutable fields (call_identifier, agent_id, client_id, recording_url, transcript) cannot be changed after ingestion.

Authentication

AuthorizationBearer

API key from RubricHQ Settings → API Keys. Send it as: Authorization: Bearer <YOUR_API_KEY>.

Path parameters

idstringRequired

Your call_identifier, or RubricHQ’s internal integer call ID.

Query parameters

client_idintegerOptional

Optional. RubricHQ client (workspace) ID. Defaults to the workspace your API key belongs to; pass it only to target another workspace you can access.

agent_idintegerRequired
Required. RubricHQ agent ID that owns this call.

Request

This endpoint expects an object.
labelstringOptional

Free-text label for this call (visible in the dashboard).

tagstringOptional

Short tag for grouping/filtering calls.

customer_numberstringOptional
Customer phone number.
call_end_reasonstringOptional

How the call ended (e.g. Completed, Dropped, Transferred).

metadatamap from strings to anyOptional

Merged into the existing metadata (not a full replace). Keys you send are added or overwritten; keys you omit are preserved. Send a key with a null value to delete it.

Response

Updated call
idintegerOptional
Internal RubricHQ call ID.
call_identifierstringOptional
Your provided call identifier.
analysis_statusenumOptional
  • pending — analysis queued or in progress
  • computed — all metrics computed successfully
  • failed — analysis encountered an error

Errors

404
Not Found Error