Send Calls

Send call data from your voice AI platform to Tuner for analysis. This endpoint accepts call transcripts and metadata, then processes them through Tuner’s evaluation pipeline.

POST https://api.tuner.ai/v1/calls

Send Call Data

cURL

curl --request POST \
  --url https://api.tuner.ai/v1/calls \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "<string>",
  "callId": "<string>",
  "transcript": [
    {
      "transcript[].role": "<string>",
      "transcript[].content": "<string>",
      "transcript[].timestamp": "<string>"
    }
  ],
  "startedAt": "<string>",
  "endedAt": "<string>",
  "metadata": {
    "metadata.durationSeconds": 123,
    "metadata.callDirection": "<string>",
    "metadata.callerPhone": "<string>",
    "metadata.outcome": "<string>"
  }
}
'

200

{
  "success": true,
  "callId": "call_12345",
  "tunerCallId": "tc_abc123def456",
  "message": "Call data received successfully."
}

cURL

curl --request POST \
  --url https://api.tuner.ai/v1/calls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "agent_abc123",
  "callId": "call_12345",
  "transcript": [
    {
      "role": "agent",
      "content": "Hello, thank you for calling. How can I help you today?"
    },
    {
      "role": "user",
      "content": "I would like to schedule an appointment."
    }
  ],
  "startedAt": "2026-01-17T10:00:00Z",
  "endedAt": "2026-01-17T10:02:00Z",
  "metadata": {
    "durationSeconds": 120,
    "callDirection": "inbound",
    "callerPhone": "[phone]"
  }
}
'

200

{
  "success": true,
  "callId": "call_12345",
  "tunerCallId": "tc_abc123def456",
  "message": "Call data received successfully."
}

Authorizations

Authorization · string · required

API key in Bearer token format

Body

agentId · string · required

ID of the agent in Tuner that this call belongs to

Example: "agent_abc123"

callId · string · required

A unique identifier for this call from your system

Example: "call_12345"

transcript · object[] · required

Array of messages in the conversation

Show Show child attributes

transcript[].role · string · required

The speaker role

Available options: agent, user

transcript[].content · string · required

The text content of the message

transcript[].timestamp · string

ISO 8601 timestamp of when the message was spoken

Example: "2026-01-17T10:00:05Z"

startedAt · string

ISO 8601 timestamp of when the call started

Example: "2026-01-17T10:00:00Z"

endedAt · string

ISO 8601 timestamp of when the call ended

Example: "2026-01-17T10:02:00Z"

metadata · object

Additional metadata about the call

Show Show child attributes

metadata.durationSeconds · number

Total duration of the call in seconds

Example: 120

metadata.callDirection · string

Direction of the call

Available options: inbound, outbound

metadata.callerPhone · string

The caller’s phone number

Example: "[phone]"

metadata.outcome · string

The outcome of the call

Example: "success", "failure", "transferred"

Response

success · boolean

Whether the request was successful

callId · string

The call ID you provided in the request

Example: "call_12345"

tunerCallId · string

Tuner’s internal ID for this call. Use this to reference the call in the dashboard.

Example: "tc_abc123def456"

message · string

A human-readable status message

Example: "Call data received successfully."