text
string
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Stop a run that waits at Check with me. Only the person says go.
curl --request POST \
--url https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"choice": "stop",
"step": "c",
"text": "Not this week"
}
'import requests
url = "https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer"
payload = {
"choice": "stop",
"step": "c",
"text": "Not this week"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({choice: 'stop', step: 'c', text: 'Not this week'})
};
fetch('https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'choice' => 'stop',
'step' => 'c',
'text' => 'Not this week'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer"
payload := strings.NewReader("{\n \"choice\": \"stop\",\n \"step\": \"c\",\n \"text\": \"Not this week\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"choice\": \"stop\",\n \"step\": \"c\",\n \"text\": \"Not this week\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"choice\": \"stop\",\n \"step\": \"c\",\n \"text\": \"Not this week\"\n}"
response = http.request(request)
puts response.read_body{
"run": {
"run_id": "0d9c6c1e-5b8e-4a59-9d3b-7a1f2c3d4e5f",
"state": "stopped",
"at": 1793887204000,
"by": "Claude Code",
"inputs": {},
"steps": [
{
"id": "a",
"title": "9:00 AM",
"kind": "start",
"how": "ran",
"ms": 4,
"output": {}
},
{
"id": "b",
"title": "Write the report",
"kind": "agent",
"how": "ran",
"ms": 21400,
"output": {
"report": "3 new customers yesterday."
}
}
],
"output": {
"report": "3 new customers yesterday."
},
"finished_at": "2026-11-05T14:00:31.000Z"
}
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "Too many API requests this minute (120 a minute on your plan). Try again in 12 seconds.",
"code": "rate_limited",
"limit": "api_other_per_minute",
"retry_after": 12
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}"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.
curl -X POST https://www.orgo.ai/api/workflows/morning-report/runs/$RUN_ID/answer \
-H "Authorization: Bearer $ORGO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"choice":"stop","step":"c","text":"Not this week"}'
import os, requests
r = requests.post(
f"https://www.orgo.ai/api/workflows/morning-report/runs/{run_id}/answer",
headers={"Authorization": f"Bearer {os.environ['ORGO_API_KEY']}"},
json={"choice": "stop", "step": "c", "text": "Not this week"},
)
await fetch(`https://www.orgo.ai/api/workflows/morning-report/runs/${runId}/answer`, {
method: "POST",
headers: { Authorization: `Bearer ${process.env.ORGO_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ choice: "stop", step: "c", text: "Not this week" }),
});
$RUN_ID with the run’s run_id.
403){
"error": "Only the person can approve this step. Ask them to open the workflow and press Go, or stop the run with { \"stop\": true }.",
"code": "person_required",
"next": "Tell the person the run waits for them: they say go on the canvas. You may stop it with { \"choice\": \"stop\" }."
}
| Status | Code | When |
|---|---|---|
400 | invalid_body | A choice that is not go or stop. |
400 | step_required | No step, and the workflow asks more than once. The body carries waiting. |
401 | No key, or a key Orgo doesn’t know. | |
403 | person_required | "go" from an API key or an MCP sign-in. |
403 | key_permission | A restricted key without Workflows write. |
404 | not_found | No workflow, or no run, by that id. |
404 | (no body) | Workflows aren’t open to your account. |
409 | run_not_waiting | It no longer waits at that step. The body carries the run: read it before you answer again. |
409 | run_waits_for_agent | It waits for another agent, not a person. Stop it with Stop a run, or wait for the agent’s answer. |
413 | body_too_large | The body is over 32 KB. |
429 | rate_limited | More than 30 runs and answers a minute for this workflow, or 120 for the account. Carries Retry-After. |
503 | runs_unavailable | Runs can’t be changed here right now. Retry after a minute. |
503 | Orgo couldn’t verify the key because of a server-side fault. Retry. |
curl --request POST \
--url https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"choice": "stop",
"step": "c",
"text": "Not this week"
}
'import requests
url = "https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer"
payload = {
"choice": "stop",
"step": "c",
"text": "Not this week"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({choice: 'stop', step: 'c', text: 'Not this week'})
};
fetch('https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'choice' => 'stop',
'step' => 'c',
'text' => 'Not this week'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer"
payload := strings.NewReader("{\n \"choice\": \"stop\",\n \"step\": \"c\",\n \"text\": \"Not this week\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"choice\": \"stop\",\n \"step\": \"c\",\n \"text\": \"Not this week\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.orgo.ai/api/workflows/{id}/runs/{runId}/answer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"choice\": \"stop\",\n \"step\": \"c\",\n \"text\": \"Not this week\"\n}"
response = http.request(request)
puts response.read_body{
"run": {
"run_id": "0d9c6c1e-5b8e-4a59-9d3b-7a1f2c3d4e5f",
"state": "stopped",
"at": 1793887204000,
"by": "Claude Code",
"inputs": {},
"steps": [
{
"id": "a",
"title": "9:00 AM",
"kind": "start",
"how": "ran",
"ms": 4,
"output": {}
},
{
"id": "b",
"title": "Write the report",
"kind": "agent",
"how": "ran",
"ms": 21400,
"output": {
"report": "3 new customers yesterday."
}
}
],
"output": {
"report": "3 new customers yesterday."
},
"finished_at": "2026-11-05T14:00:31.000Z"
}
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}{
"error": "Too many API requests this minute (120 a minute on your plan). Try again in 12 seconds.",
"code": "rate_limited",
"limit": "api_other_per_minute",
"retry_after": 12
}{
"error": "<string>",
"code": "<string>",
"say": "<string>",
"next": "<string>",
"to_fix": [
"<string>"
],
"problems": [
{}
],
"version": 123,
"lines": "<string>"
}