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.

Headers

Idempotency-Key
string

Opaque caller-generated key for at-most-once billable scan creation; use a high-entropy value such as a UUID. Reuse the exact same key only when retrying the exact same request. Completed keys are retained for at least 24 hours; an unfinished accepted worker receipt may be held longer until its downstream queue horizon is safely reconciled. A completed failure is terminal for that key. Keyed terminal responses echo Idempotency-Key and set Idempotency-Replayed to true only when returning a stored outcome.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/=-]{0,199}$

Path Parameters

scheduleId
string
required

ID of the schedule. Use the id field of a schedule from listSchedules.

Response

The manual fire was durably accepted by the queue. This does not assert that the asynchronously launched scan has completed successfully.

success
boolean
required