Skip to main content
POST
Create API Box

Authorizations

Authorization
string
header
required

Use a Continuous API key. Send it in the Authorization header as a Bearer token.

Headers

Idempotency-Key
string

Optional key for retrying this create safely. A retry with the same key and request returns the same API Box and token. The same key with a different request returns 409 idempotency_conflict.

Maximum string length: 256

Body

application/json
snapshot_id
string
required

A ready API Box Snapshot of the workspace or the catalog.

Pattern: ^abs_[0-9A-HJKMNP-TV-Z]{26}$
include_sample_data
boolean

Start with the Snapshot's sample data: a realistic account loaded on top of its seed before the first request. Defaults to false, a brand-new workspace. Requires a Snapshot that carries sample data; see its composition.

metadata
any

Customer JSON metadata, up to 16 KiB and 64 nesting levels.

name
string

Name for the API Box. Omission generates a name.

Maximum string length: 128

Response

Accepted

apibox
object
required

The API Box.

token
string | null
required

The API Box's token, which lasts until the API Box is deleted. It is null only on a retried create whose first attempt stored no token; a start then issues one.