WAwarp
Factories

Update a factory task

Changed on

Partially update a task's title, description, and/or stage. Last write wins. Stage writes are unrestricted: any stage-to-stage transition is allowed, including moving backwards or to completion.

patch/factory/{uid}/tasks/{task_uid}

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.

Request body

titlestring

Updated title. Must be non-empty when provided.

descriptionstring nullable

Updated description. null or an empty string clears the description.

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

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.

Response

Factory task updated successfully

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

      the request property became not nullable

    • 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