REST DokumentationAbteilungenPOST Abteilungsleitung zuordnen

Abteilungsleitung zuordnen

Macht den Mitarbeiter zur Leitung der Abteilung und gibt ihm die Rolle Abteilungsleitung aus Rollen & Rechte für diese Abteilung, wie eine Zuordnung in der Benutzeroberfläche. Leitet der Mitarbeiter die Abteilung bereits, antwortet die API mit 422 auf username; is_deputy erfordert das Lizenzmodul Inovex. Erfordert das Modul „Standorte & Abteilungen“.

Verfügbarkeit: Vollversion und ZEP Clock

Request

POST /api/v1/departments/{id}/managers
curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/departments/{id}/managers' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
       "username": "max.mustermann",
       "is_deputy": true
     }'

Pfad-Parameter

  • Name
    id
    Type
    integer
    Description

    Die ID der Abteilung

Request-Body

  • Name
    username
    Type
    string, erforderlich
    Description

    Benutzername des Mitarbeiters, der Leitung der Abteilung wird. Auch ein Mitarbeiter ohne aktuelle Beschäftigung kann zugeordnet werden.

  • Name
    is_deputy
    Type
    boolean
    Description

    Ob der Mitarbeiter Stellvertretung der Abteilungsleitung ist. Nur mit dem Lizenzmodul Inovex; ohne es wird das Feld abgelehnt.

Response

{
  "data": {
    "username": "max.mustermann",
    "firstname": "Max",
    "lastname": "Mustermann",
    "personal_number": "1",
    "email": "erika.mustermann@acme-corp.de",
    "is_deputy": true
  }
}

Response-Felder

  • Name
    username
    Type
    string
    Description

    Eindeutiger Anmeldename des Abteilungsleiters.

  • Name
    firstname
    Type
    string
    Description

    Vorname des Abteilungsleiters.

  • Name
    lastname
    Type
    string
    Description

    Nachname des Abteilungsleiters.

  • Name
    personal_number
    Type
    string, nullable
    Description

    Personalnummer des Abteilungsleiters.

  • Name
    email
    Type
    string, nullable
    Description

    Geschäftliche E-Mail-Adresse des Abteilungsleiters.

  • Name
    is_deputy
    Type
    boolean
    Description

    Ob die Person Stellvertretung der Abteilungsleitung ist; nur das Lizenzmodul Inovex setzt den Wert, ein nicht gesetzter Wert wird als false geliefert.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.