Skip to main content
POST
This endpoint is AI-powered and rate limited to 5 requests/minute. It generates a call disposition verdict plan from a call script and its structured data plan.

What it returns

  • disposition — The final verdict the AI should derive from each call (e.g. Suitable / Needs Review / Unsuitable). Pass directly to Initiate AI Call as disposition.
Typical flow: call Generate AI Call Script first, then pass its instructions as call_script and its extract_variables as structured_data_plan to this endpoint.
The request ID for tracing is returned in the X-AI-Request-Id response header.

Authorizations

string | header
required
API key of the form <token>, passed as the x-tidyhire-api-key header.

Body

string
required
The call script the AI will follow on the call. Pass instructions returned by Generate AI Call Script.Example: "You are a recruiter for Acme Corp screening candidates for the Senior Software Engineer role..."
object[]
Structured data fields the AI extracts during the call. Pass extract_variables returned by Generate AI Call Script. Defaults to [].

Response

Call disposition generated successfully
boolean
Indicates if the request was successful. Example: true
object

Common Errors

Reason: The request body is not valid JSON.