# API-Referenz Bewerber (App-Kennung bewerber)

> 36 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/bewerber/

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

### Bewerber: `bewerber.bewerber.*`

#### bewerber.bewerber.list

Liste/Suche: Bewerber

- Art: Lesen
- Rechte: Bewerber lesen
- Datenklassen: B (intern)
- Eingabe:
  - `search` (string): Freitextsuche
  - `filters` (object): Feld=Wert-Filter
  - `limit` (integer)
  - `offset` (integer)
  - `orderBy` (string)
- Beispiel: `{"name":"bewerber.bewerber.list","input":{}}`

#### bewerber.bewerber.get

Detail: Bewerber

- Art: Lesen
- Rechte: Bewerber lesen
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bewerber.bewerber.get","input":{"id":"<id>"}}`

#### bewerber.bewerber.create

Anlegen: Bewerber

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber anlegen
- Datenklassen: B (intern)
- Eingabe:
  - `vorname` (string)
  - `nachname` (string, Pflicht)
  - `email` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `geburtsdatum` (string)
  - `anrede` (string)
  - `titel` (string)
  - `statusCode` (string)
  - `stelleId` (string)
  - `bewerbertypCode` (string)
  - `gewuenschterBeginn` (string)
  - `gueltigBis` (string)
  - `gehaltsvorstellung` (number)
  - `bewertung` (number)
  - `kosten` (number)
  - `ablehnungsgrundCode` (string)
  - `ablehnungsfreitext` (string)
  - `bemerkung` (string)
  - `standort` (string)
  - `fachbereich` (string)
  - `funktion` (string)
  - `eingangsdatum` (string)
- Beispiel: `{"name":"bewerber.bewerber.create","input":{"nachname":"<nachname>"}}`

#### bewerber.bewerber.update

Ändern: Bewerber

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber ändern
- Datenklassen: B (intern)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `vorname` (string)
  - `nachname` (string)
  - `email` (string)
  - `telefon` (string)
  - `mobil` (string)
  - `geburtsdatum` (string)
  - `anrede` (string)
  - `titel` (string)
  - `statusCode` (string)
  - `stelleId` (string)
  - `bewerbertypCode` (string)
  - `gewuenschterBeginn` (string)
  - `gueltigBis` (string)
  - `gehaltsvorstellung` (number)
  - `bewertung` (number)
  - `kosten` (number)
  - `ablehnungsgrundCode` (string)
  - `ablehnungsfreitext` (string)
  - `bemerkung` (string)
  - `standort` (string)
  - `fachbereich` (string)
  - `funktion` (string)
  - `eingangsdatum` (string)
- Beispiel: `{"name":"bewerber.bewerber.update","input":{"id":"<id>"}}`

#### bewerber.bewerber.delete

Löschen: Bewerber

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

### Stellen: `bewerber.stelle.*`

#### bewerber.stelle.list

Liste/Suche: Stellen

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

#### bewerber.stelle.get

Detail: Stellen

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

#### bewerber.stelle.create

Anlegen: Stellen

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber anlegen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `titel` (string, Pflicht)
  - `nummer` (string)
  - `beschreibung` (string)
  - `fachbereich` (string)
  - `standort` (string)
  - `statusCode` (string)
  - `gueltigAb` (string)
  - `gueltigBis` (string)
- Beispiel: `{"name":"bewerber.stelle.create","input":{"titel":"<titel>"}}`

#### bewerber.stelle.update

Ändern: Stellen

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht): ID des Datensatzes
  - `titel` (string)
  - `nummer` (string)
  - `beschreibung` (string)
  - `fachbereich` (string)
  - `standort` (string)
  - `statusCode` (string)
  - `gueltigAb` (string)
  - `gueltigBis` (string)
- Beispiel: `{"name":"bewerber.stelle.update","input":{"id":"<id>"}}`

#### bewerber.stelle.delete

Löschen: Stellen

