> ## Documentation Index
> Fetch the complete documentation index at: https://docs.continuouslabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# apibox create

> Create API Box

Creates an API Box from a ready API Box Snapshot and starts it. It returns at once with status starting and the API Box's token; get the API Box until it is running. Send the token in X-Continuous-Token on each request to the API Box's endpoint. The token lasts as long as the API Box, and its get returns it again. Each API Box has its own state, and runs in real time.

```bash theme={null}
continuous apibox create [flags]
```

## Examples

```bash theme={null}
continuous apibox create --snapshot-id abs_01J8Z5X4K70000000000000002
```

## Flags

**--body** `string`

Request body as JSON (alternative to individual flags). Can also be provided via stdin.

**--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.

**--include-sample-data**

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, -m** `string`

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

**--name, -n** `string`

Name for the API Box. Omission generates a name.

**--snapshot-id, -s** `string` *required*

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

Global flags apply to every command. See [Global flags](https://docs.continuouslabs.ai/cli/global-flags.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.