POST /plan-runs

POST

/plan-runs

curl --request POST \
  --url https://example.com/plan-runs

Responses

200

Successful response.

Media typeapplication/json

object

planRun

required

object

id

required

string

planId

string | null

source

required

string

Allowed values: plan issues

projectId

required

string

agentName

required

string

promptTemplate

required

string

ref

string | null

providerOverride

string | null

modelOverride

string | null

maxCostUsd

number | null

dispatcherHandle

required

string

trigger

required

string

state

required

string

Allowed values: queued running succeeded failed cancelled

failureReason

string | null

createdAt

required

string

startedAt

string | null

endedAt

string | null

children

required

Array<object>

object

planRunId

required

string

seq

required

integer

seedId

required

string

runId

required

string | null

state

required

string

Allowed values: pending dispatched running pr_open merged failed skipped

createdAt

required

string

updatedAt

required

string

startedAt

string | null

endedAt

string | null

prMergedAt

string | null

failureReason

string | null

Example

{
  "planRun": {
    "source": "plan",
    "state": "queued"
  },
  "children": [
    {
      "state": "pending"
    }
  ]
}

default

Error response (see src/core/errors.ts).

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

hint

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "hint": "example"
  }
}