Telesherpa Ontology Platform

Zeigt den Auth-Zustand dieser Verbindung: ob der Bearer-Token gueltig ist, welche Rollen er traegt und welcher naechste Schritt ansteht. Rein lesend, aendert nichts am Konto. Nuetzlich, wenn unerwartet wenige Tools sichtbar sind — die Antwort nennt Rollen, Tool-Zahlen und den weiteren Weg (login, refresh_access_token, register). Referenz zur Plattform-Dokumentation: SKILL.md im Repo https://codeberg.org/telesherpa/skill-telesherpa-com (Unterordner telesherpa-ontology-platform/); die Antwort fuehrt dazu guide_repo, guide_entry und guide_version. | EN: auth, status, documentation, tool-reference, login

Takes no parameters.

Ein Bearer-Token holen: tauscht client_id (E-Mail) und client_secret (Passwort) gegen access_token + refresh_token. Das ist der Einstieg — ohne Token sind nur die oeffentlichen Tools sichtbar. Nutze es einmalig am Anfang; das Token gilt 10 Stunden. Danach NICHT erneut einloggen, sondern mit refresh_access_token erneuern (dafuer braucht es kein Passwort). Passwort vergessen? Dafuer gibt es kein Tool — das macht der Mensch ueber die Weboberflaeche. Ein Konto gibt es noch nicht: vorher register. Speichere access_token (10 h) UND refresh_token (30 Tage) sofort dauerhaft — die Antwort kommt nur einmal. Mit refresh_access_token (grant_type=refresh_token) erneuerst du ohne Passwort. | EN: login, authentication, sign in, token

Token-Selbst-Erneuerung (OAuth2-Refresh). Tauscht einen gueltigen refresh_token gegen ein neues access_token + rotierten refresh_token, OHNE Passwort. Antworte proaktiv vor Ablauf (expires_in=10h): {access_token, refresh_token, expires_in}. Der neue refresh_token ersetzt den alten (Rotation). | EN: refresh, access, token

Credit-Kosten pro Aktion (Pay-per-Use). Zeigt, wie viele Credits jede Operation verbraucht. Flat-User (billing_model=flat) zahlen keine Credits. 1 Credit = 0,01 EUR. | EN: credit, balance, pricing, billing, top-up, checkout

Takes no parameters.

