WAwarp
Factories

Generate a blueprint proposal for a factory

Changed on

Starts an agent run that proposes a blueprint, as a pull request, for a factory that does not yet have one.

post/factory/{uid}/blueprint-proposal

Request

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

Path parameters

uidstring required

The public UID of the factory.

Response

Blueprint proposal run started

run_idstring required

Unique identifier for the dispatched run.

run_urlstring

URL to view the dispatched run in the Factory app. Empty when the Factory app origin is not configured.

state'QUEUED' | 'PENDING' | 'CLAIMED' | 'INPROGRESS' | 'SUCCEEDED' | 'FAILED' | 'BLOCKED' | 'ERROR' | 'CANCELLED' required

Current state of the run:

  • QUEUED: Run is waiting to be picked up
  • PENDING: Run is being prepared
  • CLAIMED: Run has been claimed by a worker
  • INPROGRESS: Run is actively being executed
  • SUCCEEDED: Run completed successfully
  • FAILED: Run failed
  • BLOCKED: Run is blocked (e.g., awaiting user input or approval)
  • ERROR: Run encountered an error
  • CANCELLED: Run was cancelled by user
factory_uidstring required

Public UID of the factory the run was dispatched to.

foreman_agentstring required

Name of the factory's foreman agent that received the run.

ticket_refstring required

The canonical <source>:<id> ticket reference the run was stamped with, either the caller-supplied ticket_ref or a minted adhoc reference.

Changes