Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Path Parameters

scanId
string<uuid>
required

UUID of the scan. Use the id field of a scan from listScans.

Body

application/json
action
enum<string>
required

pause parks every agent before its next model call. resume wakes them in place; pass max_budget_usd to raise the limit first. stop ends the run: findings and logs are kept, no report is written.

Available options:
pause,
resume,
stop
max_budget_usd
number

New cost limit (USD), resume only. Must be greater than what the scan has already spent.

Required range: x <= 1000000

Response

Action applied.

Cost-limit state of the run as reported by the engine.

success
boolean
policy
enum<string>
Available options:
stop,
pause
max_budget_usd
number | null
spent_usd
number

Actual LLM spend so far. Calls in flight when the limit was reached finish and are counted, so this can exceed max_budget_usd.

over_limit_usd
number
paused
boolean
pause_reason
enum<string> | null
Available options:
budget_limit,
operator,
null
paused_at
string<date-time> | null
agents_active
integer
agents_parked
integer
stop_requested
boolean