Chapitres · Membres de l’organisation
Membres de l’organisation
Parcourir les membres de l’organisation liée à une clé API.
Cette lecture est limitée aux membres de l’organisation rattachée à la clé.
Pagination
Le paramètre limit accepte un entier de 1 à 100 ; sa valeur par défaut est 50. Pour la page suivante, transmettez la valeur nextCursor reçue dans le paramètre cursor. Arrêtez lorsque hasMore vaut false.
Réponse
| Champ | Description |
|---|---|
members | Membres de cette page. |
count | Nombre de membres de cette page. |
nextCursor | Curseur de continuation ou null. |
hasMore | Indique si une autre page est disponible. |
Chaque membre contient id, role, createdAt et user. Le profil user comprend id, name, email et image. Les rôles restent des valeurs API, par exemple owner. createdAt est un horodatage en millisecondes et l’image peut être null.
Pour une seule fiche, consultez la lecture d’un membre.
Authentification
Créez une clé dans les paramètres de connexion de votre organisation, si votre rôle l’autorise. Transmettez-la dans l’en-tête x-api-key. Une clé est rattachée à une seule organisation : aucun identifiant d’organisation n’est à ajouter à la requête. Gardez la clé côté serveur et remplacez le domaine d’exemple par celui de votre instance CoolAI.
Erreurs et reprise
| Statut | Signification |
|---|---|
400 | Paramètres invalides ; corrigez la requête. |
401 | Authentification absente, invalide ou expirée. |
403 | Droits insuffisants pour cette opération. |
404 | Ressource introuvable dans le périmètre autorisé. |
500 | Échec du serveur ; réessayez ultérieurement. |
Le corps d’une erreur contient message et correlation. Conservez la référence correlation ou l’en-tête x-correlation-id pour une demande d’assistance ; ne transmettez jamais votre clé.