Mitarbeiter aktualisieren

Mit diesem Endpunkt können Sie einen bestehenden Mitarbeiter aktualisieren.

Request

PUT /api/v1/employees/{username}

curl --request PUT \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/max.mustermann' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
         "firstname": "Max",
         "lastname": "Mustermann",
         "email": "max.mustermann@beispiel.de",
         "phone": "+49 30 987654",
         "department_id": 43,
         "rights": "1",
         "employment": "0",
         "birthdate": "1990-01-15",
         "street": "Neue Straße 456",
         "zip": "10117",
         "city": "Berlin",
         "country": "Deutschland"
     }'

Response

{
    "data": {
        "id": 12345,
        "username": "max.mustermann",
        "firstname": "Max",
        "lastname": "Mustermann",
        "email": "max.mustermann@beispiel.de",
        "price_group": "Standard",
        "department_id": 43,
        "phone": "+49 30 987654",
        "rights": "1",
        "employment": "0",
        "birthdate": "1990-01-15",
        "street": "Neue Straße 456",
        "zip": "10117",
        "city": "Berlin",
        "country": "Deutschland",
        "salutation": null,
        "abbreviation": null,
        "title": null,
        "mobile": null,
        "fax": null,
        "created": "2024-09-17T10:15:47.000000Z",
        "modified": "2025-10-07T14:30:22.000000Z"
    }
}

Erforderliche Parameter

Name
username
Type
string
Description
Benutzername (kann nicht geändert werden, muss dem aktuellen Wert entsprechen)

Optionale Parameter

Name
firstname
Type
string
Description
Vorname des Mitarbeiters (max. 255 Zeichen).
Name
lastname
Type
string
Description
Nachname des Mitarbeiters (max. 255 Zeichen).
Name
email
Type
string
Description
E-Mail-Adresse (muss eindeutig sein, max. 255 Zeichen).
Name
personal_number
Type
string
Description
Personalnummer (muss eindeutig sein, falls angegeben).
Name
birthdate
Type
date | Y-m-d
Description
Geburtsdatum des Mitarbeiters.
Name
phone
Type
string
Description
Geschäftliche Telefonnummer.
Name
department_id
Type
integer
Description
ID der Abteilung.
Name
rights
Type
string | enum
Description
Zugriffsrechte: 0 (Benutzer), 1 (Admin), 2 (Controller), 3 (Benutzer mit erweiterten Rechten), 4 (Projekt-Controller).
Name
employment
Type
string | enum
Description
Anstellungstyp: 0 (Festangestellt), 1 (Freiberufler), 2 (Student), 3 (Werkstudent).
Name
price_group
Type
string
Description
Name der Preisgruppe.
Name
oauth_username
Type
string
Description
OAuth-Benutzername für SSO-Integration (muss eindeutig sein).
Name
salutation
Type
string | enum
Description
Anrede: 1 (Herr), 2 (Frau), 3 (Divers).
Name
street
Type
string
Description
Straße und Hausnummer (max. 64 Zeichen).
Name
zip
Type
string
Description
Postleitzahl (max. 32 Zeichen).
Name
city
Type
string
Description
Stadt (max. 64 Zeichen).
Name
country
Type
string
Description
Land (max. 64 Zeichen).
Name
abbreviation
Type
string
Description
Kürzel/Abkürzung (max. 32 Zeichen).
Name
title
Type
string
Description
Akademischer Titel (max. 32 Zeichen).
Name
mobile
Type
string
Description
Mobiltelefonnummer (max. 32 Zeichen).
Name
fax
Type
string
Description
Faxnummer (max. 32 Zeichen).
Name
language
Type
string
Description
Sprachcode (max. 32 Zeichen).
Name
active
Type
boolean
Description
Status: Aktiv oder inaktiv.
Name
target_hours_monthly
Type
string
Description
Monatliche Sollarbeitszeit.
Name
target_hours_annual
Type
string
Description
Jährliche Sollarbeitszeit.

Hinweise

Der username kann nicht geändert werden
Die email muss eindeutig sein, wenn sie angegeben wird
personal_number und oauth_username müssen ebenfalls eindeutig sein
Alle Felder sind optional außer username, der zur Identifikation des Mitarbeiters dient

POST Mitarbeiter erstellen GET Mitarbeiter