Organisations filles¶

Une organisation fille est une organisation située sous la vôtre : un de vos clients, si vous êtes partenaire, ou un service de votre propre organisation. Cette page montre comment les retrouver, en créer une nouvelle, avec ou sans offre, et comment en suspendre, reprendre ou supprimer une. Ce que sont les organisations et les partenaires est expliqué dans Personnes et organisations.

Vous travaillez dans une organisation fille avec les rôles que vous avez dans votre propre organisation avec la portée descendants, sans avoir à en être membre (Partenaires). Vous l'ouvrez comme n'importe quelle organisation : tout ce qu'elle contient, comme ses paramètres, son identité visuelle, ses membres et ses offres, vous le gérez sur ses propres pages.

Qui peut faire quoi¶

Le bouton Créer une nouvelle organisation fille n'apparaît que si vous pouvez en créer une. Le menu d'une ligne n'affiche que ce que vous pouvez faire avec cette organisation.

La liste¶

Ouvrez Gestion de l'organisation puis Organisations filles. Cette entrée figure dans le menu dès que votre organisation a des organisations filles que vous voyez, ou dès que vous pouvez en créer une.

• Rechercher par nom garde les organisations dont le nom contient votre texte, majuscules ou non.
• Aussi les niveaux en dessous affiche aussi les organisations sous vos organisations filles, jusqu'au niveau le plus profond. Vous retrouvez ainsi un client par son nom sans ouvrir d'abord son partenaire.
• Basculer vers cette organisation dans le menu d'une ligne, ou un clic sur le nom, ouvre cette organisation.

Créer une organisation fille¶

