# \&roomkey

General Option! ([`&director`](/advanced-settings/director-parameters/director.md), [`&room`](/advanced-settings/setup-parameters/room.md))

## Aliases

* `&rk`

## Options

Example: `&roomkey=TRUSTED_BYPASS_KEY`

| Value  | Description                                                             |
| ------ | ----------------------------------------------------------------------- |
| String | Trusted bypass key shared between the director and selected guest links |

## Details

`&roomkey` is a trusted bypass key for the room admission controls on a claimed room.

Add it to the director link:

```
https://vdo.ninja/?director=MyRoom&requireapproval&roomcap=10&roomkey=TRUSTEDKEY
```

Add the same key only to trusted guest links:

```
https://vdo.ninja/?room=MyRoom&roomkey=TRUSTEDKEY
```

Guests with a matching key can bypass:

* manual approval from [`&requireapproval`](/advanced-settings/director-parameters/and-requireapproval.md)
* a lower custom cap from [`&roomcap`](/advanced-settings/director-parameters/and-roomcap.md)

`&roomkey` cannot bypass the server hard cap. On the official `vdo.ninja` service, the hard cap is `80`.

## Live director behavior

The bypass key is attached to the live director claim. If the director leaves and a new director claims the room with a different key, the trusted bypass changes with that director's settings.

## Security notes

Treat a room key like a password.

* Share it only with guests who should bypass approval or a custom cap.
* Rotate it if it is exposed.
* Do not use a predictable key for public events.

## Related

{% content-ref url="/pages/CdV7XfS7kF1iejAVFibl" %}
[\&requireapproval](/advanced-settings/director-parameters/and-requireapproval.md)
{% endcontent-ref %}

{% content-ref url="/pages/FcWXWvhwDS2DwO5K6O3q" %}
[\&roomcap](/advanced-settings/director-parameters/and-roomcap.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vdo.ninja/advanced-settings/director-parameters/and-roomkey.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.