Fail Decision Task
talonic_fail_decision_taskReport that the claimed decision task cannot be decided: raises a Human Review with your reason AND applies the app's declared fallback policy (rules decide, hold for review, or fail the run).
USE WHEN: the package is insufficient or contradictory and no claimant could decide it. This ends the task (status 'failed'). NOT FOR: temporary give-backs (talonic_release_decision_task) or a decision you can make with low confidence (submit it with confidence set). ARGS: task_id, execution_epoch, reason (up to 2,000 characters). Stale epoch is HTTP 409. AUTH: a tlnc_ key needs a per-app 'decide' grant; an OAuth connector session needs the apps:decide scope (consented at connect) and a live workspace role of senior_member or above. A 403 (decide_grant_required, insufficient_scope, insufficient_tier) names what is missing — tell the user, do not retry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Why the task cannot be decided, up to 2,000 characters. Recorded on the Human Review the fail raises. | |
| task_id | Yes | Decision task UUID. | |
| execution_epoch | Yes | Execution epoch returned by the successful claim. Stale epochs are rejected with 409. |