Règles

Les règles d’une organisation gérée décident des modèles, des fonctions, des connecteurs, des fichiers et des limites d’utilisation de ses membres. Elles s’écrivent à quatre niveaux : l’organisation, les rôles, les groupes et l’exception d’un membre. Les règles enregistrées ne s’appliquent qu’une fois l’organisation gérée (managed, voir Organisation et réglages).

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

Règles de l’organisation#Lien vers la section Règles de l’organisation

Une clé absente prend la valeur de la plateforme : tout est permis, 100 % des limites, pas de taille de fichier imposée.

{
  "models": { "mode": "allow", "ids": ["anthropic/claude-haiku-4.5", "mistralai/mistral-large-2512"], "eu_only": false },
  "modes": { "agent": false },
  "features": { "web_search": true, "image_generation": false, "public_share": false },
  "connectors": { "mode": "allow", "ids": ["gmail", "notion"], "personal_mcp": false },
  "files": { "max_mb": 50, "types": ["pdf", "docx", "xlsx"] },
  "usage": { "session_pct": 50, "week_pct": 80 },
  "learn_mode_default": false,
  "outside_access": true,
  "retention_days": 365
}

Fonctions de features : web_search, url_fetch, deep_research, image_generation, video_generation, music_generation, voice, sandbox, code_interpreter, memory, projects, routines, agents, skills, artifacts, import, public_share, temporary_chats, file_upload, personal_instructions, cli, api_keys, economy_fallback, messaging.

Quand music_generation n’est réglée nulle part, la musique suit video_generation si celle-ci est coupée.

Règles d’un rôle, d’un groupe ou d’un membre#Lien vers la section Règles d’un rôle, d’un groupe ou d’un membre

À ces niveaux, une clé absente est héritée. outside_access et retention_days n’existent qu’au niveau de l’organisation.

{
  "features": { "web_search": "deny", "image_generation": "allow" },
  "modes": { "agent": "deny" },
  "models": { "mode": "only", "ids": ["mistralai/mistral-large-2512"], "eu_only": "deny" },
  "connectors": { "remove": ["slack"], "personal_mcp": "allow" },
  "files": { "max_mb": 20, "types": { "mode": "only", "ids": ["pdf"] } },
  "usage": { "month_pct": 40 },
  "learn_mode_default": "on"
}

Consignes#Lien vers la section Consignes

Chaque niveau peut porter des consignes : un texte de 4 000 caractères au plus, ajouté aux conversations des membres concernés. Une chaîne vide ou null les efface. Elles s’ajoutent dans cet ordre : organisation, rôles, groupes, exception du membre.

Comment les règles se combinent#Lien vers la section Comment les règles se combinent

Pour chaque membre comptent : son rôle de base, ses autres rôles (donnés à lui, à un de ses groupes ou à une de ses étiquettes), les groupes dont il est membre (pas ceux qu’il gère seulement) et son exception.

• Fonctions et modes : l’exception décide si elle est posée ; sinon un deny d’un rôle ou d’un groupe l’emporte, puis un allow, puis la règle de l’organisation.
• Nombres (files.max_mb, usage.*) : l’exception décide ; sinon la plus petite des restrictions, sinon le plus grand des assouplissements, sinon la valeur de l’organisation.
• Listes (models, connectors, files.types) : la liste de l’organisation, à laquelle les niveaux ajoutent puis retirent ; un retrait l’emporte toujours. L’exception passe en dernier.

GET /policies/effective/{user_id} donne le résultat pour un membre et la source de chaque valeur.

Lire et écrire les règles de l’organisation#Lien vers la section Lire et écrire les règles de l’organisation

GET /policies/org · rules:read

{
  "id": "5b1e0c3a-7d2f-4a8e-9c11-2f6d8e4b7a90",
  "org_id": "8c1f2a4e-5b6d-4e7f-9a0b-1c2d3e4f5a6b",
  "scope_type": "org",
  "scope_id": null,
  "rules": { "features": { "image_generation": false }, "retention_days": 365 },
  "instructions": "Répondez en français et citez vos sources.",
  "rules_format": null,
  "updated_by": "0d9a2f44-1c3b-4e7a-8b6f-55e2c1d0a9b8",
  "updated_at": 1762339200,
  "policy_version": 42,
  "limits": { "files_max_mb": { "min": 1, "max": 500 }, "retention_days": { "min": 30, "max": 3650 }, "usage_pct": { "min": 1, "max": 100 }, "instructions_max": 4000, "model_ids_max": 1000, "connector_ids_max": 1000, "file_types_max": 200 },
  "counts": { "active_members": 380, "outside_access_retained": 379, "without_group": 4 }
}

policy_version augmente à chaque écriture de règles, de rôles, de groupes, d’étiquettes ou de réglages. limits donne aussi les longueurs des noms de groupes, de rôles et d’étiquettes.

PUT /policies/org · rules:write

Un champ absent n’est pas touché ; envoyez au moins l’un des deux.

curl -X PUT https://chat.realmoon.ai/api/v1/orgs/$ORG_ID/policies/org \
  -H "Authorization: Bearer $MOONAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rules": {"features": {"image_generation": false}, "usage": {"session_pct": 50}}}'

