Lister les rôles personnalisés d'une organisation

GET /v1/organizations/{org_id}/roles · autorisation roles:read

Liste les rôles personnalisés de l'organisation, du plus ancien au plus récent. Seule la pagination vers l'avant est prise en charge : before et un order autre que asc renvoient 422. Le curseur est lié à cette liste. Les rôles d'organisation ne sont visibles que dans leur organisation et ne font pas partie de la liste de l'environnement. L'ensemble d'autorisations du rôle n'est pas renvoyé dans cette version.

Requête

Champ Type Obligatoire Description
org_id path oui Identifiant de l'organisation (org_…).
limit query non 1 à 100, par défaut 20.
after query non Curseur issu de list_metadata.after.

Aucun corps de requête.

Réponse

200 OK avec une page de rôles.

{
  "data": [
    {
      "id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "key": "billing-admin",
      "name": "Billing admin",
      "description": "",
      "is_privileged": false,
      "assignable_in_self_service": true,
      "permission_ids": [],
      "created_at": "2026-10-12T09:31:00.123456Z",
      "updated_at": "2026-10-12T09:31:00.123456Z",
      "version": 1
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Erreurs

HTTP code Quand
400 invalid_cursor Le curseur est invalide ou appartient à une autre liste.
404 not_found L'organisation n'existe pas dans cet environnement.
422 validation_failed limit est hors plage, ou before ou un order autre que asc a été fourni.
401 unauthenticated Le justificatif est absent, invalide ou révoqué.
403 insufficient_permissions Le justificatif ne dispose pas de 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

curl -i "https://api.eu.keenauth.com/v1/organizations/org_01j9xk3m7q8r2s4t6v8w0y2z4a/roles?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"