- Art: Löschen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber löschen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"bewerber.stelle.delete","input":{"id":"<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.

### Ablehnungsgründe: `bewerber.ablehnungsgrund.*`

#### bewerber.ablehnungsgrund.list

Liste/Suche: Katalog „Ablehnungsgründe" (bewerber)

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

#### bewerber.ablehnungsgrund.get

Detail: Katalog „Ablehnungsgründe" (bewerber)

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

#### bewerber.ablehnungsgrund.create

Anlegen: Katalog „Ablehnungsgründe" (bewerber)

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

#### bewerber.ablehnungsgrund.update

Ändern: Katalog „Ablehnungsgründe" (bewerber)

- 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":"bewerber.ablehnungsgrund.update","input":{"id":"<id>"}}`

#### bewerber.ablehnungsgrund.delete

Löschen: Katalog „Ablehnungsgründe" (bewerber)

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

### Bewerbertypen: `bewerber.typ.*`

#### bewerber.typ.list

Liste/Suche: Katalog „Bewerbertypen" (bewerber)

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

#### bewerber.typ.get

Detail: Katalog „Bewerbertypen" (bewerber)

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

#### bewerber.typ.create

Anlegen: Katalog „Bewerbertypen" (bewerber)

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

#### bewerber.typ.update

Ändern: Katalog „Bewerbertypen" (bewerber)

- 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":"bewerber.typ.update","input":{"id":"<id>"}}`

#### bewerber.typ.delete

Löschen: Katalog „Bewerbertypen" (bewerber)

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

### Kanaltypen: `bewerber.kanaltyp.*`

#### bewerber.kanaltyp.list

Liste/Suche: Katalog „Kanaltypen" (bewerber)

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

#### bewerber.kanaltyp.get

Detail: Katalog „Kanaltypen" (bewerber)

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

#### bewerber.kanaltyp.create

Anlegen: Katalog „Kanaltypen" (bewerber)

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

#### bewerber.kanaltyp.update

Ändern: Katalog „Kanaltypen" (bewerber)

- 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":"bewerber.kanaltyp.update","input":{"id":"<id>"}}`

#### bewerber.kanaltyp.delete

Löschen: Katalog „Kanaltypen" (bewerber)

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

### Status (Pipeline): `bewerber.status.*`

#### bewerber.status.list

Liste/Suche: Katalog „Status (Pipeline)" (bewerber)

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

#### bewerber.status.get

Detail: Katalog „Status (Pipeline)" (bewerber)

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

#### bewerber.status.create

Anlegen: Katalog „Status (Pipeline)" (bewerber)

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

#### bewerber.status.update

Ändern: Katalog „Status (Pipeline)" (bewerber)

- 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":"bewerber.status.update","input":{"id":"<id>"}}`

#### bewerber.status.delete

Löschen: Katalog „Status (Pipeline)" (bewerber)

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

### Stellenstatus: `bewerber.stellestatus.*`

#### bewerber.stellestatus.list

Liste/Suche: Katalog „Stellenstatus" (bewerber)

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

#### bewerber.stellestatus.get

Detail: Katalog „Stellenstatus" (bewerber)

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

#### bewerber.stellestatus.create

Anlegen: Katalog „Stellenstatus" (bewerber)

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

#### bewerber.stellestatus.update

Ändern: Katalog „Stellenstatus" (bewerber)

- 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":"bewerber.stellestatus.update","input":{"id":"<id>"}}`

#### bewerber.stellestatus.delete

Löschen: Katalog „Stellenstatus" (bewerber)

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

## Weitere Aktionen

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

#### bewerber.einstellen

Stellt einen Bewerber ein: legt (idempotent) einen Mitarbeiter im Personal-Modul an und markiert den Bewerber als eingestellt.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Bewerber ändern
- Datenklassen: C (vertraulich)
- Datenschutz: Übernimmt die Person des Bewerbers als Mitarbeiter (festangestellt/Probezeit). Cross-Modul-Schreibvorgang ins Personal-Modul.
- Eingabe:
  - `id` (string, Pflicht): Bewerber-ID
- Beispiel: `{"name":"bewerber.einstellen","input":{"id":"<id>"}}`