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"?}: devuelveapi_keyuna sola vez (ymcp_url). Solo una clave con acceso completo crea claves (si no,required_scope: "full_access"). AceptaIdempotency-Key(la respuesta repetida traeapi_keyen null).GET https://wyroapi.com/v1/keys: claves activas conkey_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.