Claves de API

Las claves de API de la organización. revoke revoca una clave para siempre (solo una clave revocada puede eliminarse con delete), y rotate emite una sucesora y mantiene la anterior funcionando por algunos días — el secreto nuevo aparece una sola vez, en la respuesta.

Comando	HTTP	Descripción
api-keys list	GET /v1/api_keys	Listar claves de API
api-keys create	POST /v1/api_keys	Crear clave de API
api-keys get	GET /v1/api_keys/{id}	Consultar clave de API
api-keys update	PATCH /v1/api_keys/{id}	Actualizar clave de API
api-keys delete	DELETE /v1/api_keys/{id}	Eliminar clave revocada
api-keys revoke	POST /v1/api_keys/{id}/revoke	Revocar clave de API
api-keys rotate	POST /v1/api_keys/{id}/rotate	Rotar clave de API

Ejemplos

--params lleva parámetros de query, de ruta y de encabezado (id, página, filtros, X-Workspace-Id); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar claves de API
kobana dashboards api-keys list \
  --params '{"status": "active"}' \
  --fields "id,name,prefix,status,expires_at"

# Crear clave de API
kobana dashboards api-keys create \
  --json '{"name": "Integração ERP", "expires_at": "2027-10-01T00:00:00Z"}'

# Rotar clave de API
kobana dashboards api-keys rotate \
  --params '{"id": "API_KEY_ID"}' \
  --json '{"grace_days": 7}'

# Revocar clave de API
kobana dashboards api-keys revoke --params '{"id": "API_KEY_ID"}' --dry-run

Próximos pasos

• Identidad del token
• Introspección de schema — todos los parámetros que acepta este recurso.