# API-Referenz Wissen (App-Kennung wissen)

> 5 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/wissen/

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

### Wissen: `wissen.eintrag.*`

#### wissen.eintrag.list

Liste/Suche: Wissen

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

#### wissen.eintrag.get

Detail: Wissen

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

#### wissen.eintrag.create

Anlegen: Wissen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Wissen anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `inhalt` (string)
  - `typ` (string)
  - `quelle` (string)
  - `ownerType` (string)
  - `ownerId` (string)
  - `status` (string)
- Beispiel: `{"name":"wissen.eintrag.create","input":{"titel":"<titel>"}}`

#### wissen.eintrag.update

Ändern: Wissen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Wissen ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `inhalt` (string)
  - `typ` (string)
  - `quelle` (string)
  - `ownerType` (string)
  - `ownerId` (string)
  - `status` (string)
- Beispiel: `{"name":"wissen.eintrag.update","input":{"id":"<id>"}}`

#### wissen.eintrag.delete

Löschen: Wissen

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