Fail a task out of band
POST/apps/{appId}/tasks/fail
Goes through the same retry decision as a synchronous failure, so reporting a failure out of band is treated identically to responding with an error. retryable: false is believed, and ends the attempt chain immediately. Like a completion, a failure that arrives before Foliot has recorded your 202 is a 409 that leaves the token unspent: send it again. The body is closed: a key the server does not know is a 400, so a misspelled retryable is refused rather than silently dropped.
Path parameters
appId
stringREQUIRED
The app's id, not its name, returned as app.id when the app is created. The id never changes.
Request body
error
objectREQUIRED
token
string (uuid)REQUIRED
The task token from the task request or the poll.