Tochterorganisationen¶

Eine Tochterorganisation ist eine Organisation unterhalb Ihrer eigenen: ein Kunde von Ihnen, wenn Sie Partner sind, oder eine Abteilung Ihrer eigenen Organisation. Diese Seite zeigt, wie Sie sie finden, eine neue anlegen, mit oder ohne Plan, und wie Sie eine aussetzen, fortsetzen oder löschen. Was Organisationen und Partner sind, steht unter Personen und Organisationen.

In einer Tochterorganisation arbeiten Sie mit den Rollen, die Sie in Ihrer eigenen Organisation mit der Reichweite descendants haben, ohne dort Mitglied sein zu müssen (Partner). Sie öffnen sie wie jede Organisation: Alles in ihr, etwa ihre Einstellungen, ihr Corporate Design, ihre Mitglieder und ihre Pläne, verwalten Sie auf ihren eigenen Seiten.

Wer was darf¶

Die Schaltfläche Neue Tochterorganisation erstellen sehen Sie nur, wenn Sie eine anlegen dürfen. Das Menü einer Zeile zeigt nur, was Sie mit dieser Organisation tun dürfen.

Die Liste¶

Öffnen Sie Organisationsverwaltung und dann Tochterorganisationen. Der Eintrag steht im Menü, sobald Ihre Organisation Tochterorganisationen hat, die Sie sehen, oder sobald Sie eine anlegen dürfen.

• Nach Name suchen behält die Organisationen, deren Name Ihren Text enthält, unabhängig von Groß- und Kleinschreibung.
• Auch die Ebenen darunter zeigt auch die Organisationen unter Ihren Tochterorganisationen, bis zur tiefsten Ebene. So finden Sie einen Kunden nach Namen, ohne zuerst seinen Partner zu öffnen.
• Zu dieser Organisation wechseln im Menü einer Zeile, oder ein Klick auf den Namen, öffnet diese Organisation.

Eine Tochterorganisation anlegen¶

1. Wählen Sie Neue Tochterorganisation erstellen.
2. Tragen Sie den Name ein. Er ist unter Ihrer Organisation eindeutig.
3. Wählen Sie, wer der erste Administrator wird. Kreuzen Sie Ich werde selbst der erste Administrator an, um es selbst zu sein, oder tragen Sie die E-Mail-Adresse des ersten Administrators ein. Er bekommt die Rolle org-admin mit der Reichweite descendants.
4. Wählen Sie die Trennung der Daten: Geteilt, je Organisation getrennt (die Voreinstellung) oder Ein eigenes Schema. Das steht fest, sobald die Organisation besteht.
5. Geben Sie auf Wunsch Labels an: ein Label und einen Wert je Zeile. Regeln über Organisationen lesen sie (Regeln).
6. Wenn Sie Pläne vergeben dürfen, wählen Sie ein Paket und für eine Testphase das Datum, an dem sie endet (Testphase endet am). Ohne Plan bekommt die Organisation den Dienst Ihrer eigenen Organisation.
7. Wenn Sie Pakete vergeben dürfen und eine Demo möchten, füllen Sie Demo bis aus. Nach diesem Tag wird die Organisation gesperrt und dreißig Tage später gelöscht, sofern Sie sie nicht umwandeln. Lassen Sie das Feld für eine reguläre Organisation leer.
8. Wählen Sie Tochterorganisation erstellen.

OS legt die Organisation, die Einladung und den Plan in einem Zug an: Wird der Plan abgelehnt, wird nichts angelegt. Sind Sie selbst der erste Administrator, gibt es keine Einladung: Sie sind Mitglied und Administrator, sobald die Organisation eingerichtet ist. Ihre eigene Adresse einzutragen wirkt genauso, wenn sie in Ihrem Konto bestätigt ist. Jede andere Adresse bekommt eine Einladung und wird erst Mitglied, wenn diese Person sie annimmt. Die neue Organisation steht in der Liste als Wird eingerichtet, bis sie fertig ist, und ist danach Aktiv.

Aussetzen, fortsetzen und löschen¶

• Diese Organisation aussetzen legt sie still, mit allen Organisationen darunter: Anfragen in ihnen werden abgelehnt, bis Sie sie fortsetzen.
• Diese Organisation fortsetzen schaltet eine ausgesetzte Organisation wieder ein.
• Diese Organisation löschen fragt zuerst nach einer Bestätigung. Eine Organisation mit eigenen Tochterorganisationen löschen Sie erst, wenn diese weg sind. Danach wird sie gelöscht und steht als Wird gelöscht in der Liste, bis das erledigt ist.

Mitglied werden und verlassen¶

Sie brauchen keine Mitgliedschaft, um in einer Tochterorganisation zu arbeiten, können aber Mitglied werden: Dann steht sie in Ihrer eigenen Liste der Organisationen, Sie arbeiten darin mit ihren eigenen Rechten, und ihre Administratoren sehen Sie unter ihren Mitgliedern.

• Dieser Organisation beitreten im Menü einer Zeile macht Sie zum Mitglied, mit der Rolle member und sonst nichts. Ihre Rollen von oben gelten weiter; was Sie in dieser Organisation mehr erhalten, geben Ihnen ihre eigenen Administratoren. Ihre Administratoren erfahren, dass Sie beigetreten sind.
• Diese Organisation verlassen im Menü einer Zeile, in der Sie Mitglied sind, fragt nach einer Bestätigung und beendet dann Ihre Mitgliedschaft. Was Sie darin erstellt haben, bleibt erhalten. Der letzte Administrator einer Organisation kann sie nicht verlassen; geben Sie zuerst einem anderen Mitglied org-admin.

