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

# momentic queue

> Queue dashboard-hosted tests and suites on Momentic infrastructure (deprecated).

<Warning>
  **Deprecated.** Cloud-hosted tests are being phased out as part of the broader
  [cloud deprecation](/get-started/cloud-deprecation). Both `queue tests` and
  `queue suites` remain for backwards compatibility and will be removed in a
  future release. Run tests locally or in CI with [`momentic
      run`](/cli-reference/momentic/commands/run) instead.
</Warning>

Queues dashboard-hosted tests or suites for cloud execution. Requires the tests
to exist on Momentic dashboard.

```bash theme={null}
npx momentic queue tests <tests...>
```

## `tests`

Queue one or more individual tests.

```bash theme={null}
npx momentic queue tests <tests...>
```

### Arguments

<ParamField path="<tests...>" type="array" required>
  Names of the dashboard tests to queue. Pass multiple values separated by
  spaces.
</ParamField>

### Common flags

<ParamField path="--all" type="boolean">
  Queue every test in the project instead of the paths passed as arguments.
  Mutually exclusive with the `<tests...>` argument.
</ParamField>

<ParamField path="--env <env>" type="string">
  Environment to run the tests in. Overrides any environment configured on the
  test itself. The base URL set on the test still takes precedence, use
  `--url-override` to override it.
</ParamField>

<ParamField path="--url-override <urlOverride>" type="string">
  Override the base URL of the test or environment. Useful for running against a
  preview deployment.
</ParamField>

### Inputs

<ParamField path="--custom-headers <customHeaders...>" type="array">
  Custom headers to include in the test run. Specify multiple headers separated
  by spaces.
</ParamField>

<ParamField path="--input-csv <inputCsv>" type="string">
  CSV file containing input data for the tests. Each row is used as input for a
  separate test run.
</ParamField>

### Waiting

<ParamField path="-w, --wait" type="boolean">
  Wait for the run to complete before exiting.
</ParamField>

<ParamField path="--wait-timeout <waitTimeout>" type="number">
  Maximum time to wait for the run to complete, in seconds. Defaults to `1800`.
  Requires `--wait`.
</ParamField>

## `suites`

Queue one or more dashboard suites.

```bash theme={null}
npx momentic queue suites <suites...>
```

### Arguments

<ParamField path="<suites...>" type="array" required>
  Names of the suites to queue. Pass multiple values separated by spaces.
</ParamField>

### Options

<ParamField path="--custom-headers <customHeaders...>" type="array">
  Custom headers to include in the run.
</ParamField>

<ParamField path="--env <env>" type="string">
  Environment to run the suite in. The base URL on the suite still takes
  precedence, use `--url-override` to override.
</ParamField>

<ParamField path="--url-override <urlOverride>" type="string">
  Override the base URL of the suite or environment.
</ParamField>

<ParamField path="-w, --wait" type="boolean">
  Wait for the run to complete before exiting.
</ParamField>

<ParamField path="--wait-timeout <waitTimeout>" type="number">
  Maximum time to wait for the run to complete, in seconds. Defaults to `1800`.
  Requires `--wait`.
</ParamField>

## Examples

Queue a single dashboard test and wait for completion:

```bash theme={null}
npx momentic queue tests checkout-happy-path --wait
```

Queue a suite against a preview deployment:

```bash theme={null}
npx momentic queue suites smoke --url-override https://preview-123.example.com
```