v4

latestOpenAPI 3.1.02026-08-03553368548.9 KB
deviation-report

Report Deviation

Report a deviation detected during an active call.

This endpoint is called by the AI agent when it detects:

  • Going off-script or off-topic
  • Violating prompt rules (e.g., revealing AI identity, using external knowledge)
  • Early signs of failure (negative sentiment, customer frustration)

Supports both:

  • Query parameters (from Ultravox tool calls)
  • JSON body (from manual API calls)

Returns: DeviationReportResponse confirming the report was received

post/api/v1/report-deviation

Query parameters

call_idstring nullable

Call ID (query param for Ultravox)

Call ID (query param for Ultravox)

deviation_typestring nullable

Type of deviation

Type of deviation

descriptionstring nullable

Description of deviation

Description of deviation

transcript_excerptstring nullable

Transcript excerpt

Transcript excerpt

Response

Successful Response

successboolean required

Whether the report was successful

messagestring required

Status message

call_idinteger required

Call ID

deviation_typestring required

Type of deviation reported