# API-Referenz Memo (App-Kennung memo)

> 6 App-Tools. Aufruf immer mit `POST /api/app-tools`, Header `X-API-KEY`, Body `{"name": "<tool>", "input": {…}}`. Welche Tools ein Schlüssel nutzen darf, zeigt `GET /api/app-tools` der Instanz.

Quelle: https://support.unitedsynergy.com/api/referenz/memo/

## 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.

### Memos: `memo.eintrag.*`

#### memo.eintrag.list

Liste/Suche: Memos

- Art: Lesen
- Rechte: Memo lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"memo.eintrag.list","input":{}}`

#### memo.eintrag.get

Detail: Memos

- Art: Lesen
- Rechte: Memo lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"memo.eintrag.get","input":{"id":"<id>"}}`

#### memo.eintrag.create

Anlegen: Memos

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `text` (string, Pflicht)
  - `quelle` (string)
  - `status` (string)
  - `zuordnungTyp` (string)
  - `zuordnungId` (string)
  - `zuordnungLabel` (string)
  - `userId` (string)
- Beispiel: `{"name":"memo.eintrag.create","input":{"text":"<text>"}}`

#### memo.eintrag.update

Ändern: Memos

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `text` (string)
  - `quelle` (string)
  - `status` (string)
  - `zuordnungTyp` (string)
  - `zuordnungId` (string)
  - `zuordnungLabel` (string)
  - `userId` (string)
- Beispiel: `{"name":"memo.eintrag.update","input":{"id":"<id>"}}`

#### memo.eintrag.delete

Löschen: Memos

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"memo.eintrag.delete","input":{"id":"<id>"}}`

## Weitere Aktionen

Eigene Aktionen der App, zum Beispiel Auswertungen, Versand, Zuordnungen oder Abläufe über mehrere Datensätze.

#### memo.zuordnen

Memo aus dem Sammeltopf zuordnen: legt das Ziel an (Konto-Logbuch, Aufgabe, Notiz oder Wissens-Eintrag) und markiert das Memo als zugeordnet. Für die KI-Triage, vorher listen (memo_eintrag_list, filter status=neu) und mit Torben abstimmen.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Memo ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Memo-Inhalt wird in den Ziel-Datensatz kopiert (Logbuch am Konto, Aufgabe, Notiz oder Wissen), Inhalt vorher prüfen, personenbezogene Notizen landen sonst im Team-Kontext.
- Eingabe:
  - `memoId` (string, Pflicht): ID des Memos (memo_…)
  - `typ` (string, Pflicht): Zuordnungs-Ziel. Werte: `konto_logbuch`, `aufgabe`, `notiz`, `wissen`
  - `kontoId` (string): Konto (crm_gbz…), Pflicht bei konto_logbuch, optional bei wissen als Bindung. Fällt sonst auf den Erfassungs-Kontext des Memos zurück
  - `titel` (string): Titel für Logbuch/Aufgabe/Wissen. Default: erste Memo-Zeile
  - `wissenTyp` (string): Nur bei typ=wissen. Default: fakt. Werte: `recherche`, `dossier`, `fakt`, `doku`
  - `quelle` (string): Nur bei typ=wissen: Herkunft (Vault-Pfad, URL). Default: memo
- Beispiel: `{"name":"memo.zuordnen","input":{"memoId":"<memoId>","typ":"konto_logbuch"}}`