API reference
Cancel a tool run
POST
Ask for a queued or processing run to stop. A run that has already finished answers 409.
bearerAuthheader
AuthorizationBearer <token>Your API key, sent as Authorization: Bearer <key>.
id*stringThe run id from the 202 response.
The run, as it stands after the cancel was accepted.
application/json- response
id*stringobject*stringtool*stringstatus*stringValue in
"queued""processing""succeeded""failed""canceled"outcome?"no_match"Set on a succeeded run that found nothing. Billed like any other answer.
Value in
"no_match"output?array<>The result, as signed links like a job's output.
error?usage?created_at*stringFormat
date-timecompleted_at?stringFormat
date-timecurl -X POST "https://example.com/v1/tools/runs/string/cancel" \ -H "Authorization: Bearer $OP_API_KEY"{ "id": "string", "object": "tool.run", "tool": "string", "status": "queued", "outcome": "no_match", "output": [ { "url": "string", "url_expires_at": "2019-08-24T14:15:22Z", "type": "string", "bytes": 0 } ], "error": { "code": "string", "kind": "string", "scope": "string", "message": "string" }, "usage": { "units": { "property1": 0, "property2": 0 }, "cost": { "billing_usd": 0, "cost_source": "string", "cost_status": "string", "price_version": "string" } }, "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z"}Cancel a job POST
Ask for a queued or processing job to stop. A job that has already finished answers `409`.
Create a chat completion POST
Send a conversation and get a reply. Set `stream` to true for server-sent events. A request can fail over to another endpoint only before the first content token; after that the stream ends with a terminal frame instead.