Skip to main content
POST
End a live call
This capability is in beta. Behavior can change before general availability.
Stopping a call that is not live returns call_not_live. The result follows the same privacy rules as getting a call.

Authorizations

Authorization
string
header
required

An API key (tars_sk_…) sent as Authorization: Bearer <key>. Each operation names the permission it needs. Create keys in Settings → Integrations → API keys.

Path Parameters

id
string
required

The call id (call_…).

Required string length: 1 - 128

Response

The call.

One call with its variables, transcript and signed recording links. Protected values are null unless the key has the Read protected call details permission.

callId
string
required

The call id (call_…).

kind
enum<string>
required
Available options:
retained,
deleted
status
string
required
agentId
string | null
agentName
string | null
agentVersion
number | null
conversationId
string | null
contactId
string | null
source
string
direction
string
displayStatus
string
timing
object
variables
object
transcript
object[]
transcriptTruncated
boolean
recordings
object[]