Sign in
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)

successtrue required
kind'alreadyFinished' | 'workflow-failed' | 'resumed' required
resumeTaskIdstring nullable required
resumeTaskStatus'draft' | 'backlog' | 'unassigned' | 'offered' | 'reviewing' | 'pending' | 'in_progress' | 'paused' | 'completed' | 'failed' | 'cancelled' | 'superseded'

Changes

Changed in 4 of the 104 revisions of this API.46

  • 0f5503f5cd282See the full diff
    • ●

      added the new acp enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new acp enum value to the ////// response property for the response status

      response-property-enum-value-added

  • 09d5eb0300932See the full diff
    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///// to the response with the status

      response-optional-property-added

  • 6f2d2fbe25992See the full diff
    • ●

      added the new draft enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new draft enum value to the ///// response property for the response status

      response-property-enum-value-added

  • 06cac6a7c5bc4See the full diff
    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the media type application/json for the response with the status

      response-media-type-added

    • ○

      added the media type application/json for the response with the status

      response-media-type-added