Skip to content

Per-call emotion arc — per-turn 4-axis timeline + final sentiment

GET
/api/v1/calls/{call_id}/emotions

Return the emotion arc for a single call.

Tenant isolation: the repository is called with tenant_id = UUID(user.tenant_id) so another tenant cannot retrieve this call’s scores even if they guess the call_id.

Args: call_id: Retell call identifier. user: Authenticated principal (injected). session: Async DB session (injected).

Returns: The canonical emotion arc JSON shape; see :meth:EmotionArc.as_dict.

Raises: HTTPException: 404 when no emotion rows exist for the authenticated tenant’s copy of call_id.

Authorizations

Parameters

Path Parameters

call_id
required
string

Responses

200

Successful Response

object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string