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

# nsc buildkite queue describe

Describe a Namespace-managed Buildkite queue.

Use `nsc buildkite queue describe` to inspect a queue by its queue ID.
The command prints the queue name and ID, Buildkite cluster and organization
identifiers, and its configured workload permissions and egress policy.

## Usage

```bash theme={null}
nsc buildkite queue describe <queue-id> [flags]
```

### Export the queue settings as a spec file

Use `--output spec` to print only the queue settings, in the format accepted by
[`nsc buildkite queue update --spec_file`](/docs/reference/cli/buildkite-queue-update#use-a-json-spec-file).
This lets you save the current settings, edit them, and apply them again:

```bash theme={null}
nsc buildkite queue describe <queue-id> -o spec > spec.json
nsc buildkite queue update <queue-id> --spec_file spec.json
```

## Options

<h3 id="--output--o-plainjsonspec">
  \--output, -o \<plain|json|spec>
</h3>

Output format. Supported values are:

* `plain`: human-readable queue details.
* `json`: the full queue as JSON.
* `spec`: only the queue settings, as JSON in the format accepted by
  `nsc buildkite queue update --spec_file`.

Defaults to `plain`.

## Related Topics

* [nsc buildkite queue list](/docs/reference/cli/buildkite-queue-list) - List registered queues
* [nsc buildkite queue update](/docs/reference/cli/buildkite-queue-update) - Update queue settings
* [Managing Buildkite Queues](/docs/solutions/buildkite-agents/managing-queues) - Register queues and route Buildkite jobs to Namespace