# API-Referenz Fehlzeiten (App-Kennung fehlzeit)

> 20 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/fehlzeit/

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

### Fehlzeit-Kategorien: `fehlzeit.kategorie.*`

#### fehlzeit.kategorie.list

Liste/Suche: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"fehlzeit.kategorie.list","input":{}}`

#### fehlzeit.kategorie.get

Detail: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.kategorie.get","input":{"id":"<id>"}}`

#### fehlzeit.kategorie.create

Anlegen: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- 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":"fehlzeit.kategorie.create","input":{"label":"<label>"}}`

#### fehlzeit.kategorie.update

Ändern: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"fehlzeit.kategorie.update","input":{"id":"<id>"}}`

#### fehlzeit.kategorie.delete

Löschen: Katalog „Fehlzeit-Kategorien" (fehlzeit)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.kategorie.delete","input":{"id":"<id>"}}`

### Intervalle: `fehlzeit.intervall.*`

#### fehlzeit.intervall.list

Liste/Suche: Katalog „Intervalle" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"fehlzeit.intervall.list","input":{}}`

#### fehlzeit.intervall.get

Detail: Katalog „Intervalle" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.intervall.get","input":{"id":"<id>"}}`

#### fehlzeit.intervall.create

Anlegen: Katalog „Intervalle" (fehlzeit)

- 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":"fehlzeit.intervall.create","input":{"label":"<label>"}}`

#### fehlzeit.intervall.update

Ändern: Katalog „Intervalle" (fehlzeit)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"fehlzeit.intervall.update","input":{"id":"<id>"}}`

#### fehlzeit.intervall.delete

Löschen: Katalog „Intervalle" (fehlzeit)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.intervall.delete","input":{"id":"<id>"}}`

### Status: `fehlzeit.status.*`

#### fehlzeit.status.list

Liste/Suche: Katalog „Status" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"fehlzeit.status.list","input":{}}`

#### fehlzeit.status.get

Detail: Katalog „Status" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.status.get","input":{"id":"<id>"}}`

#### fehlzeit.status.create

Anlegen: Katalog „Status" (fehlzeit)

- 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":"fehlzeit.status.create","input":{"label":"<label>"}}`

#### fehlzeit.status.update

Ändern: Katalog „Status" (fehlzeit)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"fehlzeit.status.update","input":{"id":"<id>"}}`

#### fehlzeit.status.delete

Löschen: Katalog „Status" (fehlzeit)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.status.delete","input":{"id":"<id>"}}`

### Urlaubsarten: `fehlzeit.urlaubsart.*`

#### fehlzeit.urlaubsart.list

Liste/Suche: Katalog „Urlaubsarten" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `onlyAktiv` (boolean): Nur aktive Einträge
- Beispiel: `{"name":"fehlzeit.urlaubsart.list","input":{}}`

#### fehlzeit.urlaubsart.get

Detail: Katalog „Urlaubsarten" (fehlzeit)

- Art: Lesen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.urlaubsart.get","input":{"id":"<id>"}}`

#### fehlzeit.urlaubsart.create

Anlegen: Katalog „Urlaubsarten" (fehlzeit)

- 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":"fehlzeit.urlaubsart.create","input":{"label":"<label>"}}`

#### fehlzeit.urlaubsart.update

Ändern: Katalog „Urlaubsarten" (fehlzeit)

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
  - `label` (string)
  - `color` (string)
  - `icon` (string)
  - `beschreibung` (string)
  - `aktiv` (boolean)
- Beispiel: `{"name":"fehlzeit.urlaubsart.update","input":{"id":"<id>"}}`

#### fehlzeit.urlaubsart.delete

Löschen: Katalog „Urlaubsarten" (fehlzeit)

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Einstellungen verwalten
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"fehlzeit.urlaubsart.delete","input":{"id":"<id>"}}`