import os
import requests

r = requests.put(
    f"https://chat.realmoon.ai/api/v1/orgs/{os.environ['ORG_ID']}/policies/org",
    headers={"Authorization": f"Bearer {os.environ['MOONAI_ADMIN_KEY']}"},
    json={"rules": {"features": {"image_generation": False}, "usage": {"session_pct": 50}}},
    timeout=30,
)
if r.status_code == 400:
    print(r.json()["detail"].get("errors"))
r.raise_for_status()
print(r.json()["policy_version"])

const r = await fetch(`https://chat.realmoon.ai/api/v1/orgs/${process.env.ORG_ID}/policies/org`, {
  method: 'PUT',
  headers: { Authorization: `Bearer ${process.env.MOONAI_ADMIN_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ rules: { features: { image_generation: false }, usage: { session_pct: 50 } } }),
});
const body = await r.json();
if (!r.ok) throw new Error(JSON.stringify(body.detail));
console.log(body.policy_version);

Des règles invalides répondent 400 invalid_request (« Règles invalides. ») avec errors : au plus 20 objets {"path": "models.ids", "message": "Indiquez au moins un modèle."}. Fermer outside_access sans contrat actif répond 403 managed_needs_contract.

PUT /policies/org/models · rules:write

Modifie seulement la règle des modèles : {"models": {"mode": "allow", "ids": ["mistralai/mistral-large-2512"]}}. {"models": {}} revient à tous les modèles. La liste des modèles qu’une règle peut autoriser se lit avec GET /models/catalog.

Chaque écriture de règles envoie l’événement webhook policy.updated avec scope_type et scope_id.

Règles d’un groupe#Lien vers la section Règles d’un groupe

GET /policies/groups/{group_id} · rules:read

PUT /policies/groups/{group_id} · rules:write

Même corps que pour l’organisation, au format des niveaux. La réponse ajoute group_name et rules_format: 2. Les consignes d’un groupe demandent aussi groups:write. Une clé qui ne peut pas agir sur ce groupe reçoit 404.

Règles d’un rôle#Lien vers la section Règles d’un rôle

GET /policies/roles · rules:read

{
  "items": [
    { "role_key": "owner", "name": "Propriétaire", "kind": "provided", "has_rules": false, "has_instructions": false },
    { "role_key": "member", "name": "Élève", "kind": "provided", "has_rules": true, "has_instructions": false },
    { "role_key": "custom:9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "name": "Surveillant", "kind": "created", "has_rules": true, "has_instructions": true }
  ],
  "total": 6,
  "policy_version": 42
}

Les rôles fournis viennent d’abord (owner, admin, manager, member, billing), puis les rôles créés. Le nom des rôles manager et member dépend du type d’organisation.

GET /policies/roles/{role_key} · rules:read

PUT /policies/roles/{role_key} · rules:write

Même corps qu’un groupe ; la réponse ajoute role. Un rôle inconnu répond 404.

Exceptions d’un membre#Lien vers la section Exceptions d’un membre

Une exception passe avant toutes les autres règles du membre.

Une clé ne pose pas d’exception sur le créateur de la clé, le propriétaire, un administrateur, ni sur un membre qui a plus de droits qu’elle (403 forbidden).

Règles effectives d’un membre#Lien vers la section Règles effectives d’un membre

GET /policies/effective/{user_id} · members:read

{
  "managed": true,
  "user_id": "41ab2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
  "policy_version": 42,
  "rules": { "features": { "web_search": false, "image_generation": false }, "models": { "eu_only": true, "mode": "all" }, "retention_days": 365 },
  "sources": {
    "features.web_search": [{ "scope_type": "group", "scope_id": "<id de groupe>", "name": "Classe 3e B" }],
    "models.eu_only": [{ "scope_type": "org", "scope_id": null, "name": null }]
  },
  "derived": { "features.image_generation": "models.eu_only" },
  "instructions": "<organization_instructions source=\"organization\">\nRépondez en français.\n</organization_instructions>",
  "instruction_blocks": [{ "scope_type": "org", "scope_id": null, "name": null, "text": "Répondez en français." }],
  "group_ids": ["<id de groupe>"],
  "base_role": "member",
  "role_keys": ["member"],
  "managed_group_ids": [],
  "member_exception": false,
  "layers": [{ "scope_type": "group", "scope_id": "<id de groupe>", "name": "Classe 3e B", "has_rules": true }],
  "settings": {
    "features.web_search": { "value": false, "source": "group:<id de groupe>", "sources": [], "derived": null },
    "usage.session_pct": { "value": 100, "source": "default", "sources": [], "derived": null }
  },
  "can_edit_exception": true
}

Le calcul se fait même quand l’organisation n’est pas encore gérée.

Aperçu de la conservation#Lien vers la section Aperçu de la conservation

GET /policies/retention/preview?days=365 · rules:read

Rend {"days": 365, "count": 1284, "cutoff": 1730803200, "managed": true} : les conversations du workspace non modifiées depuis cutoff qu’une conservation de days jours supprimerait à la prochaine suppression de nuit. days va de 30 à 3 650.

Voir aussi#Lien vers la section Voir aussi

• Règles, dans l’administration
• Modèles de l’organisation
• Groupes