> ## 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 queues update

Update settings for a Namespace-managed Buildkite queue.

Use `nsc buildkite queues update` to configure an egress policy or custom
workload permissions for a queue. You can set individual options or provide all
queue settings in a JSON file.

## Usage

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

## Options

<h3 id="--egress_policy-string">
  \--egress\_policy \<string>
</h3>

Apply the workspace egress policy with this tag to jobs running for the queue.

<h3 id="--remove_egress_policy">
  \--remove\_egress\_policy
</h3>

Remove the workspace egress policy tag from the queue.

<h3 id="--reset">
  \--reset
</h3>

Reset all queue settings.

<h3 id="--reset_permissions">
  \--reset\_permissions
</h3>

Remove custom workload permissions from the queue.

<h3 id="--spec_file-string">
  \--spec\_file \<string>
</h3>

Read the queue settings from the specified JSON file. When provided, the CLI
ignores individual settings flags.

For example, this spec applies an egress policy and grants a custom workload
permission:

```json theme={null}
{
  "permissions": {
    "permissions_type": "CUSTOM",
    "workload_permissions": [
      {
        "resource_type": "instance",
        "resource_id": "",
        "actions": ["*"]
      }
    ]
  },
  "egress_policy_tag": "my-egress-policy"
}
```

<h3 id="--workload_permissions-stringarray-can-be-repeated">
  \--workload\_permissions \<stringArray> (can be repeated)
</h3>

Set a custom workload permission as JSON. Repeat this option to set multiple
permissions.

```json theme={null}
{"resource_type":"...","resource_id":"...","actions":["..."]}
```

See [Permissions](/docs/security/permissions) for available resource types and
actions.

## Related Topics

* [nsc buildkite queues get](/docs/reference/cli/buildkite-queues-get) - Inspect a queue
* [nsc buildkite queues list](/docs/reference/cli/buildkite-queues-list) - List registered queues
* [Egress Policies](/docs/security/egress-policy) - Control network access from jobs
* [Managing Buildkite Queues](/docs/solutions/buildkite-agents/managing-queues) - Register queues and route Buildkite jobs to Namespace