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

> ## Agent Instructions
> To set up offstage cloud from a coding agent, read https://api.offstage.cloud/SKILL.md and follow it. The whole API guide is one file at https://api.offstage.cloud/llms.txt.

# API keys

> Make, list and revoke team API keys from the console.

These calls are console-session only. With a key they answer 403 `console-only`.

| Call | Answer |
| - | - |
| `GET /v1/keys` | `{"keys": [{"id", "name", "mask", "createdAt", "lastUsedAt", "createdBy", "kind"}]}`. `mask` looks like `sk_offstage_AbCd…WxYz`, `createdBy` is `{"email"}` or null, and `kind` is `personal` or `service` |
| `POST /v1/keys` with `{"name", "kind"?}` (`name` 1 to 64 characters; `kind` is `personal`, the default, or `service`) | `201 {"key", "id", "name", "mask", "createdAt", "kind", …}`. `key` is the only time the secret is ever shown. A `service` key from someone who is not an owner is 403 `forbidden`; any other `kind` is 400 `bad-kind` |
| `DELETE /v1/keys/:id` | `204`. The key stops working at once |

Keys are stored only as hashes, so a lost key cannot be recovered. Make a new one and delete the old one. See [Authentication](https://offstage.cloud/docs/api/authentication.md) for when a personal key stops working.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.