# API-Referenz LMS (App-Kennung lms)

> 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/lms/

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

### Kurse (LMS): `lms.kurs.*`

#### lms.kurs.list

Liste/Suche: Kurse (LMS)

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

#### lms.kurs.get

Detail: Kurse (LMS)

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

#### lms.kurs.create

Anlegen: Kurse (LMS)

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: LmsKurs anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `beschreibung` (string)
  - `klasse` (string)
  - `status` (string): entwurf | aktiv | …
  - `dauerMinuten` (number)
  - `coverUrl` (string)
- Beispiel: `{"name":"lms.kurs.create","input":{"titel":"<titel>"}}`

#### lms.kurs.update

Ändern: Kurse (LMS)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: LmsKurs ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `beschreibung` (string)
  - `klasse` (string)
  - `status` (string): entwurf | aktiv | …
  - `dauerMinuten` (number)
  - `coverUrl` (string)
- Beispiel: `{"name":"lms.kurs.update","input":{"id":"<id>"}}`

#### lms.kurs.delete

Löschen: Kurse (LMS)

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