API ReferenceCalls

Analyze call

POST /api/v1/calls/:callId/analyze Generates AI-powered insights from the call transcript: - Summary (2-3 sentences) - Sentiment analysis (positive/neutral/negative + confidence) - Detected intents - Key topics discussed - Action items - Call outcome This endpoint is always available regardless of account auto-analysis settings. Can be used to: - Analyze calls that weren't auto-analyzed - Re-analyze calls with updated AI model Requires the call to be in a terminal state (COMPLETED/FAILED/etc.) and have a transcript available.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

callIdstringRequiredformat: "uuid"
Call ID

Response

AI-powered call analysis with insights

actionItemslist of objects
Action items extracted from the conversation
intentslist of objects
Intents detected from the conversation
topicslist of strings
Topics discussed during the call
callerInfoobject or nullOptional
Caller information extracted from the call transcript by AI analysis
outcomeobject or nullOptional
Call outcome classification determined by AI analysis
sentimentobject or nullOptional
Sentiment analysis result for the overall conversation
summarystring or nullOptional

AI-generated summary of the conversation

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error