job_fail
- Category: jobs_lanes
- Access: write
- Audience: ordinary (an ordinary user normally calls this directly)
Purpose
Fail your claimed job back to queued for retry (or any claimed job, conductor).
Arguments
Required: job_id.
Optional: error, locale.
-
job_id. Note: Claimed job id. -
error. Note: Optional error text (recorded). -
locale.
Result
JSON object with job_id and state queued.
Boundaries
Project-scoped; out-of-scope reads as missing. Owner-or-conductor on claimed rows.
Lifecycle / side effects
queued -> claimed -> completed|failed (terminal) or fail-requeued; attempts kept.
Errors
Bad ids/states rejected. Failures move nothing (atomic).
Example
{
"error": "timeout",
"job_id": "..."
}
Result shape:
{
"state": "queued"
}