Listar las asignaciones de una aplicación en una organización
GET /v1/organizations/{org_id}/applications/{application_id}/assignments · permiso organizations:write
Lista las membresías y los grupos de directorio a los que la aplicación está asignada en la organización, de la más antigua a la más reciente. Solo se admite paginación hacia adelante: before y un order distinto de asc devuelven 422. El cursor está vinculado a esta organización y a esta aplicación. No hay ningún endpoint para leer una asignación individual; las asignaciones son inmutables y solo pueden eliminarse.
Solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
org_id |
path | sí | ID de la organización (org_…). |
application_id |
path | sí | ID de la aplicación (app_…). |
limit |
query | no | De 1 a 100, por defecto 20. |
after |
query | no | Cursor de list_metadata.after. |
Sin cuerpo de solicitud.
Respuesta
200 OK con una página de asignaciones.
{
"data": [
{
"id": "aas_01j9xq6r0t1v5w7x9y1z3a5b7d",
"organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
"application_id": "app_01j9xm4n8r9s3t5v7w9x1y3z5b",
"target_type": "membership",
"target_id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
"created_at": "2026-10-12T09:31:00.123456Z"
}
],
"list_metadata": {
"before": null,
"after": null
}
}
Errores
| HTTP | code | Cuándo |
|---|---|---|
| 400 | invalid_cursor |
El cursor no es válido o pertenece a otra organización o aplicación. |
| 404 | not_found |
La organización o la aplicación no existe en este entorno. |
| 422 | validation_failed |
limit está fuera de rango, o se envió before o un order distinto de asc. |
| 401 | unauthenticated |
La credencial falta, no es válida o está revocada. |
| 403 | insufficient_permissions |
La credencial no tiene el permiso requerido. |
| 429 | rate_limited |
Se superó el límite de tasa; reintenta después del periodo Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; reintenta después del periodo Retry-After. |
Ejemplo
curl -i "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/applications/app_01j9xm4n8r9s3t5v7w9x1y3z5b/assignments?limit=20" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"