Observability

Update a call

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

Authentication

AuthorizationBearer

JWT token from RubricHQ Settings → API Keys

Path parameters

idstringRequired

Internal call ID or your call_identifier.

Query parameters

client_idintegerRequired

Required. RubricHQ client (workspace) ID that owns this call.

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
idinteger
Internal RubricHQ call ID.
call_identifierstring
Your provided call identifier.
analysis_statusenum
  • pending — analysis queued or in progress
  • computed — all metrics computed successfully
  • failed — analysis encountered an error

Errors

404
Not Found Error