v56

OpenAPI 3.1.0raw.githubusercontent.com2026-08-043240557.2 KB
Tasks

Supersede an in-progress task (terminate + spawn resume follow-up)

Marks the original task superseded (terminal) and creates a fresh taskType="resume" follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with workflowRunStepId) are carved out: the original is marked failed with reason superseded_workflow_task and no follow-up is created — the workflow engine's retry/failure policy applies.

post/api/tasks/{id}/supersede

Path parameters

idstring required

Request body

reason'graceful_shutdown' | 'context_limits' | 'manual_supersede' | 'crash_recovery' required

Response

Task superseded (or workflow-failed)