Changelog
Diese Seite führt die Änderungen an der talent Flow API auf. Maßgeblich ist immer die API-Referenz — das Changelog nennt nur, was sich gegenüber der Vorversion geändert hat.
Version 3.3.0
Diese Ausgabe fasst alle Änderungen seit 3.0.0 zusammen.
Neue Endpunkte
Bewerber ändern und löschen — bis dahin ließen sich Bewerberstammdaten nur anlegen, nicht mehr ändern:
| Endpunkt | Zweck |
|---|---|
| PUT /v3/candidates/{candidateId} | Bewerberstammdaten ändern. Teil-Update: nur die übermittelten Felder werden geändert |
| PUT /v3/candidates/{candidateId}/languages/{languageId} | Sprache ändern |
| DELETE /v3/candidates/{candidateId}/driverslicences/{driversLicenseId} | Führerschein löschen |
| DELETE /v3/candidates/{candidateId}/languages/{languageId} | Sprache löschen |
| DELETE /v3/candidates/{id}/professions/{professionId} | Beruf löschen |
| DELETE /v3/candidates/{id}/qualifications/{qualificationId} | Qualifikation löschen |
Dies sind die einzigen Löschendpunkte der API. Für den Bewerber selbst, seine Kontaktwege, den Werdegang, Keywords und Dokumente sowie für den gesamten Firmenbereich gibt es weiterhin keinen — dort führt der Weg über den Statuswechsel.
Neue Stammdatenlisten — acht zusätzliche Wertelisten:
| Endpunkt | Inhalt |
|---|---|
| GET /v3/masterdata/nationalities | Nationalitäten |
| GET /v3/masterdata/maritalstatus | Familienstände |
| GET /v3/masterdata/employmenttypes | Arbeitszeitmodelle |
| GET /v3/masterdata/disabilitytypes | Arten der Behinderung |
| GET /v3/masterdata/mobilitytypes | Mobilitätsarten |
| GET /v3/masterdata/bonustypes | Bonusarten |
| GET /v3/masterdata/periods | Zeiteinheiten |
| GET /v3/masterdata/salutations | Anreden |
Erweiterte Endpunkte
Bei diesen Endpunkten wurde der Request-Body erweitert. Bestehende Aufrufe bleiben gültig — die neuen Felder sind optional:
| Endpunkt | |
|---|---|
| POST /v3/candidates | Stammdaten anlegen |
| PUT /v3/candidates/{candidateId}/workcontract | Arbeitsvertrag |
| POST /v3/customers | Firma anlegen |
| PUT /v3/customers/{customerId} | Firma ändern |
| POST /v3/customers/{customerId}/contacts | Kontakt anlegen |
| PUT /v3/customers/{customerId}/contacts/{contactId} | Kontakt ändern |
| POST /v3/customers/{customerId}/offices | Betriebsstätte anlegen |
| PUT /v3/customers/{customerId}/offices/{officeId} | Betriebsstätte ändern |
Ebenfalls erweitert wurden die Antworten von GET /v3/candidates und GET /v3/candidates/export/candidates/{candidateId}.
Migrationshinweise
Wer Bewerberstammdaten bisher nicht ändern konnte, kann das jetzt über
PUT /v3/candidates/{candidateId}— und muss dabei nur die geänderten Felder senden.Die erweiterten Request-Bodies erfordern keine Anpassung; die neuen Felder sind optional.