Scans

Get what a scan's agents are doing

Returns the scan’s Agent Magic state. agents lists every agent with its assignment, status, current focus and closing summary. leads are the questions agents pursued, each open, confirmed, ruled out, or left open when its agent ended before answering it, with its evidence. findings carry the agent that filed them when known. updates are the narrator’s scan updates, newest first, with the refs of the moments it marked as breakthroughs. counters maps each agent to how many times it started each counted tool.

GET

scans

{scanId}

work

Error

A valid request URL is required to generate request examples

{
  "scan_id": "<string>",
  "agents": [
    {
      "agent_id": "<string>",
      "name": "<string>",
      "parent_id": "<string>",
      "task": "<string>",
      "created_at": "<string>",
      "status": "<string>",
      "status_at": "<string>",
      "focus": {},
      "finish": {}
    }
  ],
  "leads": [
    {
      "lead_id": "<string>",
      "agent_id": "<string>",
      "question": "<string>",
      "opened_at": "<string>",
      "status": "open",
      "resolved_at": "<string>",
      "note": "<string>",
      "finding_id": "<string>",
      "evidence": [
        {}
      ]
    }
  ],
  "findings": [
    {}
  ],
  "updates": [
    {}
  ],
  "counters": {}
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

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.

Response

Agent Magic state of the scan.

scan_id

string

agents

object[]

Show child attributes

leads

object[]

Show child attributes

findings

object[]

updates

object[]

counters

object

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "scan_id": "<string>",
  "agents": [
    {
      "agent_id": "<string>",
      "name": "<string>",
      "parent_id": "<string>",
      "task": "<string>",
      "created_at": "<string>",
      "status": "<string>",
      "status_at": "<string>",
      "focus": {},
      "finish": {}
    }
  ],
  "leads": [
    {
      "lead_id": "<string>",
      "agent_id": "<string>",
      "question": "<string>",
      "opened_at": "<string>",
      "status": "open",
      "resolved_at": "<string>",
      "note": "<string>",
      "finding_id": "<string>",
      "evidence": [
        {}
      ]
    }
  ],
  "findings": [
    {}
  ],
  "updates": [
    {}
  ],
  "counters": {}
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

{
  "detail": "<string>",
  "code": "<string>",
  "required_scope": "scans:read",
  "docs": "<string>",
  "hint": "<string>"
}

Analytics

Asset Discovery

Audit

Billing

Chat

CLI

Connectors

Containers

Assets

Test Users

Integrations

Knowledge

License

LLM

Run Logs

Organization

Invitations

Members

PR Reviews

Vulnerabilities

Supply Chain

Scans

Schedules

Search

Tokens

Uploads

Webhooks

Workspaces

Repositories

Get what a scan's agents are doing

Authorizations

Path Parameters

Response