Skip to content
BrainyShorts Docs
Esc
↑↓navigate↵open⌘Jpreview

Skip a claimed run (legacy queue)

Finishes a valid no-op without consuming retries.

POST/api/agent/runs/{id}/skip
Authorization
AuthorizationBearer token (ba_sk_...) · headerrequired

API key from /dashboard/api-keys. Keys expire after 365 days.

or
AuthorizationBearer token (ba_mcp_access_...) · headerrequired

The OAuth access token the hosted MCP server issues (brainy:read for GET routes, brainy:write for everything else). One login serves MCP, the CLI and the desktop app. A token without the needed scope gets 403 Insufficient scope.

Path parameters
idstringrequired

Run id

Request body
requiredapplication/json
claim_tokenstringrequired
reasonstringrequired
max length 1000
codestring
max length 100 · default: "SKIPPED"
Responses
200

OK

runobject
401

Missing, invalid, expired, or revoked API key

errorstringrequired
codestring
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST "https://www.brainyshorts.com/api/agent/runs/string/skip" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "claim_token": "string",
  "reason": "string",
  "code": "SKIPPED"
}'
Response
{
  "run": {}
}