# Claves limitadas

Cada espacio tiene una **clave principal** con acceso completo (la de `POST /v1/sandbox` o del panel). Puedes sumar **claves limitadas** que solo pueden lo que dicen sus scopes, por ejemplo una clave de solo lectura para un tablero. Las claves que ya existen siguen con acceso completo.

## Scopes

| Scope | Permite |
| --- | --- |
| `posts:read` | `GET /v1/posts`, `GET /v1/posts/{id}`, `GET /v1/analytics/overview`, leer la cola. |
| `posts:write` | `POST /v1/posts`, `POST /v1/posts/bulk`, `PATCH` y `DELETE /v1/posts/{id}`. |
| `accounts:read` | `GET /v1/accounts`. |
| `accounts:write` | `POST /v1/connect`, `DELETE /v1/accounts/{id}`. |
| `media:write` | `POST /v1/media`, `POST /v1/media/upload`. |
| `webhooks:write` | `GET`, `PUT` y `DELETE /v1/webhooks`. |
| `queue:write` | `PUT /v1/queue` (y leerla). |

`GET /v1/me` funciona con cualquier clave. Una llamada sin el scope que necesita responde `403 insufficient_scope` con `details.required_scope`.

## Crear, listar, revocar

```
curl -X POST https://wyroapi.com/v1/keys -H "Authorization: Bearer $WYRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "metrics dashboard", "scopes": ["posts:read", "accounts:read"]}'
```

- `POST https://wyroapi.com/v1/keys {"scopes": [...], "name"?}`: devuelve `api_key` **una sola vez** (y `mcp_url`). Solo una clave con acceso completo crea claves (si no, `required_scope: "full_access"`). Acepta `Idempotency-Key` (la respuesta repetida trae `api_key` en null).
- `GET https://wyroapi.com/v1/keys`: claves activas con `key_hint`, `scopes` (`null` = acceso completo), `primary`, `created_at`, `last_used_at`.
- `DELETE https://wyroapi.com/v1/keys/{id}`: revoca una clave limitada al instante. No se puede revocar acá la clave que hace la llamada ni la principal (`key_not_revocable`); la principal se rota desde el panel.

Hasta 25 claves limitadas activas por espacio. Una clave limitada sigue a la principal: mismo modo (prueba, período de prueba, plan) y misma fecha de fin. Crear una nunca cambia la principal, así que el panel, el conector OAuth y los partners siguen igual.

## Partners

```
curl -X POST https://wyroapi.com/v1/partner/workspaces/ws_abc123/keys \
  -H "Authorization: Bearer $WYRO_PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"scopes": ["posts:read"]}'
```

`POST /v1/partner/workspaces/{id}/keys` le da a uno de tus clientes una clave limitada (por ejemplo de solo lectura para su propio tablero); `GET` en la misma ruta lista las claves de ese cliente. Actuar por el cliente con el token de partner y `X-Wyro-External-Id` sigue con acceso completo.

## En el panel

Clave y API → **Claves de esta cuenta**: la principal y las limitadas con sus permisos, **Crear clave limitada** y **Revocar**.
