Lister les adhésions d'une organisation

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

Liste les adhésions de l'organisation par date de dernière mise à jour, les plus anciennes en premier (à égalité, par identifiant). Seule la pagination vers l'avant est prise en charge. Filtres : status, role_id, updated_after. Le curseur est lié à l'organisation et aux filtres.

Requête

Champ Type Obligatoire Description
org_id path oui Identifiant de l'organisation (org_…).
limit query non 1 à 100, 20 par défaut.
after query non Curseur issu de list_metadata.after.
status query non invited, active, suspended ou removed.
role_id query non Uniquement les adhésions détenant ce rôle (rol_…).
updated_after query non Heure RFC 3339 ; uniquement les adhésions mises à jour après cette heure.

Aucun corps de requête.

Réponse

200 OK avec une page d'adhésions.

{
  "data": [
    {
      "id": "mem_01j9xn5p9s0t4v6w8x0y2z4a6c",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "user_id": "usr_01j9xh2k6p7q1r3s5t7v9w1x3y",
      "status": "active",
      "source": "admin_api",
      "reason": null,
      "roles": [
        {
          "role_id": "rol_01j9xr7s1t2w6x8y0z2a4b6c8e",
          "source": "admin_api",
          "assigned_at": "2026-10-12T09:31:00.123456Z"
        }
      ],
      "expires_at": null,
      "created_at": "2026-10-12T09:31:00.123456Z",
      "activated_at": "2026-10-12T09:31:00.123456Z",
      "suspended_at": null,
      "removed_at": null,
      "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 organisation ou à d'autres filtres.
404 not_found L'organisation n'existe pas dans cet environnement.
422 validation_failed Un filtre ou limit est invalide, 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 période indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la période indiquée par Retry-After.

Exemple

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

Données personnelles

Cet endpoint traite des données personnelles : adhésions aux organisations et invitations. Données personnelles dans les API KeenAuth décrit les données conservées, leur durée de conservation et leur suppression. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.