Apps

Report that the agent cannot decide

Terminates the task, raises a Human Review carrying the stated reason, and applies the app's declared fallback policy (rules, hold, or none) exactly as an SLA expiry does. Permitted after the lease has lapsed: reporting failure must always stay possible.

post/v1/decision-tasks/{id}/fail

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/decision-tasks/{id}/fail
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

execution_epochinteger required
reasonstring required

Stated on the Human Review this raises.

Response

Failed task metadata.

idstring uuid required
customer_idstring uuid required
run_idstring uuid required
app_idstring uuid required
status'available' | 'claimed' | 'submitted' | 'released' | 'failed' | 'timed_out' | 'cancelled' required
execution_epochinteger required
input_package_refstring

Where the frozen package lives; run in v1.

lease_secondsinteger
claimed_bystring nullable

The claimant: an API key id, or oauth:<client_id>:<user_id> for an OAuth session.

claimed_atstring date-time nullable
lease_expires_atstring date-time nullable
heartbeat_atstring date-time nullable
sla_deadline_atstring date-time required

Hard decision deadline; heartbeats never extend the lease past it.

submitted_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.