> ## 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-snapshots create

> Create API Box Snapshot

Starts an asynchronous build and returns the API Box Snapshot with status pending. Get the Snapshot until its status is ready, failed or canceled; API Boxes start from a ready one. The build is a Simulator build in api mode, run in real time: the built service has no simulated clock, and its scheduled work runs at the first request at or after its time. Builds queue with Simulator builds and count toward the same quotas. Send multipart/form-data with a JSON part named request, a file part named spec with the OpenAPI, WSDL or GraphQL document, and optional file parts named document with vendor documentation.

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

## Examples

```bash theme={null}
continuous apibox-snapshots create
```

## Flags

**--document** `string`

Vendor documentation the builder and reviewer read before they start, as repeated file parts: UTF-8 text (.md, .txt, .html, .json, .yaml, .xml, .csv) or PDF (.pdf). The documents share the request body limit with the spec.

**--idempotency-key, -i** `string`

Optional key for retrying this create safely. A retry with the same key and request returns the original result with its status; the same key with a different request returns 409 idempotency\_conflict. Without a key, each request creates a new resource. The key is recorded before the build starts, so a retry never starts a second build.

**--request, -r** `string` *required*

Request as JSON

**--spec, -s** `string`

OpenAPI, WSDL or GraphQL document, UTF-8 encoded, at most 64 MiB.

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.