Skip to main content
POST
Run specific metrics against call logs

Authorizations

X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Body

call_logs
integer[]
required

IDs of the call logs to evaluate. Example: [123, 456]

metrics
integer[]
required

IDs of the metrics to run. Must belong to the agent/project. Example: [789, 790]

agent_id
integer

Cekura agent ID. Provide this or project_id. Example: 224

project_id
integer

Project ID. Provide this or agent_id. Example: 456

Response

call_id
string
required

Unique identifier for the call. Example:

  • "call_abc123xyz"
  • "stereo_audio_session_456"
Maximum string length: 100
id
integer
read-only
duration
string
read-only

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

success
boolean | null

Whether the call was successful. Example: true or false

is_reviewed
boolean

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

status
enum<string>

Status of the call or conversation. Example: "completed" or "failed"

  • success - Success
  • failure - Failure
  • reviewed_success - Reviewed Success
  • reviewed_failure - Reviewed Failure
Available options:
success,
failure,
reviewed_success,
reviewed_failure
feedback
string

Feedback about the call. Example: "Great Call"

metrics
object[]
read-only

Metrics of the call

call_ended_reason
string

Reason why the call ended. Example:

  • "customer-ended-call"
  • "agent-ended-call"
Maximum string length: 100
customer_number
string

Customer's phone number or identifier. Example:

  • "+1234567890"
  • "customer_abc123"
Maximum string length: 100
agent
integer | null

Agent ID

agent_name
string
read-only

Agent name

trace_id
string

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

Maximum string length: 32
timestamp
string<date-time>

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

error_message
string | null
dropoff_point
string

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

Maximum string length: 1000
topic
string

Topic of the call. Example:

  • "product_inquiry"
  • "technical_support"
Maximum string length: 1000
created_at
string<date-time>
read-only

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

updated_at
string<date-time>
read-only

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

transcript
string

Full text transcript of the call. Example:

transcript_object
string
read-only

Structured transcript data with timestamps. Example:

evaluation
string
read-only

Evaluation of the call