Stop a run
Stops the run, explicitly and on the record. This is the only control an api key has over its own run, by design: stopping only ever reduces what an agent does, so it cannot be used to escalate. Approving and resuming stay member-token operations.
Authorization
bearerAuth Authorization for API
In: header
Path Parameters
The run handle returned by POST /agent/invoke.
Your app's unique id. Find it in the console under the app's Settings, or in the URL of any app page.
uuidResponse Body
application/json
application/json
application/json
curl -X POST "https://example.com/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent/runs/string/abort"{ "runUid": "string", "status": "string", "resumable": true, "message": "string", "pendingSteps": [ { "stepIndex": 0, "tool": "string", "riskLevel": "string", "input": {} } ], "steps": [ { "stepIndex": 0, "tool": "string", "status": "string", "output": {}, "detail": "string" } ], "actions": { "poll": "string", "dashboard": "string" }}API Reference
The data-plane REST API, generated from the running server's own contract.
Call one tool directly
Runs exactly this tool, with no model in the loop — deterministic, and cheaper than an orchestrated run when you already know what you want done. The body is the tool's arguments. It accepts `{ "input": { … } }`, `{ "arguments": { … } }`, or the bare argument object. **Governance still applies.** A tool your policy marks high-risk does not execute here either: the response is `202` with a `runUid`, the call waits in the approval inbox, and you poll the run for its outcome. The direct door is faster, not looser. Equivalent to MCP `tools/call`.