v4
latestOpenAPI 3.1.02026-08-03553368548.9 KBdeviation-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