wyro

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.