WAwarp
Factories

Stop a factory task

Changed on

Cancel the task's current top-level run and move the task to CANCELLED. Every non-terminal descendant of the root run is cancelled as well.

post/factory/{uid}/tasks/{task_uid}/cancel

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Path parameters

uidstring required

The public UID of the factory.

task_uidstring required

The public UID of the task.

Response

Task stopped. The response reflects the refreshed task, including its current run and stage.

uidstring required

Public UID of the task.

factory_uidstring required

Public UID of the factory the task belongs to. Fixed at creation.

conversation_idstring required

UUID of the agent conversation the task is bound to.

run_idstring required

ID of the bound conversation's most recent run at task creation. This is a provenance snapshot and is not updated afterward; consumers needing the conversation's live latest run should resolve it via the conversation.

titlestring required

Human-readable title of the task.

ticket_sourcestring

Canonical ticket source from the bound run. Present on list responses only when full_list=true and ticket metadata exists.

ticket_idstring

Canonical ticket ID from the bound run. Present on list responses only when full_list=true and ticket metadata exists.

descriptionstring nullable

Optional description of the task.

stage'TRIAGE' | 'SPEC' | 'IMPLEMENT' | 'REVIEW' | 'COMPLETE' | 'CANCELLED' required

Lifecycle stage of a factory task, mirroring the seeded factory agent roles plus the terminal COMPLETE and CANCELLED states. COMPLETE and CANCELLED are terminal in intent but not enforced: any stage may be written explicitly at any time. CANCELLED is set automatically when the task's current top-level run is cancelled, regardless of that run's agent type.

created_atstring date-time required

Time the task was created.

updated_atstring date-time required

Time the task was last created, updated, or deleted. Artifact reporting does not bump this; new outputs appear on the next detail read.

Changes

  • 2c45dcc0a13eRevision changes
    • breaking

      removed the required property //////// from the response with the status

    • info

      added the optional property to the response with the status

  • 96d1e59a65c5Revision changes
    • info

      endpoint added