--- title: "Cortex Outbound Call" method: POST path: "/api/v1/voice/cortex_outbound_call" tags: ["calls"] --- # Cortex Outbound Call `POST /api/v1/voice/cortex_outbound_call` ## Request - Base URL: `https://api.outrival.com` (the document declares no server; this is the origin it was published from) - URL: `https://api.outrival.com/api/v1/voice/cortex_outbound_call` - Auth: HTTP bearer Place a Cortex call now, or refuse with the reason and the next allowed time. 200 ``{outcome: placed, interaction_id, receipt}`` or ``{outcome: failed, reason, receipt, released, release_reason}``. Refusals carry ``detail.reason`` and leave the contact untouched, except when a call prepared earlier for this run and never dialed was returned to ``awaiting_cortex``: the refusal then carries ``released: true``. ## Request body - CortexOutboundCallRequest - `brain_run_id` string, required - `campaign_contact_id` string, uuid, required - `deadline_at` string, date-time, nullable - `is_follow_up` boolean, required - `objective` string, required ## Response `200` Successful Response - unknown ## Other responses - `400`: reason=invalid_arguments - `403`: reason=service_role_required | ; a blocker's detail carries blockers, next_open_at and availability - `404`: reason=contact_not_found | run_not_found - `409`: reason=run_not_active | request_conflict | already_prepared | stale_source | busy | contact_not_awaiting_cortex | contact_busy | contact_terminal | deadline_passed - `422`: Validation Error - `429`: reason=rate_limited - `503`: reason=cortex_outbound_call_disabled | prepare_failed | rate_limit_error | policy_error ## Changes - **2026-10-27** `365940ec2d29`: 1 info - endpoint added [Operation history](https://skmtc.dev/outrival/apis/fastapi/changes/api/v1/voice/cortex_outbound_call/post.md) --- [API](https://skmtc.dev/outrival/apis/fastapi.md) - [All operations](https://skmtc.dev/outrival/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/outrival/apis/fastapi/revisions/f27d90300b5e?raw)