# API-Referenz Ausbildung (App-Kennung bildung) > 98 App-Tools. Aufruf immer mit `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "", "input": {…}}`. Welche Tools ein Schlüssel nutzen darf, zeigt `GET /api/app-tools` der Instanz. Quelle: https://support.unitedsynergy.com/api/referenz/bildung/ ## Datenobjekte Die Standard-Aktionen je Datenobjekt: list (suchen und blättern), get (einen Datensatz lesen), create, update und delete. Nicht jedes Objekt bietet alle fünf an. ### Ausbildungen: `bildung.ausbildung.*` #### bildung.ausbildung.list Liste/Suche: Ausbildungen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.ausbildung.list","input":{}}` #### bildung.ausbildung.get Detail: Ausbildungen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.ausbildung.get","input":{"id":""}}` #### bildung.ausbildung.create Anlegen: Ausbildungen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `nummer` (string): Natürlicher Schlüssel für Dedup - `titel` (string, Pflicht) - `kuerzel` (string) - `kategorie` (string) - `abschlussCode` (string) - `dauer` (number) - `einheit` (string) - `ue` (number) - `beginn` (string) - `ende` (string) - `statusCode` (string) - `bemerkung` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.ausbildung.create","input":{"titel":""}}` #### bildung.ausbildung.update Ändern: Ausbildungen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `titel` (string) - `kuerzel` (string) - `kategorie` (string) - `abschlussCode` (string) - `dauer` (number) - `einheit` (string) - `ue` (number) - `beginn` (string) - `ende` (string) - `statusCode` (string) - `bemerkung` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.ausbildung.update","input":{"id":""}}` #### bildung.ausbildung.delete Löschen: Ausbildungen - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.ausbildung.delete","input":{"id":""}}` ### Lerninhalte: `bildung.lerninhalt.*` #### bildung.lerninhalt.list Liste/Suche: Lerninhalte - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.lerninhalt.list","input":{}}` #### bildung.lerninhalt.get Detail: Lerninhalte - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.lerninhalt.get","input":{"id":""}}` #### bildung.lerninhalt.create Anlegen: Lerninhalte - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `titel` (string, Pflicht) - `nummer` (string) - `beschreibung` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `typ` (string) - `url` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.lerninhalt.create","input":{"titel":""}}` #### bildung.lerninhalt.update Ändern: Lerninhalte - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `titel` (string) - `nummer` (string) - `beschreibung` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `typ` (string) - `url` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.lerninhalt.update","input":{"id":""}}` #### bildung.lerninhalt.delete Löschen: Lerninhalte - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.lerninhalt.delete","input":{"id":""}}` ### Modul-Zuordnungen: `bildung.modul_ausbildung.*` #### bildung.modul_ausbildung.list Liste/Suche: Modul-Zuordnungen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.modul_ausbildung.list","input":{}}` #### bildung.modul_ausbildung.get Detail: Modul-Zuordnungen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.modul_ausbildung.get","input":{"id":""}}` #### bildung.modul_ausbildung.create Anlegen: Modul-Zuordnungen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `modul` (string) - `ausbildung` (string) - Beispiel: `{"name":"bildung.modul_ausbildung.create","input":{}}` #### bildung.modul_ausbildung.update Ändern: Modul-Zuordnungen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - Beispiel: `{"name":"bildung.modul_ausbildung.update","input":{"id":""}}` ### Module: `bildung.modul.*` #### bildung.modul.list Liste/Suche: Module - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.modul.list","input":{}}` #### bildung.modul.get Detail: Module - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.modul.get","input":{"id":""}}` #### bildung.modul.create Anlegen: Module - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `titel` (string, Pflicht) - `nummer` (string) - `beschreibung` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `lernortCode` (string) - `phase` (string) - `jahr` (number) - `abschlussCode` (string) - `color` (string) - `badge` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.modul.create","input":{"titel":""}}` #### bildung.modul.update Ändern: Module - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `titel` (string) - `beschreibung` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `lernortCode` (string) - `phase` (string) - `jahr` (number) - `abschlussCode` (string) - `color` (string) - `badge` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.modul.update","input":{"id":""}}` #### bildung.modul.delete Löschen: Module - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.modul.delete","input":{"id":""}}` ### Schulklassen: `bildung.schulklasse.*` #### bildung.schulklasse.list Liste/Suche: Schulklassen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.schulklasse.list","input":{}}` #### bildung.schulklasse.get Detail: Schulklassen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.schulklasse.get","input":{"id":""}}` #### bildung.schulklasse.create Anlegen: Schulklassen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `bezeichnung` (string, Pflicht) - `nummer` (string) - `ausbildungId` (string) - `statusCode` (string) - `bemerkung` (string) - `aktiv` (boolean) - `ausbildungNummer` (string): Verweis auf Ausbildung.nummer, wird zu Ausbildung-ID aufgelöst (Ausbildung muss zuerst importiert sein) - Beispiel: `{"name":"bildung.schulklasse.create","input":{"bezeichnung":""}}` #### bildung.schulklasse.update Ändern: Schulklassen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `bezeichnung` (string) - `nummer` (string) - `ausbildungId` (string) - `statusCode` (string) - `bemerkung` (string) - `aktiv` (boolean) - `ausbildungNummer` (string): Verweis auf Ausbildung.nummer, wird zu Ausbildung-ID aufgelöst (Ausbildung muss zuerst importiert sein) - Beispiel: `{"name":"bildung.schulklasse.update","input":{"id":""}}` #### bildung.schulklasse.delete Löschen: Schulklassen - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.schulklasse.delete","input":{"id":""}}` ### Skills: `bildung.skill.*` #### bildung.skill.list Liste/Suche: Skills - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.skill.list","input":{}}` #### bildung.skill.get Detail: Skills - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.skill.get","input":{"id":""}}` #### bildung.skill.create Anlegen: Skills - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `titel` (string, Pflicht) - `nummer` (string) - `beschreibung` (string) - `kategorie` (string) - `istPflicht` (boolean) - `istPruefung` (boolean) - `schwierigkeit` (string) - `videoUrl` (string) - `dauerMin` (number) - `indikation` (string) - `nachweisSoll` (string) - `mindestzahl` (number) - `nachweisSetting` (string) - `autonomie` (string) - `leitlinie` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.skill.create","input":{"titel":""}}` #### bildung.skill.update Ändern: Skills - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `titel` (string) - `beschreibung` (string) - `kategorie` (string) - `istPflicht` (boolean) - `istPruefung` (boolean) - `schwierigkeit` (string) - `videoUrl` (string) - `dauerMin` (number) - `indikation` (string) - `nachweisSoll` (string) - `mindestzahl` (number) - `nachweisSetting` (string) - `autonomie` (string) - `leitlinie` (string) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.skill.update","input":{"id":""}}` #### bildung.skill.delete Löschen: Skills - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.skill.delete","input":{"id":""}}` ### Themen: `bildung.thema.*` #### bildung.thema.list Liste/Suche: Themen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.thema.list","input":{}}` #### bildung.thema.get Detail: Themen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.thema.get","input":{"id":""}}` #### bildung.thema.create Anlegen: Themen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `titel` (string, Pflicht) - `nummer` (string) - `beschreibung` (string) - `lernortCode` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `typ` (string) - `sollUe` (number) - `zuordnung` (string) - `aprBereich` (string) - `aprNummer` (string) - `systemrelevant` (boolean) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.thema.create","input":{"titel":""}}` #### bildung.thema.update Ändern: Themen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `titel` (string) - `beschreibung` (string) - `lernortCode` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `typ` (string) - `sollUe` (number) - `zuordnung` (string) - `aprBereich` (string) - `aprNummer` (string) - `systemrelevant` (boolean) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.thema.update","input":{"id":""}}` #### bildung.thema.delete Löschen: Themen - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.thema.delete","input":{"id":""}}` ### Unterricht-Zuordnungen: `bildung.unterricht_ausbildung.*` #### bildung.unterricht_ausbildung.list Liste/Suche: Unterricht-Zuordnungen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.unterricht_ausbildung.list","input":{}}` #### bildung.unterricht_ausbildung.get Detail: Unterricht-Zuordnungen - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.unterricht_ausbildung.get","input":{"id":""}}` #### bildung.unterricht_ausbildung.create Anlegen: Unterricht-Zuordnungen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `unterricht` (string) - `ausbildung` (string) - Beispiel: `{"name":"bildung.unterricht_ausbildung.create","input":{}}` #### bildung.unterricht_ausbildung.update Ändern: Unterricht-Zuordnungen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - Beispiel: `{"name":"bildung.unterricht_ausbildung.update","input":{"id":""}}` ### Unterrichte: `bildung.unterricht.*` #### bildung.unterricht.list Liste/Suche: Unterrichte - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"bildung.unterricht.list","input":{}}` #### bildung.unterricht.get Detail: Unterrichte - Art: Lesen - Rechte: BildungStammdaten lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.unterricht.get","input":{"id":""}}` #### bildung.unterricht.create Anlegen: Unterrichte - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten anlegen - Datenklassen: C (vertraulich) - Eingabe: - `titel` (string, Pflicht) - `nummer` (string) - `beschreibung` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `ziele` (string) - `handlungssituation` (string) - `unterrichtsformCode` (string) - `color` (string) - `badge` (string) - `nachweisErstellen` (boolean) - `statusCode` (string) - `modulNummer` (string): Verweis auf Modul.nummer → Modul↔Unterricht-Verknüpfung (Modul zuerst importieren) - `themaNummern` (string): Verweis(e) auf Thema.nummer → Unterricht↔Thema (Themen zuerst importieren) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.unterricht.create","input":{"titel":""}}` #### bildung.unterricht.update Ändern: Unterrichte - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `titel` (string) - `beschreibung` (string) - `ue` (number) - `dauer` (number) - `einheit` (string) - `ziele` (string) - `handlungssituation` (string) - `unterrichtsformCode` (string) - `color` (string) - `badge` (string) - `nachweisErstellen` (boolean) - `statusCode` (string) - `modulNummer` (string): Verweis auf Modul.nummer → Modul↔Unterricht-Verknüpfung (Modul zuerst importieren) - `themaNummern` (string): Verweis(e) auf Thema.nummer → Unterricht↔Thema (Themen zuerst importieren) - `aktiv` (boolean) - Beispiel: `{"name":"bildung.unterricht.update","input":{"id":""}}` #### bildung.unterricht.delete Löschen: Unterrichte - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: BildungStammdaten löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.unterricht.delete","input":{"id":""}}` ## Wertelisten Auswahllisten der App wie Status, Arten oder Kategorien. Du pflegst sie mit denselben fünf Aktionen. Die Werte (code) nutzt du in den Feldern der Datenobjekte. ### Abschlüsse: `bildung.abschluss.*` #### bildung.abschluss.list Liste/Suche: Katalog „Abschlüsse" (bildung) - Art: Lesen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `onlyAktiv` (boolean): Nur aktive Einträge - Beispiel: `{"name":"bildung.abschluss.list","input":{}}` #### bildung.abschluss.get Detail: Katalog „Abschlüsse" (bildung) - Art: Lesen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"bildung.abschluss.get","input":{"id":""}}` #### bildung.abschluss.create Anlegen: Katalog „Abschlüsse" (bildung) - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `label` (string, Pflicht): Anzeige-Text - `code` (string): Optional, sonst aus label abgeleitet. Immutable - `color` (string): Tailwind-Paar, z.B. "bg-blue-100 text-blue-700" - `icon` (string): Lucide-Icon-Name - `beschreibung` (string) - Beispiel: `{"name":"bildung.abschluss.create","input":{"label":"