1. Choisissez Créer une nouvelle organisation fille.
2. Renseignez le Nom. Il est unique sous votre organisation.
3. Choisissez qui devient le premier administrateur. Cochez Je serai moi-même le premier administrateur pour l'être vous-même, ou renseignez l'Adresse e-mail du premier administrateur. Il reçoit le rôle org-admin avec la portée descendants.
4. Choisissez la Séparation des données : Partagée, séparée par organisation (par défaut) ou Un schéma à elle. Elle est fixée dès que l'organisation existe.
5. Ajoutez des Libellés si vous le souhaitez : un libellé et une valeur par ligne. Les règles sur les organisations les lisent (Règles).
6. Si vous pouvez donner des offres, choisissez un Forfait et, pour un essai, la date à laquelle il se termine (Fin de l'essai le). Sans offre, l'organisation reçoit le service de votre propre organisation.
7. Si vous pouvez donner des forfaits et voulez une démo, remplissez Démo jusqu'au. Après ce jour, l'organisation est suspendue, puis supprimée trente jours plus tard, sauf si vous la convertissez. Laissez vide pour une organisation ordinaire.
8. Choisissez Créer une organisation fille.

OS crée l'organisation, l'invitation et l'offre en une seule fois : si l'offre est refusée, rien n'est créé. Si vous êtes vous-même le premier administrateur, il n'y a pas d'invitation : vous êtes membre et administrateur dès que l'organisation est mise en place. Saisir votre propre adresse a le même effet, si elle est vérifiée sur votre compte. Toute autre adresse reçoit une invitation, et ne devient membre que lorsque cette personne l'accepte. La nouvelle organisation figure dans la liste comme En cours de mise en place jusqu'à ce qu'elle soit prête, puis comme Active.

Suspendre, reprendre et supprimer¶

• Suspendre cette organisation l'arrête, avec toutes les organisations en dessous : les requêtes qui y sont faites sont refusées jusqu'à ce que vous la repreniez.
• Reprendre cette organisation remet en service une organisation suspendue.
• Supprimer cette organisation demande d'abord une confirmation. Une organisation qui a ses propres organisations filles ne se supprime qu'une fois celles-ci disparues. Elle est ensuite effacée et figure comme En cours de suppression dans la liste jusqu'à ce que ce soit terminé.

Devenir membre et quitter¶

Vous n'avez besoin d'aucune adhésion pour travailler dans une organisation fille, mais vous pouvez en devenir membre : elle figure alors dans votre propre liste d'organisations, vous y travaillez avec ses propres droits, et ses administrateurs vous voient parmi ses membres.

• Rejoindre cette organisation dans le menu d'une ligne fait de vous un membre, avec le rôle member et rien de plus. Vos rôles d'au-dessus continuent de s'appliquer ; ce que vous recevez de plus dans cette organisation, ses propres administrateurs vous le donnent. Ses administrateurs sont informés que vous l'avez rejointe.
• Quitter cette organisation dans le menu d'une ligne où vous êtes membre demande une confirmation, puis met fin à votre adhésion. Ce que vous y avez créé est conservé. Le dernier administrateur d'une organisation ne peut pas la quitter ; donnez d'abord org-admin à un autre membre.

Vous ne pouvez pas redevenir membre ainsi tant qu'un administrateur a désactivé votre adhésion, ni pendant une session d'assistance. Une organisation qui impose sa connexion d'entreprise ne vous accueille que si vous vous êtes connecté par cette connexion. Si une invitation de cette organisation vous attend, Rejoindre cette organisation l'accepte aussitôt, avec ce qu'elle contient ; votre adresse doit pour cela être vérifiée sur votre compte.

Paramètres par organisation fille¶

Sur un écran large, vous réglez quelques points pour chaque organisation dans sa ligne, comme dans Artific Platform. Qui ne peut pas modifier une valeur la voit comme une étiquette.

• Démo : choisissez une autre date de fin, ou retirez-la avec la croix. La retirer convertit la démo en organisation ordinaire (La date de fin d'une démo).
• Aperçu des coûts : le plus loin que l'organisation peut montrer les coûts et l'usage des jetons. Elle choisit toujours qui les voit, mais jamais au-delà, et cela vaut aussi pour les organisations en dessous. Avec Personne, personne n'y voit les coûts, même si ses administrateurs ont choisi autrement ; leur choix est gardé pour le jour où vous l'élargissez.
• Journaux de session : désactivé signifie que personne dans cette organisation, ses administrateurs compris, ne peut lire les conversations d'un autre avec un assistant, quoi que disent ses règles. Chacun ne voit alors que ses propres conversations dans les journaux de session. Cela vaut aussi pour les organisations en dessous, et pour qui appelle Core directement. Tant que c'est désactivé, OS refuse une règle ou un rôle qui le rouvrirait.
• Forfaits : cochez un forfait pour le donner à partir de maintenant, décochez-le pour le retirer. Un forfait donné par une organisation au-dessus de vous reste coché et verrouillé : elle seule peut le retirer. Un essai indique sa date de fin.
• Restrictions des administrateurs dans le menu d'une ligne : ce que les administrateurs de cette organisation ne peuvent pas faire eux-mêmes, à savoir Voir la consommation, Voir la piste d'audit et Gérer les clés. OS lit la valeur actuelle à l'ouverture de la fenêtre.

Chaque modification va sur la piste d'audit de cette organisation, avec qui l'a faite, et jamais avec la valeur.

Via l'API¶

Les exemples utilisent $OS, $TOKEN et $ORG comme dans Gérer les groupes.

curl -s "$OS/api/v1/organisations/$ORG/organisations?scope=descendants&q=acme" \
    -H "Authorization: Bearer $TOKEN"

{"items": [{"id": "org_...", "name": "Acme", "parent_id": "org_...", "status": "active",
            "child_count": 2, "reach": "from_above", "plans": ["Basic"],
            "primary_colour": "#287deb", "may_join": true,
            "parent_allowed_actions": ["see", "write", "delete"],
            "child_allowed_actions": ["see", "write", "delete"]}],
 "next_cursor": null}

• scope vaut children (par défaut : seulement les organisations directement en dessous) ou descendants (tous les niveaux).
• q garde les noms qui contiennent le texte ; status garde un seul statut.
• La liste est triée par nom et arrive par pages : passez next_cursor comme cursor pour la suivante. Une page peut avoir moins de lignes que limit alors que next_cursor continue.
• reach vaut member ou from_above ; plans est vide si vous ne pouvez pas voir le service de cette organisation. parent_allowed_actions indique si vous pouvez la suspendre et la reprendre (write) et la supprimer (delete).
• child_allowed_actions figure sur chaque organisation : s'il contient write, vous pouvez créer une organisation en dessous.
• primary_colour est la couleur de la liste, null pour la couleur propre de la plateforme ; may_join indique si vous pouvez en devenir membre.

Créer une organisation, avec une offre pour un essai :

curl -s -X POST "$OS/api/v1/organisations/$ORG/organisations" \
    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
    -d '{"name": "Acme", "first_admin_email": "admin@acme.example",
         "plan_id": "pln_...", "plan_ends_at": "2026-12-31T00:00:00Z"}'

Envoyez "first_admin_self": true au lieu de first_admin_email pour être vous-même le premier administrateur ; l'un des deux est obligatoire. isolation (shared ou schema) et labels sont facultatifs. Les offres que vous pouvez donner se lisent avec GET /api/v1/organisations/$ORG/assignable-plans (Offres et exceptions). Suspendre, reprendre et supprimer sont POST …/organisations/{id}/suspend, POST …/resume et DELETE /api/v1/organisations/{id}. Devenir membre se fait par POST …/organisations/{id}/join et quitter par POST …/organisations/{id}/leave.

Pour créer une démo, envoyez "demo_ends_at": "2027-01-31T00:00:00Z" à la création. Chaque ligne de la liste a aussi demo_ends_at, cost_visibility_limit, session_logs_readable, plan_assignments (chaque forfait avec id, ends_at et may_take_back) et service_parent_actions. L'aperçu des coûts et les journaux de session se lisent avec GET /api/v1/organisations/{id}/limits et se modifient avec PATCH, à côté du plafond de coûts et de admin_restrictions :

curl -s -X PATCH "$OS/api/v1/organisations/$CLIENT/limits" \
    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
    -d '{"cost_visibility_limit": "off", "session_logs_readable": false}'

Quand OS refuse¶