Auf diesem Weg werden Sie nicht erneut Mitglied, solange ein Administrator Ihre Mitgliedschaft deaktiviert hat, und auch nicht während einer Support-Sitzung. Eine Organisation, die ihren Firmen-Login vorschreibt, nimmt Sie nur auf, wenn Sie sich über diesen Login angemeldet haben. Wartet eine Einladung dieser Organisation auf Sie, nimmt Dieser Organisation beitreten sie sofort an, mit dem, was sie enthält; dafür muss Ihre Adresse in Ihrem Konto bestätigt sein.

Einstellungen je Tochterorganisation¶

Auf einem breiten Bildschirm legen Sie in jeder Zeile einiges für diese Organisation fest, wie in Artific Platform. Wer einen Wert nicht ändern darf, sieht ihn als Label.

• Demo: Wählen Sie ein anderes Enddatum oder entfernen Sie es mit dem Kreuz. Entfernen wandelt die Demo in eine reguläre Organisation um (Das Enddatum einer Demo).
• Kostenübersicht: wie weit die Organisation Kosten und Tokenverbrauch höchstens zeigen darf. Sie wählt weiterhin selbst, wer sie sieht, aber nie darüber hinaus, und das gilt auch für die Organisationen darunter. Mit Niemand sieht dort niemand Kosten, auch wenn ihre Administratoren etwas anderes gewählt haben; ihre Wahl bleibt erhalten, falls Sie es wieder erweitern.
• Sitzungsprotokolle: Aus bedeutet, dass niemand in dieser Organisation, auch ihre Administratoren nicht, die Chats anderer mit einem Assistenten lesen kann, was ihre Regeln auch sagen. Jeder sieht in den Sitzungsprotokollen dann nur die eigenen Chats. Das gilt auch für die Organisationen darunter und für direkte Aufrufe von Core. Solange es aus ist, lehnt OS eine Regel oder Rolle ab, die es wieder öffnen würde.
• Pakete: Haken Sie ein Paket an, um es ab jetzt zu vergeben, und entfernen Sie den Haken, um es zurückzunehmen. Ein Paket, das eine Organisation über Ihnen vergeben hat, bleibt angehakt und gesperrt: Nur sie kann es zurücknehmen. Bei einer Testphase steht das Enddatum dabei.
• Einschränkungen für Administratoren im Menü einer Zeile: was die Administratoren dieser Organisation selbst nicht dürfen, nämlich Verbrauch ansehen, Audit-Trail ansehen und Schlüssel verwalten. OS liest den aktuellen Wert, wenn Sie das Fenster öffnen.

Jede Änderung kommt in den Audit-Trail dieser Organisation, mit wem sie vornahm, und nie mit dem Wert.

Über die API¶

Die Beispiele nutzen $OS, $TOKEN und $ORG wie unter Gruppen verwalten.

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 ist children (die Voreinstellung: nur direkt darunter) oder descendants (alle Ebenen).
• q behält die Namen, die den Text enthalten; status behält einen Status.
• Die Liste ist nach Namen sortiert und kommt seitenweise: Geben Sie next_cursor als cursor mit, um die nächste Seite zu holen. Eine Seite kann weniger Zeilen als limit haben, während next_cursor weiterläuft.
• reach ist member oder from_above; plans ist leer, wenn Sie den Dienst dieser Organisation nicht sehen dürfen. parent_allowed_actions sagt, ob Sie sie aussetzen und fortsetzen (write) und löschen (delete) dürfen.
• child_allowed_actions steht bei jeder Organisation: Enthält es write, dürfen Sie darunter eine Organisation anlegen.
• primary_colour ist die Farbe in der Liste, null für die eigene Farbe der Plattform; may_join sagt, ob Sie Mitglied werden dürfen.

Eine Organisation anlegen, mit einem Plan für eine Testphase:

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"}'

Senden Sie "first_admin_self": true statt first_admin_email, um selbst der erste Administrator zu sein; eines von beiden ist Pflicht. isolation (shared oder schema) und labels sind optional. Welche Pläne Sie vergeben können, lesen Sie mit GET /api/v1/organisations/$ORG/assignable-plans (Pläne und Ausnahmen). Aussetzen, Fortsetzen und Löschen sind POST …/organisations/{id}/suspend, POST …/resume und DELETE /api/v1/organisations/{id}. Mitglied werden ist POST …/organisations/{id}/join, verlassen POST …/organisations/{id}/leave.

Eine Demo legen Sie an, indem Sie beim Anlegen "demo_ends_at": "2027-01-31T00:00:00Z" mitgeben. Jede Zeile der Liste hat außerdem demo_ends_at, cost_visibility_limit, session_logs_readable, plan_assignments (jedes Paket mit id, ends_at und may_take_back) und service_parent_actions. Kostenübersicht und Sitzungsprotokolle lesen Sie mit GET /api/v1/organisations/{id}/limits und ändern sie mit PATCH, neben der Kostengrenze und admin_restrictions:

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

Wenn OS ablehnt¶