# `bird realtime apps keys list`

## Usage

```bash
bird realtime apps keys list <realtime-app-id> [flags]
```

## Description

List an app's keys, oldest first, without their secrets: a secret is readable only in the response that created it. Revoked keys are excluded unless `include_revoked` is true. An app can hold several live keys at once, which is what makes rotation zero-downtime.

## Examples

```bash
bird realtime apps keys list <realtime-app-id>
```

## Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--include-revoked` | When true, include revoked keys in the response. |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                                              | Description               |
| --------------------------------------------------------------------------------- | ------------------------- |
| [`bird realtime apps keys create`](/docs/cli/reference/realtime-apps-keys-create) | Create a Realtime app key |
| [`bird realtime apps keys revoke`](/docs/cli/reference/realtime-apps-keys-revoke) | Revoke a Realtime app key |