CEcekura
observability

Update call log source data

Changed on

Updates source data for an existing production call log.

Supported fields

  • call_id — Provider call identifier. Subject to the organization's duplicate-call-ID policy.

  • transcript_json — Structured transcript in a supported provider or Cekura format. Use transcript_type to specify the format, or omit it for automatic detection. This replaces both transcript representations.

  • timestamp — Call start time in ISO 8601 format.

  • duration — Call duration in minutes.

  • call_ended_reason and customer_number — Provider-supplied call attributes.

  • metadata and dynamic_variables — JSON objects merged at the top level with the existing values. Supplied keys overwrite matching keys; omitted keys are preserved.

  • status and feedback — Human review data. status accepts success, failure, reviewed_success, or reviewed_failure.

  • reevaluate_metrics — when true, evaluate metrics on the call log after applying this update. Defaults to false.

Restrictions Only the fields listed above are accepted. System-managed fields, including agent and project ownership, metric evaluations, topic, and dropoff point, cannot be updated.

Metric evaluation Metrics are not recomputed unless reevaluate_metrics is true. For a call ingested with deferred evaluation, this releases its first evaluation; otherwise it re-evaluates an already evaluated call. Calls whose evaluation is still running are left untouched. To evaluate several call logs at once, use rerun_evaluation instead.

patch/observability/v2/call-logs/{id}/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/observability/v2/call-logs/{id}/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer
    • or HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this call log.

Request body

status'success' | 'failure' | 'reviewed_success' | 'reviewed_failure'

Human-reviewed call outcome. Use success, failure, reviewed_success, or reviewed_failure.

  • success - Success
  • failure - Failure
  • reviewed_success - Reviewed Success
  • reviewed_failure - Reviewed Failure
feedbackstring

Human feedback about the call.

call_idstring

Unique identifier for the call. Example:

  • "call_abc123xyz"
  • "stereo_audio_session_456"
transcript_type'cekura' | 'vocera' | 'vapi' | 'retell' | 'deepgram' | 'pipecat' | 'livekit' | 'elevenlabs'

Format of the transcript_json payload. Tells Cekura how to parse roles and timestamps.

  • vapi — Vapi webhook format: [{"role": "bot"|"user", "message": "...", "time": 0.0}]
  • retell — Retell webhook format
  • elevenlabs — ElevenLabs format
  • livekit — LiveKit format
  • pipecat — Pipecat format
  • deepgram — Deepgram format
  • cekura (default) — [{"role": "Testing Agent"|"Main Agent", "content": "...", "start_time": 0.0, "end_time": 2.5}]. Valid roles are "Testing Agent" and "Main Agent" only — using "agent" or "user" will return a validation error.

Omit this field to detect the supported format automatically.

  • cekura - cekura
  • vocera - vocera
  • vapi - vapi
  • retell - retell
  • deepgram - deepgram
  • pipecat - pipecat
  • livekit - livekit
  • elevenlabs - elevenlabs
transcript_jsonunknown
timestampstring date-time

When the call occurred. Example: 2024-03-15T10:15:45Z

durationnumber double

Call duration in minutes as a non-negative number. For example, use 1.5 for one minute and 30 seconds.

call_ended_reasonstring

Reason why the call ended Example:

  • "customer-ended-call"
  • "agent-ended-call"
customer_numberstring

Customer's phone number or identifier Example:

  • "+1234567890"
  • "customer_abc123"
metadataobject

Additional call metadata. Supplied top-level keys are merged with existing metadata; supplied keys overwrite matching keys and omitted keys are preserved. Example:

{
    "customer_id": "123",
    "order_id": "ORD-12345",
    "name": "John Doe"
}
dynamic_variablesobject

Dynamic variables used to replace {{variables}} in agent description. Supplied top-level keys are merged with existing variables; supplied keys overwrite matching keys and omitted keys are preserved. Example:

{
    "subscription_id": "SUB-12345",
    "product_type": "premium"
}
reevaluate_metricsboolean

Run metric evaluation on the call log after applying this update. Releases a call that was ingested with deferred evaluation, otherwise re-evaluates an already evaluated call. Calls whose evaluation is still running are left untouched.

Response

idinteger
durationstring

Call duration in minutes in MM:SS format. Example: 01:10

voice_recording_urlstring

URL to access the voice recording. Example: "https://storage.example.com/recordings/call_123_20240315.mp3"

status'success' | 'failure' | 'reviewed_success' | 'reviewed_failure'
  • success - Success
  • failure - Failure
  • reviewed_success - Reviewed Success
  • reviewed_failure - Reviewed Failure
agent_idstring

Agent ID. Example: 2142

agent_namestring

Agent name

agent_versionobject nullable

The agent version (history record) that was live when this call was ingested, or null.

metadataobject

Additional call metadata. Example:

{
    "ended_reason": "customer-ended-call",
    "ringing_duration": 3.941,
    "call_type": "inbound"
}
dynamic_variablesobject

Dynamic Variables used in the call. Example:

{
    "customer_name": "John Doe",
    "order_id": "ORD-12345",
    "product_type": "premium"
}
testing_channel_indexinteger nullable

The channel index of the testing agent in the audio recording

waveformobject

Amplitude envelope of the recording, one array of values per audio channel, so a waveform can be drawn without downloading the audio. Null for recordings processed before peaks were stored.

timestampstring date-time

When the call occurred. Example: 2024-03-15T10:15:45Z

successboolean nullable

Whether the call was successful. Example: true or false

is_reviewedboolean

Whether the call has been reviewed. Example: true or false

feedbackstring

Feedback about the call. Example: "Great Call"

rubricunknown
transcriptstring

Full text transcript of the call. Example:

[00:01] Testing Agent: Hello. 
[00:02] Main Agent: Hello, how can I help you today?
[00:03] Testing Agent: Well, I mean, sure. What time exactly are we talking about here
[00:04] Main Agent: 6 PM.
[00:05] Testing Agent: Great. I'll book that for you. Just a sec.
[00:06] Main Agent: Okay.
call_ended_reasonstring

Reason why the call ended. Example:

  • "customer-ended-call"
  • "agent-ended-call"
dropoff_pointstring

Point in conversation where user disengaged. Example: "end of conversation as no queries remaining"

topicstring

Topic of the call. Example:

  • "product_inquiry"
  • "technical_support"
customer_numberstring

Customer's phone number or identifier. Example:

  • "+1234567890"
  • "customer_abc123"
user_generated_transcriptunknown
error_messagestring nullable
created_atstring date-time

When this record was created. Example: 2024-03-15T10:30:45Z

updated_atstring date-time

When this record was last updated. Example: 2024-03-15T10:35:11Z

call_idstring required

Unique identifier for the call. Example:

  • "call_abc123xyz"
  • "stereo_audio_session_456"
trace_idstring

OpenTelemetry trace ID (32-char hex). Set when OTel tracing is enabled.

is_log_presentboolean

Whether provider execution logs are stored for this call.

agentinteger nullable

Agent ID

projectinteger nullable

Project ID (denormalized from agent for query performance)

Changes