Obtener los roles directos de un usuario
GET /v1/users/{user_id}/roles · permiso users:read
Devuelve los roles del entorno asignados directamente al usuario. Los roles de las membresías de organización no se incluyen; para verlos, lea la membresía.
Solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
user_id |
path | sí | ID de usuario (usr_…). |
Sin cuerpo de solicitud.
Respuesta
200 OK con los IDs de los roles.
{
"role_ids": [
"rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
]
}
Errores
| HTTP | code | Cuándo |
|---|---|---|
| 404 | not_found |
El usuario no existe en este entorno. |
| 401 | unauthenticated |
La credencial falta, no es válida o fue revocada. |
| 403 | insufficient_permissions |
La credencial no tiene el permiso requerido. |
| 429 | rate_limited |
Se superó el límite de frecuencia; reintente después del período indicado en Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; reintente después del período indicado en Retry-After. |
Ejemplo
curl -i -X GET "https://api.eu.keenauth.com/v1/users/usr_01j9xh2k6p7q1r3s5t7v9w1x3y/roles" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"