DEdesplega-ai
Tasks

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

Changed on

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

Request

  • Base URL
    http://localhost:3013
  • URL
    http://localhost:3013/api/tasks/{id}/supersede
  • Auth
    HTTP bearer

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

  • 305e33634408Revision changes
    • warning

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

    • warning

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

  • 9a8d9b86b25bRevision changes
    • warning

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

    • warning

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