Domaines

Un domaine vérifié (par exemple ecole.fr) prouve que l’organisation possède les adresses de ce domaine. Il rend « gérés » les comptes de ces adresses, permet le rattachement automatique, la connexion unique obligatoire et la création de comptes par l’annuaire SCIM. Une organisation a 50 domaines au plus.

Toutes les routes sont sous https://chat.realmoon.ai/api/v1/orgs/{org_id}. Portées : security:read pour lire, security:write pour écrire.

L’objet domaine#Lien vers la section L’objet domaine

{
  "id": "3c1f6a2e-5b8d-4e7a-9f10-2b6c8d4e0a11",
  "domain": "ecole.fr",
  "status": "pending",
  "verified_at": null,
  "last_checked_at": null,
  "last_error": null,
  "auto_join": false,
  "default_role_key": null,
  "default_group_ids": [],
  "created_at": 1762339200,
  "updated_at": 1762339200,
  "txt": { "type": "TXT", "name": "_moonai.ecole.fr", "value": "moonai-verification=4f9c2a7b1e6d3c8a0b5f2e9d7c1a4b6e" }
}

Lister les domaines#Lien vers la section Lister les domaines

GET /domains · security:read

Rend items, total, verified_count et paid_subscription (le workspace est payé par carte : le rattachement automatique n’est alors pas proposé).

Ajouter un domaine#Lien vers la section Ajouter un domaine

POST /domains · security:write

Rend le domaine, en attente de vérification.

Vérifier un domaine#Lien vers la section Vérifier un domaine

1. Publiez dans la zone DNS du domaine l’enregistrement TXT donné par txt : nom _moonai.<domaine>, valeur moonai-verification=<jeton>.
2. Appelez POST /domains/{domain_id}/verify (security:write).

La réponse est le domaine avec check : {"found": true, "error": null}, ou found: false avec error (record_not_found ou dns_unavailable). Elle répond 200 même quand l’enregistrement n’est pas encore visible : relancez quand il est publié.

curl -X POST https://chat.realmoon.ai/api/v1/orgs/$ORG_ID/domains/$DOMAIN_ID/verify \
  -H "Authorization: Bearer $MOONAI_ADMIN_KEY"

import os
import requests

BASE = f"https://chat.realmoon.ai/api/v1/orgs/{os.environ['ORG_ID']}"
HEADERS = {"Authorization": f"Bearer {os.environ['MOONAI_ADMIN_KEY']}"}

r = requests.post(f"{BASE}/domains/{os.environ['DOMAIN_ID']}/verify", headers=HEADERS, timeout=30)
r.raise_for_status()
domain = r.json()
print(domain["status"], domain["check"])

const BASE = `https://chat.realmoon.ai/api/v1/orgs/${process.env.ORG_ID}`;
const r = await fetch(`${BASE}/domains/${process.env.DOMAIN_ID}/verify`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.MOONAI_ADMIN_KEY}` },
});
if (!r.ok) throw new Error(await r.text());
const domain = await r.json();
console.log(domain.status, domain.check);

Un domaine vérifié est revérifié tous les 7 jours. Après trois échecs de suite, il repasse en attente et le rattachement automatique est coupé ; le propriétaire en est prévenu. Un serveur DNS qui ne répond pas ne compte pas comme un échec.

Régler un domaine#Lien vers la section Régler un domaine

PATCH /domains/{domain_id} · security:write

Retirer un domaine#Lien vers la section Retirer un domaine

DELETE /domains/{domain_id} · security:write

Réponse : {"success": true}. Les comptes de ce domaine cessent d’être gérés par l’organisation à ce titre.

Inviter les comptes existants du domaine#Lien vers la section Inviter les comptes existants du domaine

GET /domains/{domain_id}/accounts · security:read

Liste les comptes Moon AI existants dont l’adresse est de ce domaine vérifié, avec status : active ou suspended (déjà membres), invited (invitation en cours) ou none. Paramètres : page, limit.

POST /domains/{domain_id}/claim · security:write

Envoie une invitation de membre à chacun. Réponse :

{
  "invited": ["41ab2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d"],
  "skipped": [{ "user_id": "77cd8e9f-0a1b-4c2d-9e3f-4a5b6c7d8e9f", "reason": "already_member" }],
  "domain": "ecole.fr"
}

Raisons de skipped : not_in_domain, already_member, seats_full, invite_limit (limite d’invitations du jour), error. Les deux routes répondent 409 domain_not_verified sur un domaine non vérifié.

Voir aussi#Lien vers la section Voir aussi

• Connexion unique
• SCIM 2.0
• Comptes des membres