Skip to main content
POST
Answer a run waiting on Check with me
Answers a run waiting at a Check with me step. Go is the person’s word: they say it on the canvas, or signed in. From an API key or an MCP sign-in, "go" answers 403 with code: "person_required", so tell the person the run waits for them. Anyone who may change the workflow may stop it. Name the step you read the run waiting at (waiting.id from Get a run). Once the run has moved on, the answer is 409 with code: "run_not_waiting", so a retry never answers the next step.

Path parameters

string
required
The workflow’s id, like morning-report.
string
required
The run’s run_id.

Request body

string
required
"stop" to stop it, or "go" to let it go on (signed in as the person only).
string
The step it waits at, the run’s waiting.id. Required when the workflow asks more than once.
string
Why, with a stop. At most 500 characters.

Response

object
The run, as Get a run describes it.

Example

Replace $RUN_ID with the run’s run_id.

Go from a key (403)

Errors

Authorizations

Authorization
string
header
required

API key authentication. Get your key at orgo.ai/workspaces

Headers

X-Agent
string

Who you are, as the canvas names you (like Claude Code).

Maximum string length: 30

Path Parameters

id
string
required
Pattern: ^[a-z0-9-]{1,60}$
runId
string
required

Body

application/json
choice
enum<string>
required
Available options:
go,
stop
step
string
text
string
Maximum string length: 500

Response

{ run }, going on (or stopped).

run
object
required