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

# simulators build

> Build Simulator

Starts an asynchronous Simulator build and returns the Simulator with status pending. Builds start in queue order when workspace capacity is available. Send multipart/form-data with a JSON part named request. To build from a document, add a file part named spec with the OpenAPI or WSDL document. For an incremental build, omit spec and set parent\_id and instructions.

```bash theme={null}
continuous simulators build [flags]
```

## Examples

See [Send a request body](/cli/scripting#send-a-request-body) for a working example.

## Flags

<ParamField path="--request, -r" type="string" required>
  Request as JSON
</ParamField>

<ParamField path="--spec, -s" type="string">
  OpenAPI or WSDL document, UTF-8 encoded, at most 64 MiB. Required unless the request is an incremental build (parent\_id and instructions, no spec).
</ParamField>

Global flags apply to every command. See [Global flags](/cli/global-flags).