# API-Referenz Ziele & Entwicklung (App-Kennung entwicklung)

> 32 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/entwicklung/

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

### Gespräche: `entwicklung.gespraech.*`

#### entwicklung.gespraech.list

Liste/Suche: Gespräche

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

#### entwicklung.gespraech.get

Detail: Gespräche

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

### Ziele: `entwicklung.ziel.*`

#### entwicklung.ziel.list

Liste/Suche: Ziele

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

#### entwicklung.ziel.get

Detail: Ziele

- Art: Lesen
- Rechte: Ziel lesen
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string, Pflicht)
- Beispiel: `{"name":"entwicklung.ziel.get","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.

### Bewertungsskalen: `entwicklung.skala.*`

#### entwicklung.skala.list

Liste/Suche: Katalog „Bewertungsskalen" (entwicklung)

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

#### entwicklung.skala.get

Detail: Katalog „Bewertungsskalen" (entwicklung)

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

#### entwicklung.skala.create

Anlegen: Katalog „Bewertungsskalen" (entwicklung)

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

#### entwicklung.skala.update

Ändern: Katalog „Bewertungsskalen" (entwicklung)

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

#### entwicklung.skala.delete

Löschen: Katalog „Bewertungsskalen" (entwicklung)

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

### Gesprächstypen: `entwicklung.typ.*`

#### entwicklung.typ.list

Liste/Suche: Katalog „Gesprächstypen" (entwicklung)

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

#### entwicklung.typ.get

Detail: Katalog „Gesprächstypen" (entwicklung)

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

#### entwicklung.typ.create

Anlegen: Katalog „Gesprächstypen" (entwicklung)

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

#### entwicklung.typ.update

Ändern: Katalog „Gesprächstypen" (entwicklung)

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

#### entwicklung.typ.delete

Löschen: Katalog „Gesprächstypen" (entwicklung)

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

### Kompetenzen: `entwicklung.kompetenz.*`

#### entwicklung.kompetenz.list

Liste/Suche: Katalog „Kompetenzen" (entwicklung)

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

#### entwicklung.kompetenz.get

Detail: Katalog „Kompetenzen" (entwicklung)

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

#### entwicklung.kompetenz.create

Anlegen: Katalog „Kompetenzen" (entwicklung)

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

#### entwicklung.kompetenz.update

Ändern: Katalog „Kompetenzen" (entwicklung)

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

#### entwicklung.kompetenz.delete

Löschen: Katalog „Kompetenzen" (entwicklung)

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

### Zielarten: `entwicklung.zielart.*`

#### entwicklung.zielart.list

Liste/Suche: Katalog „Zielarten" (entwicklung)

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

#### entwicklung.zielart.get

Detail: Katalog „Zielarten" (entwicklung)

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

#### entwicklung.zielart.create

Anlegen: Katalog „Zielarten" (entwicklung)

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

#### entwicklung.zielart.update

Ändern: Katalog „Zielarten" (entwicklung)

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

#### entwicklung.zielart.delete

Löschen: Katalog „Zielarten" (entwicklung)

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

### Zielkategorien: `entwicklung.zielkategorie.*`

#### entwicklung.zielkategorie.list

Liste/Suche: Katalog „Zielkategorien" (entwicklung)

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

#### entwicklung.zielkategorie.get

Detail: Katalog „Zielkategorien" (entwicklung)

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

#### entwicklung.zielkategorie.create

Anlegen: Katalog „Zielkategorien" (entwicklung)

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

#### entwicklung.zielkategorie.update

Ändern: Katalog „Zielkategorien" (entwicklung)

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

#### entwicklung.zielkategorie.delete

Löschen: Katalog „Zielkategorien" (entwicklung)

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

## Weitere Aktionen

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

#### entwicklung.upsert_gespraech

Legt ein Gespräch an oder ändert es (id optional). Person + Typ + Status. Bearbeitung läuft durch den Service.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Gespraech ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string): Gespräch-ID (leer = neu anlegen)
  - `data` (object, Pflicht): Felder: personId, titel, typCode, status, betreuerUserId, datumGeplant, zusammenfassung, leistungWert, potenzialWert, risikoFlag, risikoGrund, naechstesGespraechAm
- Beispiel: `{"name":"entwicklung.upsert_gespraech","input":{"data":{}}}`

#### entwicklung.upsert_ziel

Legt ein Ziel an oder ändert es (id optional). Erreichungsgrad wird bei quantitativen Zielen automatisch berechnet.

- Art: Anlegen, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ziel ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `id` (string): Ziel-ID (leer = neu anlegen)
  - `data` (object, Pflicht): Felder: personId, titel, art (qualitativ|quantitativ), ebene, kategorieCode, vereinbarung, zieldefinition, messgroesse, einheit, zielwert, istwert, gewichtung, skalaCode, status, zielDatum, gespraechId
- Beispiel: `{"name":"entwicklung.upsert_ziel","input":{"data":{}}}`

#### entwicklung.ziel_checkin

Bucht einen Fortschritts-Check-in auf ein Ziel. Spiegelt istwert/Erreichungsgrad auf das Ziel (Rechenlogik im Service).

- Art: Ändern, vor dem Ausführen ausdrücklich bestätigen lassen
- Rechte: Ziel ändern
- Datenklassen: C (vertraulich)
- Eingabe:
  - `zielId` (string, Pflicht): Ziel-ID
  - `erreichungsgrad` (number): Erreichungsgrad in % (0..100+)
  - `istwert` (number): Aktueller Ist-Wert (bei quantitativen Zielen)
  - `kommentar` (string): Notiz zum Check-in
- Beispiel: `{"name":"entwicklung.ziel_checkin","input":{"zielId":"<zielId>"}}`