List asset discovery runs

GET

asset-discovery

Error

A valid request URL is required to generate request examples

{
  "runs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "<string>",
      "seeds": [
        "<string>"
      ],
      "org_names": [
        "<string>"
      ],
      "status": "pending",
      "asset_count": 123,
      "new_asset_count": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "instructions": "<string>",
      "summary": "<string>",
      "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "failure_code": "launch_failed",
      "detail": "<string>",
      "created_by": "<string>",
      "queued_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z",
      "auto_pentest_scan_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "auto_pentest_error": "<string>"
    }
  ],
  "live_run": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "seeds": [
      "<string>"
    ],
    "org_names": [
      "<string>"
    ],
    "status": "pending",
    "asset_count": 123,
    "new_asset_count": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "instructions": "<string>",
    "summary": "<string>",
    "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "failure_code": "launch_failed",
    "detail": "<string>",
    "created_by": "<string>",
    "queued_at": "2023-11-07T05:31:56Z",
    "started_at": "2023-11-07T05:31:56Z",
    "finished_at": "2023-11-07T05:31:56Z",
    "auto_pentest_scan_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "auto_pentest_error": "<string>"
  },
  "seed_domains": [
    "<string>"
  ],
  "schedule": {
    "cron": "<string>",
    "timezone": "<string>",
    "seeds": [
      "<string>"
    ],
    "notify_events": [
      "new_assets"
    ],
    "notify_slack": true,
    "slack_channel_id": "<string>",
    "notify_emails": [
      "jsmith@example.com"
    ],
    "auto_pentest": true,
    "next_run_at": "2023-11-07T05:31:56Z",
    "last_fired_at": "2023-11-07T05:31:56Z",
    "last_run_status": "ok",
    "last_run_code": "<string>",
    "last_run_error": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "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.

Scopes

discovery:read

Query Parameters

limit

integer

default:20

Maximum number of runs to return. The default is 20 and the maximum is 100.

Required range: 1 <= x <= 100

Response

Recent runs and the seed domains.

runs

object[]

required

Show child attributes

live_run

object | null

required

The run that is pending or running. Null when no run is in progress.

Show child attributes

seed_domains

string[]

required

The verified domains a new run can start from.

schedule

object

required

The organization's recurring discovery settings and notification settings. Each scheduled run starts from the verified domains in seeds, or from every verified domain when seeds is null. The notification settings also apply to runs started by hand.

Show child attributes

Error

A valid request URL is required to generate request examples

{
  "runs": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "<string>",
      "seeds": [
        "<string>"
      ],
      "org_names": [
        "<string>"
      ],
      "status": "pending",
      "asset_count": 123,
      "new_asset_count": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "instructions": "<string>",
      "summary": "<string>",
      "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "failure_code": "launch_failed",
      "detail": "<string>",
      "created_by": "<string>",
      "queued_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z",
      "auto_pentest_scan_ids": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "auto_pentest_error": "<string>"
    }
  ],
  "live_run": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "seeds": [
      "<string>"
    ],
    "org_names": [
      "<string>"
    ],
    "status": "pending",
    "asset_count": 123,
    "new_asset_count": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "instructions": "<string>",
    "summary": "<string>",
    "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "failure_code": "launch_failed",
    "detail": "<string>",
    "created_by": "<string>",
    "queued_at": "2023-11-07T05:31:56Z",
    "started_at": "2023-11-07T05:31:56Z",
    "finished_at": "2023-11-07T05:31:56Z",
    "auto_pentest_scan_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "auto_pentest_error": "<string>"
  },
  "seed_domains": [
    "<string>"
  ],
  "schedule": {
    "cron": "<string>",
    "timezone": "<string>",
    "seeds": [
      "<string>"
    ],
    "notify_events": [
      "new_assets"
    ],
    "notify_slack": true,
    "slack_channel_id": "<string>",
    "notify_emails": [
      "jsmith@example.com"
    ],
    "auto_pentest": true,
    "next_run_at": "2023-11-07T05:31:56Z",
    "last_fired_at": "2023-11-07T05:31:56Z",
    "last_run_status": "ok",
    "last_run_code": "<string>",
    "last_run_error": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "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>"
}

Domains

Analytics

Asset Discovery

Audit

Billing

Chat

CLI

Connectors

Containers

Assets

Test Users

Integrations

Knowledge

License

LLM

Run Logs

Organization

Invitations

Members

PR Reviews

Vulnerabilities

Repositories

Supply Chain

Scans

Schedules

Search

Tokens

Uploads

Webhooks

Workspaces

List asset discovery runs

Authorizations

Scopes

Query Parameters

Response