Skip to main content
POST
Bulk import agents

Authorizations

Authorization
string
header
required

An API key minted in Command Center (Settings -> API Keys), sent as Authorization: Bearer 2501_ak_.... A Command Center session cookie is also accepted.

Query Parameters

org_id
string

Required with a CSV body. A JSON body carries it in the envelope instead.

on_error
enum<string>
default:continue

For a CSV body. A JSON body carries it in the envelope instead.

Available options:
stop,
continue
dry_run
default:false

For a CSV body. A JSON body carries it in the envelope instead.

Available options:
true

Body

A CSV file, with org_id, on_error and dry_run in the query string, or a JSON envelope { org_id, rows, on_error?, dry_run? }, which ignores the query string

The body is of type string.

Response

Per-row import result

object
enum<string>
required
Available options:
import_result
dry_run
boolean
required
stopped
boolean
required
counts
object
required
results
object[]
required
new_entries
object

Host previews (dry_run) only: the technologies, applications and tags the import would create