cliDeterministic

List agent work orders

pipeline list-agent-work-orders

List Agent Teams work orders that an external coding agent can claim. Each item identifies the current stage, internal role, typed task, status, and revision. Launch and sending stages are excluded because Pipeline Campaign Workflows retain ownership. Read-only.

Parameters

workspaceId

string

Optional with an API key, inferred from the key.

limit

number

Maximum claimable work orders to return, 1 to 50. Defaults to 20.

Example

CLI commandbash

pipeline list-agent-work-orders

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "workOrders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "objective": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "currentStage": {
            "type": [
              "string",
              "null"
            ]
          },
          "role": {
            "type": "string"
          },
          "taskType": {
            "type": "string"
          },
          "revision": {
            "type": "number"
          },
          "updatedAt": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "objective",
          "status",
          "role",
          "taskType",
          "revision",
          "updatedAt"
        ]
      }
    }
  },
  "required": [
    "workOrders"
  ]
}

Exit codes

1: Invalid input or local configuration.
2: The API or tool returned an error.
3: Authentication failed.
4: A network request failed.