# API-Referenz Vorlagen (App-Kennung textbausteine) > 42 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/textbausteine/ ## 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. ### Datenobjekte (Template-Entitäten): `textbausteine.datenobjekt.*` #### textbausteine.datenobjekt.list Liste/Suche: Datenobjekte (Template-Entitäten) - Art: Lesen - Rechte: TemplateEntitaet lesen - Datenklassen: B (intern) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"textbausteine.datenobjekt.list","input":{}}` #### textbausteine.datenobjekt.get Detail: Datenobjekte (Template-Entitäten) - Art: Lesen - Rechte: TemplateEntitaet lesen - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"textbausteine.datenobjekt.get","input":{"id":""}}` #### textbausteine.datenobjekt.update Ändern: Datenobjekte (Template-Entitäten) - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: TemplateEntitaet ändern - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `name` (string) - `isActive` (boolean) - Beispiel: `{"name":"textbausteine.datenobjekt.update","input":{"id":""}}` ### Dokument-/Mail-Vorlagen: `textbausteine.vorlage.*` #### textbausteine.vorlage.list Liste/Suche: Dokument-/Mail-Vorlagen - Art: Lesen - Rechte: TemplateElement lesen - Datenklassen: C (vertraulich) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"textbausteine.vorlage.list","input":{}}` #### textbausteine.vorlage.get Detail: Dokument-/Mail-Vorlagen - Art: Lesen - Rechte: TemplateElement lesen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"textbausteine.vorlage.get","input":{"id":""}}` #### textbausteine.vorlage.create Anlegen: Dokument-/Mail-Vorlagen - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: TemplateElement anlegen - Datenklassen: C (vertraulich) - Eingabe: - `name` (string, Pflicht) - `format` (string): PDF/WORD/EXCEL/PPTX/EMAIL. Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL` - `category` (string) - `app` (string) - `entityTypeId` (string) - `layoutId` (string) - `orientation` (string): Werte: `portrait`, `landscape` - `header` (string) - `footer` (string) - `mailMode` (string): marketing = visueller Block-Builder. Werte: `einfach`, `marketing` - `subject` (string) - `body` (string) - `senderAccountId` (string) - Beispiel: `{"name":"textbausteine.vorlage.create","input":{"name":""}}` #### textbausteine.vorlage.update Ändern: Dokument-/Mail-Vorlagen - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: TemplateElement ändern - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `name` (string) - `format` (string): PDF/WORD/EXCEL/PPTX/EMAIL. Werte: `PDF`, `WORD`, `EXCEL`, `PPTX`, `EMAIL` - `category` (string) - `app` (string) - `entityTypeId` (string) - `layoutId` (string) - `orientation` (string): Werte: `portrait`, `landscape` - `header` (string) - `footer` (string) - `mailMode` (string): marketing = visueller Block-Builder. Werte: `einfach`, `marketing` - `subject` (string) - `body` (string) - `senderAccountId` (string) - Beispiel: `{"name":"textbausteine.vorlage.update","input":{"id":""}}` #### textbausteine.vorlage.delete Löschen: Dokument-/Mail-Vorlagen - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: TemplateElement löschen - Datenklassen: C (vertraulich) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"textbausteine.vorlage.delete","input":{"id":""}}` ### Dokument-Layouts: `textbausteine.layout.*` #### textbausteine.layout.list Liste/Suche: Dokument-Layouts - Art: Lesen - Rechte: DokumentLayout lesen - Datenklassen: B (intern) - Eingabe: - `search` (string): Freitextsuche - `filters` (object): Feld=Wert-Filter - `limit` (integer) - `offset` (integer) - `orderBy` (string) - Beispiel: `{"name":"textbausteine.layout.list","input":{}}` #### textbausteine.layout.get Detail: Dokument-Layouts - Art: Lesen - Rechte: DokumentLayout lesen - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"textbausteine.layout.get","input":{"id":""}}` #### textbausteine.layout.create Anlegen: Dokument-Layouts - Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: DokumentLayout anlegen - Datenklassen: B (intern) - Eingabe: - `bezeichnung` (string, Pflicht) - `kategorie` (string) - `header` (string) - `fusszeile` (string) - Beispiel: `{"name":"textbausteine.layout.create","input":{"bezeichnung":""}}` #### textbausteine.layout.update Ändern: Dokument-Layouts - Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: DokumentLayout ändern - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht): ID des Datensatzes - `bezeichnung` (string) - `kategorie` (string) - `header` (string) - `fusszeile` (string) - Beispiel: `{"name":"textbausteine.layout.update","input":{"id":""}}` #### textbausteine.layout.delete Löschen: Dokument-Layouts - Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen - Rechte: DokumentLayout löschen - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"textbausteine.layout.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. ### Dokument-Typen: `textbausteine.dokument_typ.*` #### textbausteine.dokument_typ.list Liste/Suche: Katalog „Dokument-Typen" (textbausteine) - Art: Lesen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `onlyAktiv` (boolean): Nur aktive Einträge - Beispiel: `{"name":"textbausteine.dokument_typ.list","input":{}}` #### textbausteine.dokument_typ.get Detail: Katalog „Dokument-Typen" (textbausteine) - Art: Lesen - Rechte: Einstellungen verwalten - Datenklassen: B (intern) - Eingabe: - `id` (string, Pflicht) - Beispiel: `{"name":"textbausteine.dokument_typ.get","input":{"id":""}}` #### textbausteine.dokument_typ.create Anlegen: Katalog „Dokument-Typen" (textbausteine) - 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":"textbausteine.dokument_typ.create","input":{"label":"