Listar autorizaciones de acceso del soporte

GET /v1/support-access-grants · permiso support-access-grants:read

Lista los accesos con límite de tiempo que este entorno ha concedido al personal de soporte de KeenAuth, del más reciente al más antiguo. Solo se admite la paginación hacia delante (after); before y cualquier order distinto de desc devuelven 422. status devuelve solo las autorizaciones en ese estado; expired significa no revocada y con expires_at vencido.

Solicitud

Campo Tipo Requerido Descripción
limit integer no Tamaño de página, 1-100 (20 por defecto).
after string no Cursor list_metadata.after de la página anterior.
status string no Solo las autorizaciones en este estado: active, revoked o expired.

Sin cuerpo de solicitud.

Respuesta

200 OK con una página de autorizaciones.

{
  "data": [
    {
      "id": "sag_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "scope": "read",
      "status": "active",
      "ticket_ref": "SUP-48213",
      "allowed_regions_of_staff": ["eu"],
      "granted_by": "du_01j9xk2p5n7q9s1t3v5w7y9z1b",
      "created_at": "2026-10-12T09:30:00.123456Z",
      "expires_at": "2026-10-13T09:30:00.123456Z",
      "revoked_at": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errores

HTTP código Cuándo
400 invalid_cursor El cursor no es válido o pertenece a otro filtro.
422 validation_failed Un parámetro de consulta no es válido (before, order=asc, status desconocido).
403 insufficient_permissions La credencial no tiene el permiso requerido.
401 unauthenticated La credencial falta, no es válida o fue revocada.
429 rate_limited Se superó el límite de frecuencia; reintente después del periodo Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente después del periodo Retry-After.

Ejemplo

curl "https://api.eu.keenauth.com/v1/support-access-grants?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"