Import a discovered asset as a domain

POST

asset-discovery

assets

{assetId}

import

Error

A valid request URL is required to generate request examples

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "host": "<string>",
    "apex": "<string>",
    "kind": "apex",
    "source": "certificate_transparency",
    "resolved_ips": [
      "<string>"
    ],
    "technologies": [
      "<string>"
    ],
    "confidence": "confirmed",
    "evidence": {},
    "status": "new",
    "first_seen_at": "2023-11-07T05:31:56Z",
    "last_seen_at": "2023-11-07T05:31:56Z",
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "provider": "<string>",
    "http_status": 123,
    "http_title": "<string>",
    "notes": "<string>",
    "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "pentest_ready": true
  },
  "domain": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>",
    "verified": true,
    "asset_type": "<string>"
  },
  "created": true
}

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "host": "<string>",
    "apex": "<string>",
    "kind": "apex",
    "source": "certificate_transparency",
    "resolved_ips": [
      "<string>"
    ],
    "technologies": [
      "<string>"
    ],
    "confidence": "confirmed",
    "evidence": {},
    "status": "new",
    "first_seen_at": "2023-11-07T05:31:56Z",
    "last_seen_at": "2023-11-07T05:31:56Z",
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "provider": "<string>",
    "http_status": 123,
    "http_title": "<string>",
    "notes": "<string>",
    "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "pentest_ready": true
  },
  "domain": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>",
    "verified": true,
    "asset_type": "<string>"
  },
  "created": true
}

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

{
  "detail": "<string>",
  "requiredTier": "<string>",
  "code": "<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>"
}

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

assetId

string<uuid>

required

UUID of the discovered asset. Use the id field of an asset from listDiscoveredAssets.

Body

application/json

asset_type

enum<string>

The asset type of the new domain. The default is web_app.

Available options:

web_app,

api,

attack_surface

Response

The host already existed in the domain inventory.

asset

object

required

Show child attributes

domain

object

required

Show child attributes

created

boolean

required

False when the host already existed in the domain inventory.

Error

A valid request URL is required to generate request examples

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "host": "<string>",
    "apex": "<string>",
    "kind": "apex",
    "source": "certificate_transparency",
    "resolved_ips": [
      "<string>"
    ],
    "technologies": [
      "<string>"
    ],
    "confidence": "confirmed",
    "evidence": {},
    "status": "new",
    "first_seen_at": "2023-11-07T05:31:56Z",
    "last_seen_at": "2023-11-07T05:31:56Z",
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "provider": "<string>",
    "http_status": 123,
    "http_title": "<string>",
    "notes": "<string>",
    "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "pentest_ready": true
  },
  "domain": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>",
    "verified": true,
    "asset_type": "<string>"
  },
  "created": true
}

{
  "asset": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "<string>",
    "host": "<string>",
    "apex": "<string>",
    "kind": "apex",
    "source": "certificate_transparency",
    "resolved_ips": [
      "<string>"
    ],
    "technologies": [
      "<string>"
    ],
    "confidence": "confirmed",
    "evidence": {},
    "status": "new",
    "first_seen_at": "2023-11-07T05:31:56Z",
    "last_seen_at": "2023-11-07T05:31:56Z",
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "provider": "<string>",
    "http_status": 123,
    "http_title": "<string>",
    "notes": "<string>",
    "domain_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "pentest_ready": true
  },
  "domain": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "domain": "<string>",
    "verified": true,
    "asset_type": "<string>"
  },
  "created": true
}

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

{
  "detail": "<string>",
  "requiredTier": "<string>",
  "code": "<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>"
}

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

Scans

Audit

Vulnerabilities

Assets

Schedules

Tokens

Webhooks

Organization

Members

Invitations

Analytics

LLM

Connectors

Chat

PR Reviews

Knowledge

Integrations

Uploads

Test Users

License

Supply Chain

CLI

Billing

Workspaces

Asset Discovery

Run Logs

Import a discovered asset as a domain

Authorizations

Path Parameters

Body

Response