# API des organisations > Relier un annuaire, un logiciel RH ou un script à une organisation Moon AI : API d’administration, webhooks, SCIM 2.0, connexion unique et clés de workspace. Une organisation se pilote aussi par programme. Cinq outils existent, chacun avec sa clé et son adresse. Tous concernent un workspace d’équipe ; un workspace personnel n’en a aucun. ## Quel outil pour quel besoin | Besoin | Outil | Authentification | | --- | --- | --- | | Gérer les membres, invitations, groupes, rôles, étiquettes, règles, modèles, licences et ressources ; lire l’utilisation et le journal | [API d’administration](https://realmoon.ai/documentation/api-organisations/administration/) | Clé d’administration `moai_adm_…` | | Être prévenu quand un membre arrive ou part, qu’un lot de licences est plein, que les règles changent ou que le contrat approche de sa fin | [Webhooks](https://realmoon.ai/documentation/api-organisations/webhooks/) | Signature HMAC avec un secret `whsec_…` | | Créer, suspendre et retirer les comptes depuis votre annuaire, et y tenir les groupes | [SCIM 2.0](https://realmoon.ai/documentation/api-organisations/scim/) | Jeton `moai_scim_…` | | Connecter les membres avec l’identifiant de votre organisation | [Connexion unique](https://realmoon.ai/documentation/api-organisations/sso/) | Application OpenID Connect de votre fournisseur d’identité | | Utiliser le chat de Moon AI au nom d’un workspace | [Clés de workspace](https://realmoon.ai/documentation/api-organisations/cles-workspace/) | Clé `moai_org_…` | L’annuaire SCIM n’ajoute que des adresses d’un [domaine vérifié](https://realmoon.ai/documentation/api-organisations/domaines/), et la connexion unique ne devient obligatoire qu’avec au moins un domaine vérifié. Pour appeler les modèles depuis vos propres programmes, avec un porte-monnaie et une facturation à l’usage, utilisez plutôt l’[API développeur](https://realmoon.ai/documentation/api/). ## Adresses | Service | Adresse | | --- | --- | | API d’administration et webhooks | `https://chat.realmoon.ai/api/v1/orgs/{org_id}/` | | Description OpenAPI de l’API d’administration | `https://chat.realmoon.ai/api/v1/orgs/openapi.json` | | SCIM 2.0 | `https://chat.realmoon.ai/api/v1/orgs/scim/v2` | | Adresse de redirection de la connexion unique | `https://chat.realmoon.ai/api/v1/orgs/sso/callback` | | Chat avec une clé de workspace | `https://chat.realmoon.ai/api/chat/completions` | L’identifiant de l’organisation (`org_id`) figure dans l’administration › « API et clés », carte « Démarrage », dans l’exemple « Premier appel ». ## Démarrer avec l’API d’administration 1. [Créez une clé d’administration](https://realmoon.ai/documentation/api-organisations/administration/#creer-une-cle) avec seulement les droits dont votre programme a besoin. 2. Vérifiez-la avec [`GET /me`](https://realmoon.ai/documentation/api-organisations/administration/#me). 3. Appelez les routes du domaine voulu, par exemple [lister les membres](https://realmoon.ai/documentation/api-organisations/membres/#lister) ou [inviter des personnes](https://realmoon.ai/documentation/api-organisations/invitations/#inviter). 4. Abonnez votre serveur aux [webhooks](https://realmoon.ai/documentation/api-organisations/webhooks/) pour ne pas interroger l’API en boucle. ## Sécurité commune - Chaque clé et chaque jeton n’agit que sur son organisation. Une requête vers une autre organisation reçoit la même réponse qu’une ressource inexistante. - Une clé d’administration n’a jamais plus de droits que la personne qui l’a créée, et cesse de fonctionner quand cette personne quitte l’organisation. - Les clés, jetons et secrets ne sont affichés qu’une fois, à leur création. Gardez-les comme des mots de passe, côté serveur seulement. - Chaque action faite par une clé ou par l’annuaire est inscrite au journal d’audit de l’organisation, au nom de la clé ou de l’annuaire. ## Dans cette section ### API d’administration - [API d’administration](https://realmoon.ai/documentation/api-organisations/administration/) : Créer une clé d’administration moai_adm_, l’envoyer, choisir ses portées, et les règles communes de l’API : pagination, erreurs, débit et idempotence. - [Organisation et réglages](https://realmoon.ai/documentation/api-organisations/organisation/) : Lire la vue d’ensemble et la liste « À faire », modifier l’identité et les réglages de l’organisation, la durée de conservation et l’annuaire des membres. - [Membres](https://realmoon.ai/documentation/api-organisations/membres/) : Lister et filtrer les membres, lire une fiche, suspendre, réactiver ou retirer, agir en masse, exporter et importer un fichier CSV avec l’API d’administration. - [Invitations et codes d’accès](https://realmoon.ai/documentation/api-organisations/invitations/) : Inviter des personnes avec leurs groupes, rôles, étiquettes et licence, lire les limites d’invitation, renvoyer ou révoquer, et gérer les codes d’accès. - [Comptes des membres par l’API](https://realmoon.ai/documentation/api-organisations/comptes/) : Lire le compte d’un membre, le déconnecter, réinitialiser sa double authentification, le désactiver, gérer son départ et les exigences des comptes par l’API. - [Groupes](https://realmoon.ai/documentation/api-organisations/groupes/) : Créer des groupes statiques ou dynamiques, écrire une règle d’étiquettes, ajouter des membres et nommer des gestionnaires avec l’API d’administration. - [Rôles](https://realmoon.ai/documentation/api-organisations/roles/) : Créer des rôles avec leurs permissions et les attribuer à des membres, des groupes ou des étiquettes par l’API d’administration, avec le catalogue des droits. - [Étiquettes](https://realmoon.ai/documentation/api-organisations/etiquettes/) : Créer des étiquettes clé et valeur, les poser sur des membres, des groupes ou des ressources, et marquer une ressource sensible par l’API d’administration. - [Règles](https://realmoon.ai/documentation/api-organisations/regles/) : Le format des règles de l’organisation, des rôles, des groupes et des exceptions, la façon dont elles se combinent, et les routes qui les lisent et écrivent. - [Modèles de l’organisation](https://realmoon.ai/documentation/api-organisations/modeles/) : Lister les modèles que les règles autorisent, créer des modèles de l’organisation avec prompt et bases de connaissances, et poser des consignes par modèle. - [Licences et contrat](https://realmoon.ai/documentation/api-organisations/licences/) : Lire les lots de licences, régler les règles d’attribution et le lot de repli, attribuer des licences à la main, et lire le contrat et les factures par l’API. - [Ressources](https://realmoon.ai/documentation/api-organisations/ressources/) : Ajouter, tester et partager les serveurs MCP de l’organisation, configurer son stockage de fichiers et partager bases de connaissances et agents par l’API. - [Domaines](https://realmoon.ai/documentation/api-organisations/domaines/) : Ajouter et vérifier les domaines de l’organisation par un enregistrement DNS TXT, régler le rattachement automatique et inviter les comptes existants par l’API. - [Utilisation et journal d’audit par l’API](https://realmoon.ai/documentation/api-organisations/utilisation-et-journal/) : Lire l’utilisation par membre, par groupe et par modèle, l’exporter en CSV, puis lire, filtrer et exporter le journal d’audit de l’organisation par l’API. - [Webhooks de l’organisation](https://realmoon.ai/documentation/api-organisations/webhooks/) : Recevoir les événements de l’organisation dans une requête signée, vérifier la signature, gérer les nouveaux essais et piloter les webhooks par l’API. ### Annuaire et connexion - [SCIM 2.0](https://realmoon.ai/documentation/api-organisations/scim/) : Le service SCIM 2.0 d’une organisation gérée : jeton de l’annuaire, ressources Users et Groups, filtres, opérations PATCH, limites et erreurs au format SCIM. - [Connexion unique (OpenID Connect)](https://realmoon.ai/documentation/api-organisations/sso/) : Ce que Moon AI attend de votre fournisseur OpenID Connect, le déroulé d’une connexion, les champs lus et les routes qui lisent ou enregistrent la configuration. ### Clés de workspace - [Clés de workspace](https://realmoon.ai/documentation/api-organisations/cles-workspace/) : Les clés moai_org_ appellent le chat de Moon AI au nom d’un workspace d’équipe : points d’accès ouverts, données exclues, gestion des clés et erreurs. --- Documentation Moon AI › API des organisations. Page : https://realmoon.ai/documentation/api-organisations/. Modifiée le 5 novembre 2026. © 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.