Konto anlegen — zwei Wege. WEG 1, AGENT (kein Postfach, kein Mensch noetig): register mit agent=true + accept_terms=true. Adresse und Passwort erzeugt die Plattform; beide kommen EINMALIG in der Antwort (username, password), damit meldest du dich per login an. Die Rolle 'member' ist sofort aktiv, keine Mail, kein activate. Ein optionaler invite_code wird sofort uebernommen (gilt die Drossel: 10 Fehlversuche je IP und Stunde, dann 429); ohne Code bist du voellig isoliert (keine Mitgliedschaft, keine fremden Scopes) — Zugang spaeter per redeem_invite_code oder Service Request. KEIN Startguthaben: das Konto startet mit 0 Credits und bezahlt sich selbst — onto_credit_checkout (Karte) oder onto_credit_chargeup (prepaid_code). WEG 2, MENSCH: register mit username (E-Mail), password, password_confirm; dann Aktivierungscode per Mail, danach activate. WICHTIG: mit accept_terms=true bestaetigst du die Nutzungsbedingungen (https://www.telesherpa.com/agb). Nach der Registrierung hast du zwei Wege: (a) einem fremden Scope beitreten (invite_code an redeem_invite_code) oder (b) selbst etwas bauen (ontouser_scope_create) und danach mit create_invite_code Einladungscodes erzeugen, um Menschen und andere Agenten in deinen Scope zu holen. Zugangsdaten kommen NUR EINMAL: username/password sofort dauerhaft speichern (Datei chmod 600 oder Secret-Store) — wer sie nur im Kontext behaelt, steht beim naechsten Start ohne Konto da, und eine Neuregistrierung ist ein neues, leeres Konto. Nach dem login zusaetzlich den refresh_token (30 Tage) ablegen: der holt neue Access-Tokens (10 h) ohne Passwort. Vier Wege zu Guthaben oder Zugang, je mit Werkzeugnamen: (a) EINLADUNG — invite_code bei register oder spaeter redeem_invite_code (Zugang zu einem fremden Scope, kein Guthaben); (b) SELBST ZAHLEN — onto_credit_checkout (gehostete Zahlseite, Karte); (c) PREPAID — onto_credit_chargeup mit prepaid_code; (d) IDEE — ontouser_service_request (kostenlos): beschreibe, was du bauen willst, die Administratore

Activate a registered account with the voucher code from the activation email. Meldet sich intern mit loginusername/loginpassword an und loest dann den Voucher ein. Nach der Registrierung per E-Mail erhaltenen 7-stelligen Aktivierungscode hier eingeben. Den Code bekommst du entweder vom Menschen genannt (Standardweg — einfach danach fragen, die Mail kommt in einer Minute) oder per IMAP aus dem Postfach. Benötigt die Login-Daten (E-Mail + Passwort) des registrierten Accounts. Entfernt die 'notactivated'-Rolle und gibt vollen Zugriff. | EN: activation, onboarding, account setup

Ein Bild ueber urlslug und filetoken als Rohdatei abrufen. Rein lesend. Nutze es, wenn du die beiden Kennungen hast (sie stehen an Objekten/Bildablagen). Ohne filetoken kommst du an die Datei nicht heran — die Kennungen liefert dir das Objekt (onto_object_show) oder die strukturierte Ablage (onto_file_structured). Nicht zum Hochladen: dafuer upload_file_to_object. | EN: get, image

Ein Dokument (PDF, Office-Datei) ueber urlslug und filetoken als Rohdatei abrufen. Rein lesend. Nutze es, wenn du die beiden Kennungen hast. Fuer Bilder gibt es get_image; die Kennungen bekommst du aus dem Objekt (onto_object_show). Nicht zum Hochladen: dafuer upload_file_to_object. | EN: get, document

Eine CSV-Datei in den Staging-Bereich hochladen (Vorbereitung fuer einen Datenimport). Schreibt die Datei ab, importiert sie aber NICHT — das ist nur die Ablage. Nutze es als ersten Schritt eines Massenimports; die Weiterverarbeitung laeuft danach ueber die Import-Tools (onto_import_create_source, onto_import_analyze, onto_import_run_step). Die Datei kommt als base64. Fuer Bilder/PDFs an Objekten: upload_file_to_object. | EN: import, CSV, staging, upload

Upload a file to an object. type=structuredimage (Bild erscheint in der strukturierten Bildablage/Thumbnail) oder document (reguläre Datei). name=Kategorie-Image-Name (z.B. Image01.jpg) bei structuredimage. SSR: landet im write_scope falls read-only. RUECKGABE: file_udid (32-hex). Genau dieser Wert gehoert in formdef.template_file, wenn die Datei als PDF-Vorlage dienen soll. | EN: file, upload, document, attachment

XLSX/XLS-Bulk-Upload fuer die E-Mail-Allowlist eines Scope-Invite-Codes (z.B. 500 Subunternehmer-Adressen). ERSETZT alle bestehenden 'email'-Allowlist-Eintraege dieses Codes (domain/glob-Eintraege bleiben unberuehrt) — fuer den woechentlichen Neu-Upload-Workflow gedacht. Braucht can_manage_scope=1 auf dem Scope des Codes. | EN: allowlist, permission, whitelist, code

Das Passwort des EIGENEN Kontos aendern. Nutze es, wenn der Mensch das Passwort wechseln will. Das alte Passwort ist Pflicht; das neue muss zweimal identisch uebergeben werden. Es aendert nur das eigene Konto — fremde Passwoerter kann auch ein Administrator nicht setzen (Konten verwaltet er mit onto_user_update). Nach der Aenderung sind laufende Tokens des Kontos weiterhin gueltig; eine Neuanmeldung ist nicht noetig. | EN: password, credentials, account

Eigenes Profil rein lesend abrufen (Name, E-Mail, Organisation, Notizen, Skills). Kein Schreibpfad. | EN: who am i, my account, profile

Takes no parameters.

Das Profil des EIGENEN Kontos lesen oder aendern (Anzeigename, Telefon, Organisation, Notizen, Skills). Ohne Felder aufgerufen liefert es den Ist-Stand; mit Feldern aendert es. Nutze es fuer Stammdaten der eigenen Person. Es aendert KEINE Zugriffsrechte (Rollen) — dafuer ist ein Administrator zustaendig (onto_user_update). Fremde Profile: onto_user_update_profile. Das eigene Konto samt Rollen lesen: onto_user_get. | EN: file, upload, document, attachment

Das Konto mit einem 4-stelligen Verifizierungscode verlaengern (Lebenszyklus, etwa alle 3 Monate). Der Code kommt per E-Mail; ohne ihn laeuft das Konto ab. Nutze es, wenn eine Verlaengerungsaufforderung kommt oder die Laufzeit auslaeuft. Den Code besorgt der Mensch (er kommt in einer Minute per Mail) — kein Postfachzugriff noetig. Zur Erstanmeldung: login. Ein neues Konto entsteht hier nicht: dafuer register. | EN: renew, account

Die eigenen Benachrichtigungen abrufen (Meldungen des angemeldeten Kontos). Rein lesend. Nutze es, um neue Meldungen zu finden. Die Self-Service-Variante mit gleichem Inhalt ist ontouser_notification_index — nimm sie, wenn du als Scope-Nutzer arbeitest. Meldungen als gelesen markieren: ontouser_notification_read. Systemprotokolle (Admin): onto_action_logs. | EN: notification, message, alert, inbox, unread

Takes no parameters.

Alle Objekte auflisten, seitenweise und nach optionalem Filter. Rein lesend. Nutze es fuer Uebersichten und Zaehlungen. Wenn du EIN Objekt ueber seine udid kennst, nimm onto_object_show (billiger); fuer Volltextsuche ueber mehrere Felder onto_object_search. | EN: object, record, entry, property, link, search

Ein einzelnes Objekt ueber seine udid vollstaendig lesen — alle Properties und Interfaces. Rein lesend. Nutze es, wenn du die udid schon hast. Ohne udid: erst onto_object_search oder onto_object_index. Die identische Antwort liefert ontouser_object_show. | EN: object, record, entry, property, link, search

Ein Objekt samt seinen Verknuepfungen als Graph lesen (Knoten + Kanten). Rein lesend. Nutze es fuer Beziehungsfragen ('womit haengt X zusammen'). Fuer die reine Feldansicht eines Objekts genuegt onto_object_show; fuer die Liste aller Link-Definitionen onto_link_index. | EN: object, record, entry, property, link, search

Ein neues Objekt anlegen. Schreibt in die Datenbank — kein Trockenlauf. Pflicht ist mindestens type; properties ist eine Map Property-key -> Wert, interfaces eine Liste von Interface-Namen. Nutze es fuer neue Datensaetze; zum Aendern eines bestehenden nimm onto_object_update oder onto_object_set_property. Legt bei Bedarf NICHT automatisch Verknuepfungen an — dafuer onto_object_create_link. | EN: object, record, entry, property, link, search

Genau ein Property eines Objekts setzen oder ueberschreiben. Nutze es fuer gezielte Einzelkorrekturen; fuer mehrere Felder auf einmal onto_object_update. Ein Property entfernt dagegen onto_object_delete_property. Der bisherige Wert ist danach weg (keine Historie, kein Undo). Zeitpunkt-Properties: Eingaben gelten in der Zeitzone des Betrachters (Default Europe/Berlin) und werden als UTC gespeichert; die JSON-Ausgabe zeigt UTC. Wer UTC schickt, bekommt je nach Zone einen Versatz. | EN: object, record, entry, property, link, search ZEITREGEL: Datum/Zeit liegt in der DB als UTC und wird von MCP ROH als UTC ausgegeben — im Browser eingegebene 10:00 erscheinen hier als 09:00 (Winter) / 08:00 (Sommer); die Oberflaeche rechnet in die Betrachterzone um (Cookie -> Profilfeld -> Europe/Berlin). Zeit-Operatoren: minutes_of, minutes_between[von,bis], hours_between[von,bis,pause_minuten].

Einen Kommentar an ein Objekt anhaengen (Verlaufseintrag mit Autor und Zeitstempel). Rein anhaengend — bestehende Kommentare bleiben. Nutze es fuer Notizen und Rueckfragen am Datensatz. Es aendert KEINE Properties; dafuer onto_object_set_property. Ein Kommentar ist ein eigenes Objekt vom Typ comment, per hascomment-Link am Zielobjekt. Loeschen: onto_object_delete mit der udid des Kommentars (status wird deleted, er verschwindet aus dem Panel). Aendern geht nicht - loeschen und neu schreiben. | EN: object, record, entry, property, link, search

Eine hinterlegte Action (Button/Automatik) auf einem Objekt ausfuehren. Der Effekt haengt an der Action-Definition und kann Properties aendern, Links setzen oder Folgeprozesse starten — also nicht rein lesend. Nutze es, wenn am Objekt eine Action angeboten wird; die verfuegbaren Actions zeigt onto_actiondef_list. | EN: object, record, entry, property, link, search

Zwei Objekte ueber einen Link-Typ miteinander verbinden. Schreibt eine neue Kante; mehrfaches Aufrufen erzeugt keine Dublette, sondern aktualisiert die Kante. Die verfuegbaren Link-Typen zeigt onto_link_index. Bestehende Kanten aendern: onto_object_update_link. | EN: object, record, entry, property, link, search

Eigenschaften einer BESTEHENDEN Verknuepfung aendern (z.B. Rollen oder Gewichtung der Kante). Nutze es nicht zum Anlegen — dafuer onto_object_create_link. Zum Entfernen der Kante: onto_object_delete_link. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: object, record, entry, property, link, search

Eine Verknuepfung zwischen zwei Objekten entfernen. Loescht nur die Kante, NICHT die beteiligten Objekte. Unwiderruflich. Zum Anlegen derselben Kante wieder onto_object_create_link. | EN: object, record, entry, property, link, search

Ein einzelnes Property von einem Objekt entfernen (der Wert verschwindet, das Objekt bleibt). Unwiderruflich. Nutze es zum Aufraeumen fehlerhafter Felder; um nur den Wert zu leeren, genuegt onto_object_set_property mit leerem Wert. Zum Loeschen des ganzen Objekts onto_object_delete. | EN: object, record, entry, property, link, search

Ein Objekt unwiderruflich loeschen, samt seiner Properties. Nutze es nur, wenn der Datensatz wirklich entfallen soll — es gibt kein Undo. Zum Deaktivieren/Archivieren stattdessen ein Status-Property via onto_object_set_property setzen. Fuer mehrere Objekte auf einmal: onto_object_bulk_action. | EN: object, record, entry, property, link, search

Mehrere Felder eines bestehenden Objekts in einem Aufruf aendern. Ueberschreibt die uebergebenen Properties; nicht genannte Felder bleiben unberuehrt. Nutze es fuer mehrere Aenderungen gleichzeitig; fuer ein einzelnes Feld ist onto_object_set_property schlanker. Loeschen ist nicht Teil dieses Tools. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: object, record, entry, property, link, search

Objekte ueber ihre Feldwerte suchen (Filter/Textsuche ueber Properties). Rein lesend. Nutze es, wenn du Objekte NICHT ueber die udid kennst — das ist der Einstieg vor onto_object_show. Fuer die reine Scope-Auswahl vor der Suche onto_object_search_scopes. | EN: object, record, entry, property, link, search

Den aktuellen Beobachtungs-Zeiger lesen (Stand, bis zu dem Aenderungen abgeholt wurden). Rein lesend. Nutze es ZUSAMMEN mit onto_watch_changes: erst Cursor lesen, dann Aenderungen abholen, dann den Zeiger weiterruecken — so verpasst du nichts und liest nichts doppelt. Fuer den Volltextbestand nimm onto_object_index. | EN: changes, audit, feed, monitoring, event log, cursor

Takes no parameters.

Aenderungen seit einem Cursor abholen (was wurde angelegt/geaendert/geloescht). Rein lesend. Nutze es fuer die inkrementelle Synchronisation, nicht fuer Uebersichten — dafuer ist onto_object_index da (billiger und vollstaendig). Den Ausgangsstand liefert onto_watch_cursor. | EN: changes, audit, feed, monitoring, event log, cursor

Alle Verbindungen (Zugangsdaten fuer Fremdsysteme) auflisten, die das eigene Profil sehen darf. Zeigt Ziel, Bezeichnung, Basis-URL und Bindung, niemals das Geheimnis. Rein lesend. | EN: connection, credential, vault, secret, integration, list

Takes no parameters.

Verbindung anlegen oder ersetzen: gleiches target_key ersetzt den eigenen Eintrag, die id bleibt, es gibt keine Historie. Das Geheimnis wird verschluesselt abgelegt und nie zurueckgegeben. | EN: connection, credential, save, store, secret, upsert

Verbindung per id loeschen. Loescht nur eigene Eintraege; fremde antworten 404, ohne ihre Existenz zu verraten. Systemschluessel nur fuer die Verwaltung. | EN: connection, credential, delete, remove, revoke

Zustand des Schluesseltresors pruefen: Schluesseldatei geladen, Entschluesselung moeglich, Zeilenzahl. Rein lesend, zeigt keine Geheimnisse. | EN: connection, vault, key, check, health, diagnosis

Takes no parameters.

Ausgang auflisten: was an Fremdsysteme rausgeht oder rausging, je Zeile Status, Versuche, HTTP-Code und Fehlertext, dazu Zaehler je Ziel. Rein lesend. | EN: outbox, queue, delivery, webhook, retry, status

Eine Ausgangszeile testweise erzeugen, ohne zu senden. ACHTUNG: legt eine echte Zeile an. | EN: outbox, preview, dry-run, test, webhook

Gescheiterte Ausgangszeile erneut senden. Sinnvoll nur fuer tote oder endgueltig gescheiterte Zeilen. | EN: outbox, retry, resend, replay, webhook

Die durchsuchbaren Scopes ermitteln, bevor du onto_object_search aufrufst. Rein lesend. Nutze es, um zu erfahren, welche Bereiche fuer dein Konto ueberhaupt sichtbar sind (fail-closed: nur eigene Zuordnungen). Fuer die Suche selbst onto_object_search. | EN: object, record, entry, property, link, search

Koordinaten zu einem Objekt ermitteln und hinterlegen (Adresse -> Lat/Lon). Schreibt in das Objekt und ruft dazu einen externen Kartendienst auf (offene Welt). Nutze es nach dem Anlegen eines Objekts mit Adresse, wenn Kartenmarker gebraucht werden. Kartenanzeige selbst: onto_interface_map_markers. | EN: object, record, entry, property, link, search

Dieselbe Aktion auf viele Objekte in einem Aufruf anwenden (Massenbearbeitung). Nutze es ab mehreren Datensaetzen statt einer Schleife aus Einzelaufrufen. Wirkung und Seiteneffekte sind die der jeweiligen Action und koennen nicht zurueckgenommen werden — vorher mit onto_object_index die Zielmenge eingrenzen. | EN: object, record, entry, property, link, search

Action-Definitionen auflisten (ausfuehrbare Buttons am Objekt, Konfigurationssicht). Rein lesend. Nutze es als Administrationssicht ueber alle Actiondefs. Nur die fuer dich nutzbaren zeigt onto_actiondef_list — das ist meist der bessere Einstieg, wenn du eine Action AUSFUEHREN willst (onto_object_execute_action). | EN: action, button, definition, gate, condition, rule

Alle Interfaces auflisten (Sichten/Masken, die festlegen, welche Felder ein Objekt zeigt). Rein lesend. Nutze es, um den Interface-Namen fuer onto_object_create oder die Anzeige zu finden. Ein einzelnes Interface: onto_interface_show. | EN: onto, interface, index

Ein einzelnes Interface vollstaendig lesen (enthaltene Felder, Gruppierung, Sichtbarkeit). Rein lesend. Nutze es, wenn der Name bekannt ist. Ohne Namen: onto_interface_index. Die identische Antwort liefert ontouser_interface_show. | EN: onto, interface, show

Die Kartenmarker eines Interfaces abrufen (Objekte mit Koordinaten zur Anzeige auf der Karte). Rein lesend, ruft keine Kartendaten extern ab. Nutze es fuer Karten-/Karten-Ansichten; fehlende Koordinaten erst mit onto_object_geocode setzen. Die identische Antwort liefert ontouser_interface_map_markers. | EN: onto, interface, map, markers

Eine neue Interface-Definition anlegen (neue Sicht/Maske). Aendert das Modell. Nutze es, wenn ein Objekttyp eine zusaetzliche Ansicht bekommen soll. Bestehende Interfaces aenderst du mit onto_interface_update_def. | EN: onto, interface, create, def Verengung (optional): table.scopes mit Scopenamen schraenkt die Zeilen dieser Ansicht zusaetzlich auf diese Scopes ein (nur einschraenkend, unbekannter Name = 400). Die Ansicht zeigt sie unter der Ueberschrift an; trage sie zusaetzlich in die description des Interfaces ein.

Eine bestehende Interface-Definition aendern (Felder, Reihenfolge, Sichtbarkeit). Betrifft die Sicht, nicht die Daten. Nutze es zum Anpassen einer Maske; welche Felder es ueberhaupt gibt, zeigt onto_property_def_index. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: onto, interface, update, def Verengung (optional): table.scopes mit Scopenamen schraenkt die Zeilen dieser Ansicht zusaetzlich auf diese Scopes ein (nur einschraenkend, unbekannter Name = 400). Die Ansicht zeigt sie unter der Ueberschrift an; trage sie zusaetzlich in die description des Interfaces ein.

Eine Interface-Definition entfernen. Entfernt die Sicht, NICHT die Objekte oder Felder. Pruefe vorher, ob Objekttypen das Interface verwenden. Ein einzelnes Feld aus dem Modell entfernst du mit onto_property_def_delete. | EN: onto, interface, delete, def

Alle Objekttypen auflisten (Grundtypen des Modells, z.B. Kunde, Auftrag, Anlage). Rein lesend. Nutze es als ersten Schritt, wenn du den Typ-Namen fuer onto_object_create oder die Filter von onto_object_search brauchst. Ein einzelnen Typ: onto_type_show. | EN: object type, schema, type, definition

Einen Objekttyp vollstaendig lesen (zugehoerige Properties, Interfaces, Eigenschaften). Rein lesend. Nutze es, wenn dir der Typ-Name bekannt ist und du wissen willst, welche Felder er erlaubt — das ist die Vorbereitung fuer onto_object_create. Die reine Namensliste liefert onto_type_index. | EN: object type, schema, type, definition

Einen neuen Objekttyp ins Modell aufnehmen. Aendert das Schema; danach koennen Objekte dieses Typs angelegt werden. Nutze es beim Modellaufbau, nicht zur Datenpflege. Bestehende Typen aenderst du mit onto_type_update, entfernen mit onto_type_delete. Nur Administratoren: eigene Objekttypen sind Plattform-Schema. Agenten arbeiten mit den Typen aus catalog_apply/Presets und legen darin Objekte an. | EN: object type, schema, type, definition

Einen bestehenden Objekttyp aendern (Label, Verhalten, Zuordnungen). Betrifft das Modell; bereits angelegte Objekte bleiben, ihre Darstellung kann sich aendern. Nutze es zum Korrigieren eines Typs. Zum Anlegen neuer Objekte dieses Typs onto_object_create. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: object type, schema, type, definition

Einen Objekttyp aus dem Modell entfernen. Pruefe ZUERST, ob noch Objekte dieses Typs existieren (onto_object_index mit Typfilter) — sonst werden sie unerreichbar. Nutze es nur fuer obsolete Typen. Objekte selbst loescht dieses Tool nicht. | EN: object type, schema, type, definition

Die verfuegbaren Objekttyp-Presets auflisten (vorbereitete Typ-Buendel zur Auswahl). Rein lesend. Nutze es als Einstieg, wenn ein Scope mit Standardtypen ausgestattet werden soll. Anwenden: onto_catalog_apply. Inhalt eines Presets: onto_catalog_index. | EN: catalog, preset, template, apply, clear

Takes no parameters.

Den Objekttypen-Katalog lesen (welche Typen in welchen Presets gebuendelt sind). Rein lesend. Nutze es, um zu sehen, was ein Preset enthalten wuerde, BEVOR du es anwendest. Die verfuegbaren Presets listet onto_catalog_presets. | EN: catalog, preset, template, apply, clear

Takes no parameters.

Ein Preset auf einen Scope anwenden und damit dessen Objekttypen anlegen/aendern. Aendert das Modell des Scopes und kann bestehende Typdefinitionen ueberschreiben. Pruefe vorher mit onto_catalog_index, was enthalten ist. Rueckgaengig: onto_catalog_clear. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: catalog, preset, template, apply, clear

Die per Preset angelegten Objekttypen eines Scopes wieder entfernen. Einschneidend — pruefe vorher, ob Objekte dieser Typen existieren (onto_object_index); sonst werden sie unerreichbar. Nutze es zum Zuruecknehmen von onto_catalog_apply. Einzelne Typen entfernst du gezielter mit onto_type_delete. | EN: catalog, preset, template, apply, clear

Alle Link-Definitionen auflisten (welche Beziehungen es zwischen Objekttypen gibt). Rein lesend. Nutze es, um den fuer onto_object_create_link noetigen Link-Typ zu finden. Eine Definition anlegen/aendern: onto_link_create_def / onto_link_update_def. | EN: link, relation, edge, connection, graph

Eine neue Link-Definition anlegen (erlaubt einen Beziehungstyp zwischen zwei Objekttypen). Aendert das Schema — nach dem Anlegen koennen Objekte so verknuepft werden. Nutze es beim Modellaufbau; fuer eine bestehende Definition onto_link_update_def. Loeschen: onto_link_delete_def. | EN: link, relation, edge, connection, graph

Eine bestehende Link-Definition aendern (Name, beteiligte Typen, Regeln). Betrifft das Schema, nicht einzelne Objektkanten. Nutze es zum Korrigieren einer Definition; bestehende Kanten aenderst du mit onto_object_update_link. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: link, relation, edge, connection, graph

Eine Link-Definition entfernen. Entfernt die Beziehungsart aus dem Modell — pruefe vorher, ob noch Kanten darauf zeigen (onto_object_graph). Um nur eine einzelne Kante zu loesen, nimm onto_object_delete_link. | EN: link, relation, edge, connection, graph

Alle Property-Definitionen auflisten (welche Felder ein Objekttyp haben kann). Rein lesend. Nutze es, um den korrekten Feld-key fuer onto_object_set_property zu finden. Anlegen/Aendern: onto_property_def_create / onto_property_def_update. | EN: property, field, schema, property set, definition

Eine neue Property-Definition anlegen (neues Feld im Objektmodell). Aendert das Schema; bestehende Objekte haben das Feld danach leer. Nutze es beim Modellaufbau. Zum Setzen von WERTEN an einem Objekt ist onto_object_set_property zustaendig, nicht dieses Tool. | EN: property, field, schema, property set, definition

Eine bestehende Property-Definition aendern (Label, Typ, Pflicht, Optionen). Betrifft das Modell, nicht die Werte einzelner Objekte. Nutze es zum Korrigieren der Felddefinition; Werte aenderst du mit onto_object_set_property. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: property, field, schema, property set, definition

Eine Property-Definition aus dem Modell entfernen. Pruefe vorher, ob Objekte dieses Feld nutzen — sonst gehen deren Werte verloren. Um nur einen Wert an einem Objekt zu entfernen, nimm onto_object_delete_property. | EN: property, field, schema, property set, definition

Ontologie: onto/property_def/delete_override | EN: property, field, schema, property set, definition

Alle Property-Sets auflisten (Buendel von Properties, die gemeinsam gelten). Rein lesend. Nutze es, um zu sehen, welche Feldgruppen fuer einen Objekttyp definiert sind. Anlegen/Aendern: onto_property_set_create / onto_property_set_update. | EN: property, field, schema, property set, definition

Ein neues Property-Set anlegen (Gruppe von Feldern fuer Objekttypen). Aendert das Modell. Nutze es, um wiederkehrende Feldbuendel einmal zu definieren statt Felder einzeln zuzuweisen. Bestehende Objektwerte aendert es nicht. | EN: property, field, schema, property set, definition

Ein bestehendes Property-Set aendern (enthaltene Felder, Zuordnung, Label). Betrifft das Modell, nicht die Werte einzelner Objekte. Nutze es zum Nachziehen von Feldgruppen; Werte aenderst du mit onto_object_set_property. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: property, field, schema, property set, definition

Ein Property-Set entfernen. Loescht die Gruppierung, NICHT die Objekte oder deren Werte. Pruefe vorher, ob Objekttypen darauf verweisen. Um einzelne Felder aus dem Modell zu entfernen, nimm onto_property_def_delete. | EN: property, field, schema, property set, definition

Alle Scopes auflisten (Bereiche/Mandanten, in denen Objekte liegen und Rechte gelten). Rein lesend. Nutze es, um Scope-IDs fuer Filter oder Zuordnungen zu finden. Mit orphaned=1 siehst du nur Scopes ohne aktiven Verwalter. Suche nach Namen: onto_scope_search. | EN: scope, workspace, area, project, category, image, access

Scopes ueber ihren Namen suchen (Autovervollstaendigung). Rein lesend. Nutze es, wenn du eine Scope-ID brauchst, aber nur den Namen kennst — das ist der Normalfall vor onto_scope_index oder Zuordnungen. Personen zu Scopes suchst du mit onto_scope_search_profiles. | EN: scope, workspace, area, project, category, image, access

Profile (Personen/Konten) suchen, um sie einem Scope zuzuordnen. Rein lesend. Nutze es, wenn du den Profil-Namen fuer onto_scope_assign_profile brauchst. Die Zuordnung selbst schreibt onto_scope_assign_profile. | EN: scope, workspace, area, project, category, image, access

Einen neuen Scope anlegen (neuer Bereich/Mandant) - Verwaltungspfad, ueber MCP Administratoren vorbehalten. Member legen eigene Scopes mit ontouser_scope_create an (in der App ontouser/scope/create); beide Wege rechnen ab. Der Ersteller wird automatisch Verwalter (can_manage_scope=1) - ein Nachtrag per onto_scope_assign_profile ist nicht noetig. Die Anlage kostet Credits (pricing.scope_credit_cost) und zaehlt gegen profiles.max_scopes; Flat-Konten haben keine Obergrenze. Umbenennen/Anpassen: onto_scope_update. | EN: scope, workspace, area, project, category, image, access

Einen bestehenden Scope aendern (Name, Verhalten, Sichtbarkeit). Nutze es zum Umbenennen oder Umschalten von Eigenschaften. Der Scope wird nicht geloescht und Objekte bleiben erhalten. Sichtbarkeit fuer Agenten setzt speziell ontouser_scope_set_visibility. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: scope, workspace, area, project, category, image, access

Einen Scope loeschen. UNWIDERRUFLICH und einschneidend — pruefe ZUERST, welche Objekte darin liegen (onto_object_index mit Scope-Filter) und wer ihn verwaltet. Ist der Scope nur unerwuenscht oeffentlich, nimm stattdessen ontouser_scope_set_visibility. Zum Loesen einzelner Zuordnungen: onto_scope_remove_profile. | EN: scope, workspace, area, project, category, image, access

Ein Profil als Verwalter/Nutzer eines Scopes eintragen (Rechte geben). Schreibt eine Zuordnung. Nutze es, um jemandem Zugriff auf einen Bereich zu geben — finde das Profil vorher mit onto_scope_search_profiles. Zum Entfernen: onto_scope_remove_profile. | EN: scope, workspace, area, project, category, image, access

Ontologie: onto/scope/toggle_scope_flag | EN: scope, workspace, area, project, category, image, access

Die Zuordnung eines Profils zu einem Scope entfernen (Rechte entziehen). Der Scope und die Objekte bleiben bestehen; nur der Zugang entfaellt. Nutze es beim Offboarding. Zum Sperren nach aussen zuerst ontouser_scope_set_visibility pruefen — Oeffentlichkeit ist unabhaengig von Zuordnungen. | EN: scope, workspace, area, project, category, image, access

Die Kategorien der strukturierten Bildablage eines Scopes lesen (welche Bildplaetze es gibt). Rein lesend. Nutze es vor einem Upload, um den korrekten Kategorie-Namen fuer upload_file_to_object (type=structuredimage) zu kennen. Kategorien aendern: onto_scope_save_structuredimage_categories. | EN: scope, workspace, area, project, category, image, access

Die Kategorien der strukturierten Bildablage eines Scopes speichern (anlegen/aendern). Ueberschreibt die Kategorienliste des Scopes. Nutze es beim Einrichten neuer Bildplaetze; anschliessend passen Uploads mit upload_file_to_object darauf. Den Ist-Stand vorher liest onto_scope_structuredimage_categories. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: scope, workspace, area, project, category, image, access

Alle Einstellungen auflisten (Konfigurationswerte, global oder scope-bezogen). Rein lesend. Nutze es, um vorhandene Schluessel und Werte zu finden. Einzelne Werte per Filter: onto_settings_list. Aendern: onto_settings_update (bestehend) oder onto_settings_create (neu). | EN: settings, configuration, option, key value

Einstellungen gezielt nach Schluessel/Scope auflisten. Rein lesend. Nutze es, wenn du einen bestimmten Konfigurationswert suchst statt der ganzen Liste (das ist billiger als onto_settings_index). Einen Wert setzen: onto_settings_update. | EN: settings, configuration, option, key value

Einen NEUEN Einstellungswert anlegen. Nutze es nur, wenn der Schluessel noch nicht existiert — sonst nimm onto_settings_update. Den Ist-Stand zeigt onto_settings_index. Falsch angelegte Eintraege entfernst du mit onto_settings_delete. | EN: settings, configuration, option, key value

Einen BESTEHENDEN Einstellungswert aendern. Nutze es zum Umschalten von Konfiguration. Ist der Schluessel noch nicht vorhanden, schlaegt es fehl — dann onto_settings_create. Einen Wert zu loeschen aendert die Konfiguration dauerhaft: onto_settings_delete. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: settings, configuration, option, key value

Einen Einstellungswert entfernen. Danach gilt wieder der Standard bzw. die global gesetzte Vorgabe. Nutze es zum Zuruecknehmen einer Konfiguration. Zum reinen Aendern des Werts genuegt onto_settings_update. | EN: settings, configuration, option, key value

ALLE Einladungscodes ueber alle Scopes auflisten — nur fuer Administratoren, rein lesend. Zeigt je Code: Scope, Vorlage, Art (scope/management/revoke), Rechte R/W/M, AUSSTELLER, Status, Ablauf, Nutzungen mit Maximum, Label, letzte Aenderung und die Zahl der Einloesungen. Die Filter gehoeren in den JSON-BODY, nicht in die URL: q (Code/Label/Scope, Wildcard *), scope_id, status (active|inactive|expired), kind (scope|management|revoke), sort (modified_datetime|id|code|scope|issuer|expires_at|use_count), dir (asc|desc), page. Anlegen und Zurueckziehen passiert bewusst NICHT hier, sondern beim Scope-Manager (Scope-Verwaltung, Reiter Codes). Einen einzelnen Code samt Einloesungen: onto_invite_code_show. | EN: invite code, invitation, admin, overview, issuer, redemption, audit

Einen einzelnen Einladungscode mit Kopfdaten und ALLEN Einloesungen lesen — nur fuer Administratoren, rein lesend. Kopfdaten: Code, Scope, Vorlage, Art, requires_management, Rechte, Status, Ablauf, Nutzungen/Maximum, Label, Aussteller (Name + E-Mail), letzte Aenderung. Einloesungen: wer (Profil + E-Mail), wann und mit welchen Rechten — die Spur bleibt auch nach einem Zurueckziehen des Codes stehen. Alle Codes findest du mit onto_invite_code_index. | EN: invite code, redemption, who joined, audit, admin

Alle Benutzerkonten auflisten. Rein lesend, nur fuer Administratoren gedacht. Nutze es zur Kontenuebersicht. Ein einzelnes Konto: onto_user_show. Dein EIGENES Profil liest du mit change_profile (ohne Felder) oder onto_user_get. | EN: user, account, profile, role

Ein Benutzerkonto vollstaendig lesen (Rollen, Profil, Status). Rein lesend. Nutze es, wenn du die Konto-ID kennst. Ohne ID: onto_user_index. Dein eigenes Profil liest onto_user_get. | EN: user, account, profile, role

Das EIGENE Benutzerkonto samt Profil und Rollen lesen. Rein lesend. Nutze es, um die eigene Identitaet und Rechte zu pruefen. Fuer fremde Konten (Admin) nimm onto_user_show oder onto_user_index. | EN: user, account, profile, role

Das Profil eines Benutzers aendern (Anzeigename, Kontakt, Organisation). Aendert nur Profildaten, keine Rollen und keine Zugriffsrechte. Fuer das eigene Profil genuegt change_profile. Rollen dagegen aenderst du mit onto_user_update. | EN: user, account, profile, role

Ein Benutzerkonto aendern (Status, Rollen, Kontodaten). Wirkt auf fremde Konten und ist eine Administrativeingabe — mit Rollen aenderst du Zugriffsrechte. Dein EIGENES Profil aenderst du mit onto_user_update_profile oder change_profile. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: user, account, profile, role

Konto vollstaendig loeschen — in EINEM Aufruf. id darf die Konto-ID (users.id) ODER die Profil-ID (profiles.id) sein, alternativ email. Entfernt Zugangsdaten (user_tokens), Passkeys, Sessions, Trackings, Rollen, Scope-Zuordnungen, Favoriten, Idempotenz-Zeilen, eigene Benachrichtigungen, Profil und Konto und prueft danach nach. Die Antwort nennt unter entfernt, was weg ist, und unter behalten, was bewusst bleibt (Buchhaltung, Protokoll, Daten anderer Nutzer). Unwiderruflich. Nicht gefunden heisst 404 mit 'es wurde nichts geloescht' — Erfolg wird nie ohne Gegenprobe gemeldet. | EN: user, account, profile, role, delete

Altname fuer denselben vollstaendigen Weg wie onto_user_delete (id oder email, identisch). Bleibt fuer bestehende Aufrufer erhalten und raeumt NICHT weniger weg. | EN: user, account, profile, delete

Alle Reports auflisten, die fuer dich freigegeben sind. Rein lesend. Nutze es als Einstieg, um die report_id fuer die Ausgabe-Tools zu finden. Die Daten selbst liefern onto_report_show (HTML/Struktur), onto_report_json, onto_report_csv oder onto_report_aggregate. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Einen Report ausfuehren und sein Ergebnis lesen (Standarddarstellung). Rein lesend. Nutze es, um den Inhalt zu sehen. Fuer maschinelle Weiterverarbeitung ist onto_report_json geeigneter, fuer Tabellenexport onto_report_csv, fuer Kennzahlen onto_report_aggregate. Die report_id liefert onto_report_index. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Einen Report als JSON ausfuehren (maschinenlesbare Rohdaten). Rein lesend. Nutze es, wenn du die Ergebnisse weiterverarbeiten willst. Filter uebergibst du als Objekt. Fuer die reine Anzeige genuegt onto_report_show, fuer Tabellen onto_report_csv, fuer Summen onto_report_aggregate. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Einen Report als CSV-Download ausfuehren (Semikolon-getrennt). Rein lesend. Nutze es fuer Exporte und Tabellenkalkulation. Fuer Weiterverarbeitung in Code ist onto_report_json besser, fuer die Anzeige onto_report_show. Die report_id liefert onto_report_index. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Kennzahlen eines Reports berechnen (Summen/Durchschnitte statt Einzelzeilen). Rein lesend. Nutze es, wenn du Zahlen brauchst statt Datensaetze — das ist billiger als die Rohdaten mit onto_report_json zu holen. Karten-Darstellung dagegen: onto_report_map_data. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Die geografischen Daten eines Reports abrufen (Punkte fuer die Kartendarstellung). Rein lesend. Nutze es, wenn der Report Objekte mit Koordinaten enthaelt. Fehlende Koordinaten setzt onto_object_geocode. Kennzahlen statt Karte: onto_report_aggregate. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Einen Report anlegen oder aendern (Definition inkl. SQL, Felder, Rollenfreigabe). Aendert die Reportdefinition, nicht die Quelldaten. Nutze es zum Bauen/Pflegen von Reports. Ausfuehren dann mit onto_report_json/csv/show. Berechtigte Rollen sind Teil der Definition — ohne Freigabe sieht niemand den Report. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Einen bestehenden Report als Kopie anlegen (gleiche Definition, neue ID). Nutze es als Ausgangspunkt fuer eine Variante, statt alles neu zu bauen — die Kopie aenderst du anschliessend mit onto_report_save. Die Vorlage waehlst du anhand von onto_report_index. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Eine Reportdefinition loeschen. Betrifft nur die Definition, NICHT die Quelldaten. Pruefe vorher, ob noch jemand den Report nutzt. Zum reinen Entziehen der Freigabe genuegt onto_report_save mit angepassten Rollen. | EN: report, chart, heatmap, map, dashboard, evaluation, export, statistics

Alle Uebersetzungs-Schluessel auflisten (i18n-Bestand mit Werten je Sprache). Rein lesend. Nutze es fuer einen Ueberblick; fuer gezielte Luecken nimm onto_i18n_missing, fuer die Vollmatrix je Sprache onto_i18n_matrix. Einen Schluessel anlegen/aendern: onto_i18n_create / onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Takes no parameters.

Die Uebersetzungsmatrix lesen: alle Schluessel gegen alle Sprachen mit ihren Werten. Rein lesend, kann gross werden. Nutze es fuer einen vollstaendigen Abgleich. Nur die fehlenden Uebersetzungen zeigt onto_i18n_missing. Werte eintragen: onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Die noch fehlenden Uebersetzungen auflisten (Luecken je Sprache). Rein lesend. Nutze es als Arbeitsliste, bevor du uebersetzt — das ist billiger als die volle Matrix (onto_i18n_matrix). Vorschlaege dazu: onto_i18n_suggestions. Eintragen: onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Takes no parameters.

Einen NEUEN Uebersetzungs-Schluessel anlegen (Schluessel selbst + erste Werte). Nutze es nur, wenn der Schluessel noch nicht existiert — sonst onto_i18n_translate. Den Bestand prueft onto_i18n_index. Schluessel entfernst du mit onto_i18n_delete. | EN: translation, i18n, language, label, locale, export

Den Wert eines BESTEHENDEN Schluessels in einer Sprache setzen oder aendern. Nutze es zum Uebersetzen und Korrigieren. Sprache ist der volle Locale (fr_FR, it_IT, en_US), NICHT der Kurzcode. Fehlt der Schluessel, leg ihn zuerst mit onto_i18n_create an. Pruefen/freigeben: onto_i18n_review. | EN: translation, i18n, language, label, locale, export

Uebersetzungs-VORSCHLAEGE fuer fehlende Schluessel abrufen. Rein lesend. Nutze es, wenn du nicht selbst formulieren willst. Was ueberhaupt fehlt, zeigt onto_i18n_missing. Vorschlaege sind nicht verbindlich — gespeichert wird mit onto_i18n_translate, freigegeben mit onto_i18n_review. | EN: translation, i18n, language, label, locale, export

Eine Uebersetzung pruefen und freigeben (Review-Status setzen). Aendert den Status, nicht den Text. Nutze es als Abschluss nach onto_i18n_translate. Was ueberhaupt fehlt, zeigt onto_i18n_missing. Zur Auslieferung an die Anwendung: onto_i18n_export. | EN: translation, i18n, language, label, locale, export

Einen Uebersetzungs-Schluessel samt seiner Werte loeschen. Unwiderruflich. Pruefe vorher, ob der Schluessel in der Anwendung verwendet wird — sonst zeigt die Oberflaeche den Rohschluessel statt Text. Nur einen einzelnen Wert aendern: onto_i18n_translate. | EN: translation, i18n, language, label, locale, export

Die Uebersetzungen als Export ausgeben (Auslieferungsformat fuer die Anwendung). Rein lesend fuer das System, erzeugt aber eine Ausgabe mit Seiteneffekt in der Pipeline. Nutze es nach dem Review (onto_i18n_review) — nicht uebersetzte Werte fehlen dann im Export. Den Bestand prueft onto_i18n_matrix. | EN: translation, i18n, language, label, locale, export

Takes no parameters.

Die eigenen Favoriten auflisten (gemerkte Objekte des angemeldeten Kontos). Rein lesend. Nutze es, um schnell auf haeufig gebrauchte Objekte zuzugreifen. Ein Objekt merken: onto_favorite_add; entfernen: onto_favorite_delete. Alle Objekte (nicht nur Favoriten) zeigt onto_object_index. | EN: favorite, bookmark, quick access

Takes no parameters.

Ein Objekt zu den eigenen Favoriten hinzufuegen (merken). Wirkt nur auf das eigene Konto und aendert keine Objektdaten. Nutze es fuer haeufig gebrauchte Objekte. Jeder Aufruf legt einen NEUEN Eintrag an — auch bei gleicher URL, weil der aktuelle Filter mitgespeichert wird. Mehrfaches Aufrufen mit gleichen Argumenten erzeugt also Duplikate; vorher mit onto_favorite_index pruefen. Entfernen: onto_favorite_delete. | EN: favorite, bookmark, quick access

Favoriten-Status eines Objekts umschalten (merken <-> nicht gemerkt). Wirkt nur auf das eigene Konto. Achtung: Nebenwirkung — ist die URL schon Favorit, wird der Eintrag GELOESCHT, sonst angelegt. Ein zweiter Aufruf mit gleicher URL macht den ersten rueckgaengig. Nutze es, wenn du den Ausgangszustand nicht kennst — du brauchst dann kein Vorab-Lesen. Gezielt merken: onto_favorite_add, gezielt entfernen: onto_favorite_delete. | EN: favorite, bookmark, quick access

Ein Objekt aus den eigenen Favoriten entfernen. Loescht NUR die Merkung, nicht das Objekt selbst — das bleibt unberuehrt. Wirkt nur auf das eigene Konto. Das Objekt selbst loeschst du mit onto_object_delete. | EN: favorite, bookmark, quick access

Teamweite Startkarten auflisten, die DU pflegen darfst. Liefert startcards (id, scope_id, title, url, name, sort_order), die waehlbaren interfaces (name, label, scope_id) und die scopes (id->Name). Eine Startkarte erscheint auf /ontouser in einem EIGENEN Panel 'Startkarten fürs Team' (getrennt von den persoenlichen Favoriten) bei allen, die den Scope lesen duerfen. Rollen gibt es bewusst NICHT: eine Startkarte gilt fuer alle im Scope; wer differenzieren will, baut eine Ansicht mit eigenem access-Gate. Unterschied zu onto_favorite_*: Favoriten sind persoenlich, Startkarten sind Team-Konfiguration. | EN: start cards, dashboard, team

Takes no parameters.

Startkarte anlegen (id weglassen) oder aendern (id setzen). scope_id und iface sind Pflicht; iface muss eine Ansicht aus onto_startcard_index.interfaces sein, die im GLEICHEN Scope liegt (sonst 400) — so kann niemand fremde Ansichten in seinen Scope ziehen. title leer = Anzeigename der Ansicht. KEIN roles-Parameter: Startkarten gelten fuer alle im Scope. Rueckgabe: saved (id) und karte (zurueckgelesene Zeile). Recht: can_manage_scope auf scope_id (Admin ausgenommen, wie in /onto/scope). | EN: start card, save, team card

Startkarte loeschen (exakte id aus onto_startcard_index). Wirkung: die Karte verschwindet bei allen im Team von /ontouser. Recht: can_manage_scope auf dem Scope der Karte. Kein Papierkorb. | EN: start card, delete

Reihenfolge der Startkarten innerhalb ihres Scopes aendern: id + dir=up|down tauscht den Platz mit dem Nachbarn. Die Reihenfolge gilt fuer alle im Team; Nutzer koennen sie nicht selbst aendern (anders als persoenliche Favoriten). | EN: start card, order, reorder

Das Aktionsprotokoll lesen (wer hat wann welche Aktion ausgefuehrt). Rein lesend, in der Regel nur fuer Administratoren. Nutze es zur Nachvollziehbarkeit von Aenderungen und Fehlern. Die ausfuehrbaren Aktionen selbst zeigt onto_actiondef_list. | EN: audit, log, activity, history, trace

Eine Datei aus der strukturierten Ablage abrufen (Metadaten und/oder Inhalt). Rein lesend. Nutze es, wenn du die Datei ueber ihre Kennung kennst. Einen Upload machst du mit upload_file_to_object; die Kategorien der Ablage zeigt onto_scope_structuredimage_categories. | EN: file, image, document, attachment, upload

Eine Datei aus der strukturierten Ablage loeschen. Unwiderruflich — pruefe vorher, ob Objekte darauf verweisen. Der Datensatz des Objekts bleibt bestehen, nur die Datei entfaellt. Zum Ersetzen einfach erneut hochladen (upload_file_to_object). | EN: file, image, document, attachment, upload

Alle Importquellen auflisten (definierte Datenimporte fuer Massendaten). Rein lesend. Nutze es als Einstieg, um eine vorhandene Quelle zu finden. Die Verarbeitungsschritte einer Quelle zeigt onto_import_steps; eine neue Quelle legst du mit onto_import_create_source an. | EN: import, data load, staging, CSV, source, pipeline

Takes no parameters.

Aktive Importquellen auflisten (Alternative zur vollen Liste). Rein lesend. Nutze es, wenn du nur die einsatzbereiten Quellen brauchst. Schritte einer Quelle: onto_import_steps. Analyse starten: onto_import_analyze. | EN: import, data load, staging, CSV, source, pipeline

Die Verarbeitungsschritte einer Importquelle auflisten (Pipeline des Imports). Rein lesend. Nutze es, um zu sehen, welche Schritte definiert sind und was als naechstes laeuft. Den Status eines einzelnen Schritts zeigt onto_import_step_status. Einen Schritt ausfuehren: onto_import_run_step. | EN: import, data load, staging, CSV, source, pipeline

Den aktuellen Status eines einzelnen Import-Schritts lesen (laeuft/fertig/Fehler). Rein lesend. Nutze es zum Nachfassen NACH onto_import_run_step, statt den Lauf zu wiederholen. Die Schrittliste liefert onto_import_steps; einen laufenden Schritt brichst du mit onto_import_step_cancel ab. | EN: import, data load, staging, CSV, source, pipeline

Einen Import-Schritt ausfuehren (SQL, Check oder Python). Aendert Daten — vorher onto_import_steps lesen. Enthaelt der Schritt den Platzhalter {{file_udid}}, MUSS file_udid mitgegeben werden: die udid des file-Objekts, das gelesen werden soll. Ohne gueltige udid bricht der Lauf ab, statt irgendeine Datei zu lesen. Die udid liefert der Auftraggeber; der Kunde sieht sie ueber ontouser_object_show am Elternobjekt (Feld files[].udid). Ein Python-Schritt erhaelt die Verbindungen der Anbindungen ueber tscred (credential, targets, info); die Datei mit den Klartextwerten wird nach dem ersten Lesen geloescht. Der Bericht nennt unter 'zugangsdaten', wie viele Verbindungen uebergeben wurden. | EN: import, data load, staging, CSV, source, pipeline

Einen laufenden Import-Schritt abbrechen. Bereits geschriebene Datensaetze bleiben bestehen — der Abbruch ist kein Rollback. Nutze es bei Fehlkonfiguration, statt den Lauf durchlaufen zu lassen. Status vor/nach: onto_import_step_status. | EN: import, data load, staging, CSV, source, pipeline

Eine NEUE Importquelle anlegen (Verbindung/Datei fuer Massendatenimport). Nutze es beim Einrichten eines neuen Imports. Eine bestehende Quelle aenderst du mit onto_import_update_source. Schritte hinzufuegen: onto_import_save_step. Vorhandene Quellen: onto_import_sources. | EN: import, data load, staging, CSV, source, pipeline

Einen Import-Schritt anlegen oder aendern (Bestandteil der Importpipeline). Aendert die Definition, fuehrt nichts aus. Nutze es beim Aufbau einer Quelle. Ausfuehren dann mit onto_import_run_step; entfernen mit onto_import_delete_step. Der bisherige Wert ist danach weg (keine Historie, kein Undo). In einem Python-Schritt stehen die Verbindungen der Anbindungen als Modul tscred bereit: from tscred import credential, targets, info — credential('ziel') liefert das entschluesselte Geheimnis, targets() die verfuegbaren Ziele. Geheimnisse nie ausgeben oder protokollieren, nur Laengen oder Statuscodes. Mehrdeutige Ziele (gleicher Name an mehreren Profilen) werden bewusst nicht durchgereicht. | EN: import, data load, staging, CSV, source, pipeline

Einen Import-Schritt aus der Pipeline entfernen. Betrifft nur die Definition — bereits importierte Daten bleiben. Nutze es beim Umbau einer Quelle. Die verbleibenden Schritte zeigt onto_import_steps. | EN: import, data load, staging, CSV, source, pipeline

Reihenfolge der Verarbeitungsschritte einer Quelle neu setzen. Uebergib ALLE Step-IDs der Quelle in der gewuenschten Reihenfolge; step_no wird 1..N neu vergeben. Nur Steps dieser Quelle werden akzeptiert. Nutze onto_import_steps, um die aktuellen IDs zu holen. | EN: import, data load, staging, CSV, source, pipeline

Eine Analyse des Quelldatenbestands starten (Struktur/Vorschau vor dem Import). Ruft die Analyse auf und liefert die analysierte Struktur. Nutze es VOR onto_import_run_step, um Feldzuordnungen zu pruefen. Bereits vorhandene Analyseergebnisse eines Schritts: onto_import_analyze_step. | EN: import, data load, staging, CSV, source, pipeline

Das Ergebnis der Analyse fuer einen bestimmten Schritt abrufen. Rein lesend. Nutze es, um eine mit onto_import_analyze gestartete Analyse auszuwerten. Den Lauf startest du dann mit onto_import_run_step. | EN: import, data load, staging, CSV, source, pipeline

Eine bestehende Importquelle aendern (Verbindungsparameter, Bezeichnung, Aktivierung). Nutze es zum Korrigieren oder Umstellen einer Quelle. Eine neue Quelle legst du mit onto_import_create_source an. Entfernen: onto_import_delete_source — pruefe vorher die Schritte. Der bisherige Wert ist danach weg (keine Historie, kein Undo). | EN: import, data load, staging, CSV, source, pipeline

Eine Importquelle samt ihrer Schritte entfernen. Pruefe ZUERST mit onto_import_steps, was daran haengt — geloeschte Schritte sind nicht wiederherstellbar. Nutze es beim Stilllegen obsoleter Importe. Zum reinen Deaktivieren genuegt onto_import_update_source. | EN: import, data load, staging, CSV, source, pipeline

Liste aller Formulare (formdefs), die fuer dich sichtbar sind - mit udid, Titel, Feld-Anzahl und je Feld key/label/widget/required. ERSTER SCHRITT, um fachlich das passende Formular zu waehlen: hier siehst du, welche Formulare es gibt und welche Felder sie haben. Die udid nimmst du fuer show_formdef. Sichtbar sind nur Formulare in deinen Scopes (fail-closed). | EN: list, formdefs

Takes no parameters.

Ein Formular (formdef) VOLLSTAENDIG lesen: alle Felder mit key/label/widget/required, Auswahl-Optionen (options), Validierungsregeln (validation: pattern+message) und Bedingungen (condition), Subform-Felder. Ausserdem die konfigurierten Buttons unter formdef.buttons[] (z.B. type='send' mit label 'Abschliessen' — diesen Index brauchst du beim Absenden als action='button:<index>'). Nimm die udid aus list_formdefs. Damit pruefst du, ob ein Formular fachlich passt, bevor du eine Action daran bindest. SQL-Interna sind bewusst NICHT enthalten. | EN: show, formdef

Formular-ENTWURF anlegen (Status 'draft') und dessen Antwort-udid erhalten. Nimm die form_udid aus list_formdefs. WICHTIG: hiermit werden noch KEINE Werte gesetzt - der Entwurf ist leer. Werte setzt du danach mit submit_form_answer. Ergebnis: Feld 'udid' = Antwort-udid (brauchst du fuer submit_form_answer und show_form_answer). Der Entwurf liegt im Schreib-Scope des Agenten (SSR-Kaskade). | EN: form answer, submission, response, prepare, submit

Formular-Antwort SPEICHERN oder ABSENDEN. form_udid aus list_formdefs, answer_udid aus prepare_form_answer. OHNE answer_udid wird eine NEUE Antwort angelegt. 'values' = {feld-key: wert}, Keys aus show_formdef, Werte muessen die Feldregeln erfuellen (Select: nur erlaubte Optionswerte). SUBFORM/EINZELPOSTEN: ein Subform-Feld bekommt eine LISTE von Zeilen-Objekten, z.B. {"materialverbraucht": [{"material": "Bettlaken", "quantity": "1", "unit": "Stk"}, {...}]} — die Feld-Keys der Zeilen stehen im subform.fields der formdef (show_formdef). Skalare Felder bleiben einfach. 'status': 'draft' (speichern) oder 'sent' (absenden; committet in den target_scope der Action). VERHALTEN DER VALIDIERUNG: jeder Regelverstoss bricht mit HTTP 400 ab und liefert die Fehler je Feld ({errors:[{key,msg}]}) - es wird dann NICHTS gespeichert. Genau damit testest du ein Formular fachlich durch: gueltige Werte senden und pruefen, ob sie ankommen; ungueltige Werte senden und pruefen, ob die Regeln greifen. Eine einmal mit 'sent' abgesendete Antwort ist gesperrt (erneutes Absenden legt eine neue Antwort an).

Findet die form_udid zu einer bekannten answer_udid (ueber den usesForm-Link der Antwort). Brauchst du NUR, wenn du eine answer_udid hast, aber die zugehoerige form_udid nicht kennst — danach show_form_answer(form_udid, answer_udid) normal aufrufen. Hast du form_udid bereits (z.B. aus prepare_form_answer/submit_form_answer), brauchst du diesen Schritt nicht. | EN: form answer, submission, response, prepare, submit

Eine gespeicherte Formular-Antwort ANSEHEN: alle gespeicherten Werte als JSON (values = {feld-key: wert}). EINZELPOSTEN/SUBFORM: subforms = {objekttyp: [{udid, name, values:{feld:wert}}]} — die Zeilen des Unterformulars MIT ihren Werten (bei PflegeBesuch z.B. material/quantity/unit), direkt in dieser Antwort enthalten (kein Extra-Call noetig). Die Feld-Keys kommen aus der formdef (show_formdef, subform.fields), sie sind NICHT fest verdrahtet — jedes Formular hat eigene. Leeres/fehlendes subforms = keine Einzelposten gespeichert. DATEIEN: files[] enthaelt pro Datei form_field (welchem Formularfeld sie zugeordnet ist, z.B. 'fotos' vs 'fotosnachher') — so unterscheidest du mehrere Bilder/Signaturen ohne Zusatz-Call. form_udid aus list_formdefs/prepare_form_answer/submit_form_answer (oder resolve_form_answer, falls nur answer_udid bekannt), answer_udid aus prepare_form_answer/submit_form_answer. Damit pruefst du nach dem Ausfuellen, ob deine Werte wirklich angekommen sind.

VORLAGEN auflisten: sichtbare Formulare im PUBLIC-Scope (generische Vorlagen). Rein lesend. Nutze die udid mit onto_formdef_create + from_udid, um eine firmenspezifische Kopie zu bauen, oder onto_formdef_show zum vollstaendigen Ansehen. Vorlagen (PUBLIC-Scope) sind der einfachste Weg an eine funktionierende Vorlage samt buttons/template_file. | EN: form, form definition, fields, template, PDF, submission

NEUES Formular anlegen. Legt das form-Objekt an und schreibt eine minimale gueltige Definition (1 Feld), die du danach mit onto_formdef_save ausbaust. MIT from_udid wird die Definition einer Vorlage kopiert (dann werden Felder uebernommen, Sichtbarkeit auf den Ziel-Scope gestellt und adminsql entfernt, falls du kein Admin bist). Ein so kopiertes Formular bringt auch dessen buttons/template_file mit — nach dem Kopieren mit onto_formdef_save pruefen. Rechte: form_writer/admin + Schreibzugriff auf den Scope — sonst 403. | EN: form, form definition, fields, template, PDF, submission

Die nutzbaren Action-Definitionen auflisten (welche Buttons an welchen Objekten erscheinen). Rein lesend. Nutze es, wenn du wissen willst, welche Aktion du auf einem Objekt ausfuehren kannst — den key uebergibst du an onto_object_execute_action. Anlegen/Aendern: onto_actiondef_save. | EN: action, button, definition, gate, condition, rule

Actiondef anlegen/aendern (Button am Objekt). PFLICHT: body.scopes mit den Scope-IDs, an denen der Button erscheinen soll — du musst dort Manager (can_manage_scope) oder Schreiber (can_write) sein, sonst 403. PUBLIC (15) nur fuer Admins. Beispiel fuer 'Formular am Standort ausfuellen': body = {"object_types":["building"],"scopes":[7],"roles":["member"],"action":{"type":"form_answer","name":"Visite","form":"<formdef-udid>"}}. action.type 'form_answer' oeffnet das Formular und verknuepft die Antwort mit dem Objekt. Actions sind SCOPE-Daten, nicht global. Sehen darf sie, wer einen der Scopes in body.scopes[] lesen darf; AUSFUEHREN nur, wenn das Scope des Objekts in body.scopes[] steht (oder die Def public:true traegt). Ein Mitglied mit can_manage_scope auf SEINEM Scope darf dort eigene Actions anlegen (Kopie der Plattform-Action mit body.scopes=[eigener Scope]) und so die Standard-Actions im eigenen Scope nutzbar machen. Beim Anlegen genau EIN Ziel-Scope. public:true und der PUBLIC-Scope 15 sind Administratoren vorbehalten, SQL-Bedingungen ebenfalls. Ein Scope-Manager kann Actions in seinem Scope per hidden_actions abschalten. | EN: action, button, definition, gate, condition, rule action.result_scope_id (Ergebnis-Scope): bei 'create'/'form_answer' bestimmt er, WO das neue Objekt entsteht. Bei 'update' ist er die BRUECKE: die Aktion darf ein BESTEHENDES Objekt in diesem Scope fortschreiben, auch wenn der Ausfuehrende dort NUR Leserecht hat — schreibbar sind genau die Eigenschaften aus action.props, nur am Zielobjekt der Aktion; danach ist die Bruecke zu (andere Felder 403). Pflicht: Personenbindung ({current_user_email}, {current_profile_id}, {current_user_id}, {user_email} oder {user_person}); bei 'update' zusaetzlich action.props, sonst 400. Merksatz: ein Mitarbeiter braucht KEIN Schreibrecht im Planungs-Scope — Aktion im Planungs-Scope definieren, result_scope_id setzen, Eigenschaften in action.props auflisten. Beispiel Einstempeln: object_types [shift], scopes [80,

Actiondef loeschen (Button entfernen). Rechte: Scope-Manager/Schreiber (can_manage_scope/can_write). | EN: action, button, definition, gate, condition, rule

Formular-DEFINITION speichern (der EINZIGE Schreibweg fuer formdef). Pflichtfelder: version (int>=1), title, answer_type (muss existierender Objekttyp sein, z.B. 'inspection'), fields (nicht-leer). Jedes Feld: key (Buchstabe am Anfang, a-zA-Z0-9_), widget, label; optional required, options (bei select), source (bei picker), validation. Widgets: text, textarea, int, float, select, picker, switch, slider, datepicker, file, label, subform, images, documents, signature. Reservierte Keys: formdef, usesForm, performs, udid, name, external_id. adminsql/sql/sqlparameters nur als Admin. Rechte: form_writer/admin + Schreibzugriff auf den Scope. Mit 'name'/'scope_id' werden auch die Stammdaten gesetzt. ACHTUNG: buttons/template_file/template_filename sind KEINE eigenen Parameter, sondern Felder INNERHALB des formdef-JSON (buttons/template_file/template_filename). BUTTONS: formdef.buttons=[{type,label,...}]; erlaubte type-Werte: 'save' (nur speichern), 'saveandgoto' (+url: Weiterleitung), 'send' (Mailversand mit PDF-Anhang; PFLICHT to[]; optional cc[], bcc[], subject; '$currentuseremail' wird durch die Adresse des Ausfuellenden ersetzt). Empfaenger kommen IMMER aus der formdef, nie aus dem POST. PDF-VORLAGE aus Excel: formdef.template_file = file_udid als 32-hex aus upload_file_to_object (NICHT bin2hex!) und formdef.template_filename = Dateiname — beide parallel setzen. Die Auswahl per Dateiname ueberlebt einen Neu-Upload gleichen Namens. PLATZHALTER im Excel: ##feldkey## (doppeltes Hash; ## key ## mit Leerzeichen geht auch) — {feldkey} oder %%feldkey%% funktionieren NICHT. Subform-Felder fuellen zeilenweise den naechsten freien Platzhalter (das Excel bestimmt die Maximalzahl, ueberzaehlige Zeilen werden verworfen); Bildfelder/signature werden Bildanker. | EN: form, form definition, fields, template, PDF, submission

Ein einzelnes Objekt ueber seine udid im Self-Service-Kontext lesen. Rein lesend und fail-closed (nur Objekte deiner Scopes). Inhaltlich identisch zu onto_object_show — nimm dieses, wenn du als Scope-Nutzer (nicht als Administrator) arbeitest. Ohne udid: ontouser_scope_index, dann die Objektliste. | EN: end user, customer, portal, notification, map, scope

Ein einzelnes Interface im Self-Service-Kontext lesen (Sicht mit ihren Feldern). Rein lesend. Inhaltlich identisch zu onto_interface_show — nimm dieses, wenn du als Scope-Nutzer arbeitest. Alle Interfaces (Admin) listet onto_interface_index. | EN: end user, customer, portal, notification, map, scope

Die Kartenmarker eines Interfaces im Self-Service-Kontext abrufen (Objekte mit Koordinaten fuer die Karte). Rein lesend. Inhaltlich identisch zu onto_interface_map_markers — nimm dieses als Scope-Nutzer. Fehlende Koordinaten setzt ein Administrator mit onto_object_geocode. | EN: end user, customer, portal, notification, map, scope

Eine Anfrage an einen fremden Scope-Anbieter stellen (Service anfordern). Erzeugt eine Anfrage bzw. einen Auftrag und kann Credits kosten. Nutze es, wenn du eine Leistung aus einem oeffentlichen Scope brauchst, aber keine direkte Buchung moeglich ist — die verfuegbaren Scopes zeigt ontouser_scope_list_public. Direkte Buchung mit Rechten: ontouser_scope_assign_public. Auch der Weg, um Startguthaben zu bitten: beschreibe dein Vorhaben, den Zweck, den benoetigten Scope und das erwartete Guthaben — der Betreiber prueft von Hand und entscheidet frei. Ein Anspruch besteht nicht. Auch der Weg fuer alles, was nur ein Administrator freigeben kann: oeffentliche Sichtbarkeit eines Scopes (PUBLIC) und zusaetzliches Guthaben (Prepaid-Code). | EN: end user, customer, portal, notification, map, scope

Die eigenen Benachrichtigungen auflisten (Meldungen des angemeldeten Kontos). Rein lesend. Nutze es als Einstieg, um neue Meldungen zu finden. Eine einzelne Meldung als gelesen markieren: ontouser_notification_read. Fuer Systemprotokolle (Admin) ist onto_action_logs zustaendig. | EN: end user, customer, portal, notification, map, scope

Takes no parameters.

Eine eigene Notification loeschen (nur gesendete oder empfangene des eigenen Kontos), einzeln je id. Fuer das Aufraeumen des Postfachs. | EN: notification, delete, inbox cleanup

Einem anderen Nutzer eine Notification schreiben (User-zu-User, handler 'user_message'). to ist die Empfaenger-E-Mail eines existierenden Nutzers, text die Nachricht (max. 4000 Zeichen). Der Empfaenger liest sie mit ontouser_notification_index. Die eigene Adresse ist erlaubt. Kein Trockenlauf — die Meldung geht sofort raus; Push und E-Mail an Agentenadressen bewusst nicht. | EN: notification, message, user, send, notify

Deinen eigenen Notification-Webhook anzeigen (url, active, secret_gesetzt). Der Schluessel selbst wird nie ausgegeben. | EN: webhook, notification, push, agent wakeup

Takes no parameters.

Notification-Webhook einrichten: Telesherpa schickt jede neue Notification zusaetzlich als HTTP-POST an url (JSON mit event/id/from/to/text/handler/url/sent_at). Der Schluessel geht standardmaessig in BEIDEN Formen mit: X-Telesherpa-Secret und Authorization: Bearer (auth='header' oder 'bearer' schraenkt das ein). signature=1 ergaenzt X-Webhook-Signature (HMAC des Bodys), signature=2 die replay-sichere Variante mit X-Webhook-Timestamp und X-Webhook-Signature-V2. Ein mitgegebenes secret ERSETZT das bestehende; ohne secret bleibt es unveraendert. Ersetzt das Pollen. | EN: webhook, subscribe, notifications, agent, hmac

Notification-Webhook entfernen. Danach nur noch Push, Mail und ontouser_notification_index. | EN: webhook, unsubscribe, delete

Takes no parameters.

Test-POST an den eigenen Webhook schicken (kein echtes Ereignis). Zeigt sofort, ob die Adresse antwortet und der Schluessel ankommt. | EN: webhook, test, smoke test

Takes no parameters.

Eine Benachrichtigung als gelesen markieren. Aendert nur den Lesestatus, nicht den Inhalt und loescht nichts. Nutze es nach ontouser_notification_index. Die Meldung selbst bleibt abrufbar. | EN: end user, customer, portal, notification, map, scope

Die eigenen Scopes auflisten (Bereiche, auf die dein Konto Zugriff hat). Rein lesend und fail-closed: du siehst nur deine Zuordnungen. Nutze es als Einstieg im Self-Service, um deine Scope-IDs zu finden. Oeffentlich buchbare fremde Scopes zeigt ontouser_scope_list_public. | EN: end user, customer, portal, notification, map, scope

Takes no parameters.

Die Objekttypen eines eigenen Scopes mit Anzahl Objekten und dem Kennzeichen, ob der Typ aktiviert ist. Rein lesend. Die Auswahl ist eine Bedienhilfe (Vorschlagsliste im Objekt-Dialog), keine Zugriffskontrolle — Rechte regelt weiterhin der Scope. Aendern mit ontouser_scope_types_set. Braucht can_manage_scope auf dem Scope. | EN: scope, object type, settings, enable, list, admin

Die aktivierten Objekttypen eines eigenen Scopes setzen: die uebergebene Liste ersetzt die bisherige Auswahl — vorher mit ontouser_scope_types lesen. Ein Typ, zu dem es im Scope noch Objekte gibt, laesst sich nicht entfernen; die Fehlermeldung nennt Typen und Zaehler. Braucht can_manage_scope. | EN: scope, object type, settings, enable, update, admin

Einen eigenen Scope anlegen (Self-Service, ohne Administrator). Du wirst Owner des neuen Scopes und kannst ihn verwalten. Nutze es, um eigene Datenbereiche zu beginnen. Verfuegbarkeit fuer andere steuerst du mit ontouser_scope_set_visibility; buchen lassen mit ontouser_scope_assign_public. | EN: end user, customer, portal, notification, map, scope Loeschen ist Verwaltungssache: einen eigenen Scope kann man nicht selbst entfernen (es gibt keinen ontouser-Weg) — ein Administrator loescht ihn.

Oeffentlich buchbare Scopes anderer Anbieter auflisten. Rein lesend. Nutze es, um zu sehen, welche fremden Bereiche du buchen koenntest (das ist der Verdienst-Weg des Owners). Buchen/Auftrag stellen: ontouser_service_request. Deine eigenen Scopes zeigt ontouser_scope_index. | EN: end user, customer, portal, notification, map, scope

Takes no parameters.

Einem anderen Konto Zugriff auf einen oeffentlichen Scope geben (buchen). Schreibt eine Zuordnung und kann Credits kosten — vorher onto_credit_pricing pruefen. Nutze es, um einen fremden oeffentlichen Scope zu nutzen. Den Zugang wieder entziehen: ontouser_scope_remove_public. Verfuegbare Scopes zeigt ontouser_scope_list_public. | EN: end user, customer, portal, notification, map, scope

Die eigene Zuordnung zu einem oeffentlichen fremden Scope wieder entfernen. Beendet den Zugang; bereits erzeugte Daten im fremden Scope bleiben dort. Nutze es, wenn du einen gebuchten Scope nicht mehr brauchst. Zum Sperren deines EIGENEN Scopes nimm ontouser_scope_set_visibility. | EN: end user, customer, portal, notification, map, scope

Die Sichtbarkeit eines EIGENEN Scopes setzen (privat <-> oeffentlich buchbar). Oeffentlich machen heisst: andere koennen den Scope buchen und du verdienst daran (Credits). Nur der Owner darf das. Nutze es, um einen Scope anzubieten oder wieder privat zu stellen. Das Buchen selbst loest ontouser_service_request aus. Oeffentlich (PUBLIC) setzt seit 2026-10-12 NUR ein Administrator — der oeffentliche Katalog ist kuratiert. Als Owner darfst du privat halten oder auf einzelne eigene Scopes beschraenken; willst du oeffentlich, schreib einen Service Request (ontouser_service_request) mit Begruendung. | EN: end user, customer, portal, notification, map, scope

Die eigenen Einladungscodes auflisten (wer wurde eingeladen, ist der Code noch gueltig). Rein lesend. Nutze es, um den Code fuer die Weitergabe oder zum Widerrufen zu finden. Neuen Code anlegen: create_invite_code. Ungueltig machen: revoke_invite_code. Die E-Mail-Allowlist eines Codes zeigt list_code_allowlist. | EN: invitation, invite, voucher, code, bundle

Einen Einladungscode anlegen, mit dem sich neue Mitglieder selbst registrieren koennen. Der Code steuert, welchen Zugang der Beitragende erhaelt. Nutze es zum Anwerben von Mitgliedern/Subunternehmern. Den Code weitergeben (nicht hier ablegen) und mit list_invite_codes verwalten; ungueltig machen: revoke_invite_code. Weg (b) nach der Registrierung: nach dem eigenen Aufbau Menschen und andere Agenten in deinen Scope einladen. Die Einladung geht in beide Richtungen | EN: invitation, invite, voucher, code, bundle

Einen Einladungscode ungueltig machen (keine neuen Registrierungen mehr darueber). Bereits registrierte Mitglieder bleiben bestehen — nur der Code verfaellt. Nutze es bei abgelaufenen oder missbraeuchten Codes. Den Code findest du mit list_invite_codes. | EN: invitation, invite, voucher, code, bundle

Die E-Mail-Allowlist eines Einladungscodes lesen (welche Adressen/Muster zugelassen sind). Rein lesend. Nutze es als Ist-Stand vor Aenderungen. Einzelne Eintraege ergaenzen/entfernen: add_code_allowlist_entry / delete_code_allowlist_entry. Massen-Upload per Excel: upload_code_allowlist. | EN: allowlist, permission, whitelist, code

Eine einzelne E-Mail-Adresse oder ein Adressmuster zur Allowlist eines Codes hinzufuegen. Ergaenzt bestehende Eintraege (loescht nichts). Nutze es fuer einzelne Nachzuegler; fuer viele Adressen ist der Excel-Upload upload_code_allowlist der richtige Weg. Entfernen: delete_code_allowlist_entry. | EN: allowlist, permission, whitelist, code

Einen Eintrag aus der Allowlist eines Codes entfernen. Betrifft nur die Zulassung — bereits registrierte Konten bleiben bestehen. Nutze es, um einzelne Adressen zu sperren. Bulk-Ersetzung der ganzen Liste: upload_code_allowlist. | EN: allowlist, permission, whitelist, code

Einen Einladungscode einloesen (Zugang ueber eine Einladung erhalten). Schreibt die Mitgliedschaft und ist der Selbstregistrierungs-Weg ohne Administrator. Nutze es, wenn du einen Code erhalten hast. Der Code muss gueltig sein — der Aussteller verwaltet ihn mit list_invite_codes. Alle Fehlerfaelle (unbekannt, abgelaufen, verbraucht, Adresse nicht freigegeben) antworten gleich mit 400 und demselben Text; nach 10 Fehlversuchen je Konto und IP in einer Stunde kommt 429 — dann warten, nicht wiederholen. Weg (a) nach der Registrierung: mit dem Code in einen fremden Scope eintreten. | EN: invitation, invite, voucher, code, bundle

Die Konten auflisten, die DU fuehrst (verwaltete Konten deines Scopes) — rein lesend. Ein Konto ist verwaltet, wenn es das Kennzeichen managed_by_scope_id traegt; das Kennzeichen allein gibt KEINE Rechte, jede Aktion prueft zusaetzlich can_manage_scope und das jeweilige Recht. Dein eigenes Konto erscheint nie in dieser Liste. Ohne scope_id: alle Scopes, die du verwaltest. Einstieg fuer alle weiteren team-Werkzeuge — die profile_id stammt IMMER aus dieser Liste, nie geraten. | EN: managed accounts, my team, sub-agents, company manager

Ein verwaltetes Konto sperren: die Rolle member wird entzogen und ALLE Token geloescht. Der Token-Endpunkt antwortet danach 403 account_suspended — das Konto sieht den Grund, statt ein kaputtes Login zu vermuten. Admin-Konten sind ausgenommen, Selbstsperre ist unmoeglich. Es wird KEINE Nachricht verschickt — formuliere sie selbst. Umkehr: ontouser_team_unsuspend. | EN: suspend, block, cut off, revoke tokens

Die Sperre eines verwalteten Kontos aufheben: die Rolle member kommt zurueck, das Konto meldet sich mit seinem bestehenden Passwort wieder an. | EN: unsuspend, unblock, restore access

Stammdaten eines verwalteten Kontos aendern: displayname, organisation, phone, notes. Die E-Mail ist unveraenderlich und gehoert nicht zu diesem Werkzeug. Passwort setzen kann ein Manager bewusst NICHT — Wiederherstellung laeuft ueber das Konto selbst. | EN: update managed account, profile data, rename

Die Rechte eines verwalteten Kontos in EINEM Scope setzen — nicht nur hochstufen, sondern auch entziehen. can_read, can_write, can_manage_scope je 0/1; sind alle drei 0, wird die Mitgliedschaft entfernt. can_manage_scope auf dem fuehrenden Scope selbst wird mit 403 abgelehnt (kein Hochklettern in der Kette) — dafuer gibt es Einladungscodes mit kind=management. Wird can_write entzogen, faellt default_write_scope mit weg. | EN: grant, revoke, rights, membership

Das Standard-Schreibziel eines verwalteten Kontos setzen (scope_id, 0 = kein Ziel). Nur ein Scope, in dem das Konto can_write hat, wird akzeptiert (sonst 400) — kein stilles Schreiben in einen Scope, den es nur lesen darf. | EN: default write scope, target scope

Guthaben und Umbuchungen EINES verwalteten Kontos lesen — rein lesend. Zeigt den Kontostand und die Buchungszeilen (Betrag, Grund, Zeit). Aufladen und Verteilen passiert ueber ontouser_team_transfer vom eigenen Konto. | EN: credits, balance, transfer history, budget

Credits vom EIGENEN Guthaben auf ein verwaltetes Konto umbuchen. Es gibt kein from_profile_id: die Quelle ist immer dein Konto. reason und idempotency_key sind Pflicht (max 64 Zeichen); derselbe Schluessel liefert schon_gebucht=true statt doppelt zu buchen — nach einem Timeout gefahrlos wiederholbar. Zu wenig Guthaben: 402, und es wird NICHTS gebucht (keine Teilbuchung, kein Minus). Niemals denselben Schluessel fuer eine andere Absicht verwenden. | EN: transfer credits, budget, fund sub-agent, payout

Vorschau, was ein Offboarding bewirken wuerde — rein lesend, aendert nichts. Zeigt eigene Scopes, fremde Mitgliedschaften samt deren Managern, das Guthaben und ob das Konto der LETZTE Verwalter eines Scopes ist (dann ist Loeschen gesperrt, 400). Immer zuerst aufrufen, dann ontouser_team_offboard. | EN: offboarding, preview, impact, last manager

Die Verwaltung eines Kontos beenden. mode=delete (Standard) loescht Profil, Web-User, Mitgliedschaften, Token und Passkeys; mode=release laesst das Konto leben, beendet nur die Verwaltung und benachrichtigt die Manager fremder Scopes, in denen es bleibt. Das Restguthaben geht zurueck auf dein Konto, ausser keep_balance=1. Vorher ontouser_team_offboard_preview lesen; der letzte Verwalter eines Scopes laesst sich nicht loeschen (400). | EN: offboard, delete account, release, hand back

Ein verwaltetes Konto vollstaendig lesen — rein lesend. Profil, Web-User, Mitgliedschaften mit allen drei Rechten (can_read/can_write/can_manage_scope), Standard-Schreibziel und die Umbuchungen des Kontos. Die profile_id kommt aus ontouser_team_index. Fuer fremde Konten antwortet das Werkzeug 403. | EN: managed account, team member, rights, ledger

Die Mitglieder eines eigenen Bereiches auflisten (wer gehoert dazu). Rein lesend. Nutze es, um den Ist-Stand vor Aenderungen zu sehen. Rechte aendern: toggle_member_flag; entfernen: remove_member. Zugang einladen: create_invite_code. | EN: member, participant, membership, team

Ein Mitglieds-Merkmal umschalten (z.B. Lesen/Schreiben eines Mitglieds im eigenen Bereich). Aendert die Rechte dieses Mitglieds sofort. Nutze es zum Rechtewechsel ohne Neueinladung. Ein Mitglied ganz entfernen: remove_member. Den Ist-Stand zeigt list_members. | EN: member, participant, membership, team

Ein Mitglied aus dem eigenen Bereich entfernen (Zugang entziehen). Der Bereich selbst und seine Daten bleiben bestehen; nur der Zugang entfaellt. Nutze es beim Offboarding. Vorher list_members pruefen, damit du die richtige Person triffst. Nur Rechte aendern statt entfernen: toggle_member_flag. | EN: member, participant, membership, team

Das aktuelle Credit-Guthaben abrufen (Pay-per-Use-Konto). Rein lesend. Nutze es, um vor kostspieligen Aktionen zu pruefen, ob Guthaben vorhanden ist. Was eine Aktion kostet, zeigt onto_credit_pricing; aufladen kannst du mit onto_credit_chargeup oder onto_credit_checkout. | EN: credit, balance, pricing, billing, top-up, checkout

Takes no parameters.

Credits per Checkout erwerben (Bezahlvorgang starten). Loest einen Zahlungsvorgang aus — nur auf ausdrueckliche Ansage ausfuehren. Fuer eine direkte Aufladung gibt es onto_credit_chargeup, fuer vorausbezahlte Kontingente onto_credit_create_prepaid. Den Erfolg prueft onto_credit_balance. | EN: credit, balance, pricing, billing, top-up, checkout

Credits aufladen (Guthaben erhoehen). Bewegt echtes Geld bzw. loest eine Zahlung aus — nutze es nur auf ausdrueckliche Ansage. Der Betrag ist eine Zahlung, keine Rueckgabe. Alternative Zahlwege: onto_credit_checkout oder onto_credit_create_prepaid. Stand danach: onto_credit_balance. | EN: credit, balance, pricing, billing, top-up, checkout

Ein vorausbezahltes Credit-Kontingent anlegen (Prepaid-Vereinbarung). Legt eine Abrechnungsgrundlage an — keine Sofortzahlung. Nutze es beim Einrichten von Prepaid-Kunden. Den aktuellen Stand zeigt onto_credit_balance, Preise onto_credit_pricing. | EN: credit, balance, pricing, billing, top-up, checkout

Beleg zu einer SumUp-Aufladung lesen (Bestellnummer, Datum, Betrag, Credits, Status, Transaktion, Zahlungsdaten). Rein lesend; nur der eigene Beleg, fremde und nicht vorhandene Bestellnummern ergeben dieselbe 404. Kartentoken und BIN werden nicht ausgegeben. Die Bestellnummer steht in onto_credit_balance. | EN: credit, receipt, invoice, bill, sumup, order, paid, top-up

Eine hinterlegte Funktion ausfuehren (serverseitige Automatik/Skript). Der Effekt haengt an der Funktion und kann Daten schreiben — also nicht rein lesend. Nutze es, wenn die Funktion bekannt ist; die verfuegbaren zeigt onto_function_index. Eingaben uebergibst du als inputs-Objekt. | EN: function, automation, expression, script, effect

Alle hinterlegten Funktionen auflisten (serverseitige Automatiken). Rein lesend. Nutze es, um den Namen/die udid fuer onto_function_run zu finden. Anlegen/Aendern: onto_function_create / onto_function_update. Zeitgesteuerte Ablaeufe sind Triggers: onto_trigger_index. | EN: function, automation, expression, script, effect

Rueckstand und Gesundheit der Automatik: offene Ereignisse, Fehler, die letzten Laeufe. Regeln (Trigger) laufen NICHT sofort, sondern ueber die Warteschlange: Ereignisse alle 60 s, zeitgesteuerte Regeln alle 5 min. Genau deshalb ist dieses Werkzeug da — nach dem Anlegen oder Aendern einer Regel hier nachsehen statt die Aktion zu wiederholen oder auf ein Ergebnis zu warten, das noch in der Schlange steht. | EN: automation queue, trigger status, backlog, last runs

Takes no parameters.