CEcekura
observability

Re-run metric evaluation on call logs

Changed on

Trigger metric re-evaluation on one or more existing call logs. Provide either agent_id or assistant_id (not both) to identify the agent, then specify which call logs to re-evaluate.

call_logs accepts:

  • A list of call log IDs: [1, 2, 3]
  • The string "all" to re-evaluate every call log for the agent

Side effect: for non-reviewed call logs, success is reset to null before re-evaluation begins. Reviewed call logs retain their human-approved outcome.

Rate limited. If the limit is exceeded you will receive a 429 response — wait for the Retry-After duration before retrying.

post/observability/v2/call-logs/rerun_evaluation/

Request

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

Request body

agent_idinteger required

Cekura agent ID. Provide this or assistant_id, not both. Example: 2142

assistant_idinteger required

External assistant identifier. Provide this or agent_id, not both. Example: 2143

call_logsinteger[] required

List of call log IDs to re-evaluate, or the string "all" for all call logs. Example: [1, 2, 3]

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