Lister les invitations

GET /v1/invitations · autorisation invitations:read

Liste les invitations de l'environnement, de la plus ancienne à la plus récente. Seule la pagination avant est prise en charge. Filtres : organization_id, email (correspondance exacte) et status. Le curseur est lié aux filtres ; l'e-mail n'entre dans le curseur que sous forme de hachage à clé. Les liens d'acceptation ne sont jamais listés.

Requête

Champ Type Obligatoire Description
limit query non 1 à 100, 20 par défaut.
after query non Curseur issu de list_metadata.after.
organization_id query non Identifiant de l'organisation (org_…).
email query non Adresse e-mail (correspondance exacte).
status query non pending, accepted, revoked ou expired.

Aucun corps de requête.

Réponse

200 OK avec une page d'invitations.

{
  "data": [
    {
      "id": "inv_01j9xt9v3w4y8z0a2b4c6d8e0g",
      "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "email": "ada@example.com",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ],
      "application_id": null,
      "delivery": "link_only",
      "delivery_status": "not_sent",
      "status": "pending",
      "send_count": 1,
      "last_sent_at": "2026-10-12T09:31:00.123456Z",
      "expires_at": "2026-10-19T09:31:00.123456Z",
      "accepted_user_id": null,
      "accepted_at": null,
      "revoked_at": null,
      "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 à d'autres filtres.
422 validation_failed Un filtre ou limit est invalide, ou before ou un order autre que asc a été fourni.
401 unauthenticated L'identifiant d'authentification est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant d'authentification 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/invitations?organization_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a&status=pending" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

Données personnelles

Ce point de terminaison traite des données personnelles : adhésions aux organisations et invitations. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez pas de catégories particulières de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.