# Obtenir les autorisations effectives d'un utilisateur

`GET /v1/users/{user_id}/effective-permissions` · autorisation `users:read`

Renvoie les autorisations dont l'utilisateur dispose effectivement, pour le support et le débogage : les autorisations des rôles d'environnement directs de l'utilisateur et, lorsque `org_id` est fourni, celles des rôles de son adhésion active à cette organisation. Chaque autorisation liste les rôles qui l'accordent. Les autorisations des API supprimées ne sont pas incluses. La liste n'est pas paginée et est ordonnée par API, puis par valeur d'autorisation.

## Demande

| Paramètre | Dans | Requis | Description |
|---|---|---|---|
| `user_id` | path | oui | ID utilisateur (`usr_…`). |
| `org_id` | query | non | ID de l'organisation (`org_…`) ; inclut aussi les rôles de l'adhésion active de l'utilisateur dans cette organisation. |
| `api_id` | query | non | ID de l'API (`api_…`) ; seulement les autorisations de cette API. Une API inconnue donne une liste vide. |

Aucun corps de requête.

## Réponse

`200 OK` avec les autorisations.

```json
{
  "permissions": [
    {
      "permission_id": "perm_01j9xs0a2b4c6d8e0f2g4h6j8k",
      "api_id": "api_01j9xq1b3c5d7e9f1g3h5j7k9m",
      "value": "read:invoices",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ]
    }
  ]
}
```

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 404 | `not_found` | L'utilisateur, ou l'organisation indiquée dans `org_id`, n'existe pas dans cet environnement. |
| 422 | `validation_failed` | `org_id` ou `api_id` est mal formé ou répété. |
| 401 | `unauthenticated` | Le justificatif est absent, invalide ou révoqué. |
| 403 | `insufficient_permissions` | Le justificatif ne possède pas l'autorisation requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la durée indiquée par `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par `Retry-After`. |

## Exemple

```bash
curl -i -X GET "https://api.eu.keenauth.com/v1/users/usr_01j9xh2k6p7q1r3s5t7v9w1x3y/effective-permissions?org_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```