{
    "openapi": "3.1.0",
    "info": {
        "title": "Pulsika API",
        "version": "1.0",
        "description": "Die Unternehmens-API von Pulsika. Jede Anfrage geht an die eigene Adresse Ihres Unternehmens, mit einem in Pulsika angelegten Schlüssel (Zugriff → API-Schlüssel)."
    },
    "servers": [
        {
            "url": "https://{company}.pulsika.eu/api/v1",
            "variables": {
                "company": {
                    "default": "compania-mea",
                    "description": "Die Adresse Ihres Unternehmens in Pulsika (der Teil vor .pulsika.eu)."
                }
            }
        }
    ],
    "security": [
        {
            "bearer": []
        }
    ],
    "paths": {
        "/geo-areas": {
            "get": {
                "tags": [
                    "Gebiete"
                ],
                "summary": "Liste: Gebiete",
                "security": [
                    {
                        "bearer": [
                            "geo_areas:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "parent_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die Gebiete direkt unter diesem."
                    },
                    {
                        "name": "roots",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur die obersten Gebiete."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/GeoAreas"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Gebiete"
                ],
                "summary": "Anlegen: Gebiete",
                "security": [
                    {
                        "bearer": [
                            "geo_areas:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/GeoAreasInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/GeoAreas"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/geo-areas/{id}": {
            "get": {
                "tags": [
                    "Gebiete"
                ],
                "summary": "Ein Eintrag: Gebiete",
                "security": [
                    {
                        "bearer": [
                            "geo_areas:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/GeoAreas"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Gebiete"
                ],
                "summary": "Ändern: Gebiete",
                "security": [
                    {
                        "bearer": [
                            "geo_areas:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/GeoAreasInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/GeoAreas"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Gebiete"
                ],
                "summary": "Löschen: Gebiete",
                "security": [
                    {
                        "bearer": [
                            "geo_areas:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/work-units": {
            "get": {
                "tags": [
                    "Standorte"
                ],
                "summary": "Liste: Standorte",
                "security": [
                    {
                        "bearer": [
                            "work_units:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "code",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "CJ01"
                        },
                        "description": "Genaues Kürzel (ohne Beachtung der Groß-/Kleinschreibung)."
                    },
                    {
                        "name": "geo_area_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur in diesem Gebiet."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/WorkUnits"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Standorte"
                ],
                "summary": "Anlegen: Standorte",
                "security": [
                    {
                        "bearer": [
                            "work_units:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/WorkUnitsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/WorkUnits"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/work-units/{id}": {
            "get": {
                "tags": [
                    "Standorte"
                ],
                "summary": "Ein Eintrag: Standorte",
                "security": [
                    {
                        "bearer": [
                            "work_units:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/WorkUnits"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Standorte"
                ],
                "summary": "Ändern: Standorte",
                "security": [
                    {
                        "bearer": [
                            "work_units:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/WorkUnitsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/WorkUnits"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Standorte"
                ],
                "summary": "Löschen: Standorte",
                "security": [
                    {
                        "bearer": [
                            "work_units:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/departments": {
            "get": {
                "tags": [
                    "Abteilungen"
                ],
                "summary": "Liste: Abteilungen",
                "security": [
                    {
                        "bearer": [
                            "departments:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "code",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "FARM"
                        },
                        "description": "Genaues Kürzel (ohne Beachtung der Groß-/Kleinschreibung)."
                    },
                    {
                        "name": "parent_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die Abteilungen direkt unter dieser."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Departments"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Abteilungen"
                ],
                "summary": "Anlegen: Abteilungen",
                "security": [
                    {
                        "bearer": [
                            "departments:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DepartmentsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Departments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/departments/{id}": {
            "get": {
                "tags": [
                    "Abteilungen"
                ],
                "summary": "Ein Eintrag: Abteilungen",
                "security": [
                    {
                        "bearer": [
                            "departments:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Departments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Abteilungen"
                ],
                "summary": "Ändern: Abteilungen",
                "security": [
                    {
                        "bearer": [
                            "departments:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DepartmentsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Departments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Abteilungen"
                ],
                "summary": "Löschen: Abteilungen",
                "security": [
                    {
                        "bearer": [
                            "departments:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/positions": {
            "get": {
                "tags": [
                    "Positionen"
                ],
                "summary": "Liste: Positionen",
                "security": [
                    {
                        "bearer": [
                            "positions:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "code",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "FA"
                        },
                        "description": "Genaues Kürzel (ohne Beachtung der Groß-/Kleinschreibung)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Positions"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Positionen"
                ],
                "summary": "Anlegen: Positionen",
                "security": [
                    {
                        "bearer": [
                            "positions:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PositionsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Positions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/positions/{id}": {
            "get": {
                "tags": [
                    "Positionen"
                ],
                "summary": "Ein Eintrag: Positionen",
                "security": [
                    {
                        "bearer": [
                            "positions:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Positions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Positionen"
                ],
                "summary": "Ändern: Positionen",
                "security": [
                    {
                        "bearer": [
                            "positions:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PositionsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Positions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Positionen"
                ],
                "summary": "Löschen: Positionen",
                "security": [
                    {
                        "bearer": [
                            "positions:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/teams": {
            "get": {
                "tags": [
                    "Teams"
                ],
                "summary": "Liste: Teams",
                "security": [
                    {
                        "bearer": [
                            "teams:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die Teams, in denen diese Person ist."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Teams"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Teams"
                ],
                "summary": "Anlegen: Teams",
                "security": [
                    {
                        "bearer": [
                            "teams:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/TeamsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Teams"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/teams/{id}": {
            "get": {
                "tags": [
                    "Teams"
                ],
                "summary": "Ein Eintrag: Teams",
                "security": [
                    {
                        "bearer": [
                            "teams:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Teams"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Teams"
                ],
                "summary": "Ändern: Teams",
                "security": [
                    {
                        "bearer": [
                            "teams:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/TeamsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Teams"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Teams"
                ],
                "summary": "Löschen: Teams",
                "security": [
                    {
                        "bearer": [
                            "teams:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/teams/{id}/add-member": {
            "post": {
                "tags": [
                    "Teams"
                ],
                "summary": "Fügt einen Mitarbeiter zum Team hinzu (nichts ändert sich, wenn sie schon dabei ist). Inhalt: {\"employee_id\": 345}.",
                "security": [
                    {
                        "bearer": [
                            "teams:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "employee_id": {
                                        "type": "integer",
                                        "example": 345,
                                        "description": "Die hinzuzufügende Person (eine ID aus /employees)."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Teams"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/teams/{id}/remove-member": {
            "post": {
                "tags": [
                    "Teams"
                ],
                "summary": "Entfernt einen Mitarbeiter aus dem Team. Inhalt: {\"employee_id\": 345}.",
                "security": [
                    {
                        "bearer": [
                            "teams:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "employee_id": {
                                        "type": "integer",
                                        "example": 345,
                                        "description": "Die zu entfernende Person (eine ID aus /employees)."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Teams"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/custom-fields": {
            "get": {
                "tags": [
                    "Eigene Felder"
                ],
                "summary": "Liste: Eigene Felder",
                "security": [
                    {
                        "bearer": [
                            "custom_fields:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "entity",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "employee",
                                "work_unit",
                                "department",
                                "position",
                                "team",
                                "company"
                            ],
                            "example": "employee"
                        },
                        "description": "Nur die Felder dieser Art von Eintrag."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CustomFields"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/custom-fields/{id}": {
            "get": {
                "tags": [
                    "Eigene Felder"
                ],
                "summary": "Ein Eintrag: Eigene Felder",
                "security": [
                    {
                        "bearer": [
                            "custom_fields:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CustomFields"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/employees": {
            "get": {
                "tags": [
                    "Mitarbeiter"
                ],
                "summary": "Liste: Mitarbeiter",
                "security": [
                    {
                        "bearer": [
                            "employees:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "active",
                                "inactive",
                                "terminated"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Derzeit diesem Standort zugeordnet."
                    },
                    {
                        "name": "employee_number",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Genaue Personalnummer."
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Genaue E-Mail."
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "popescu"
                        },
                        "description": "Teil des Namens."
                    },
                    {
                        "name": "hired_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Eingestellt ab diesem Datum (Y-m-d): neue Mitarbeitende."
                    },
                    {
                        "name": "leaving_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Austritt ab diesem Datum (Y-m-d): ein Austrittsdatum ist gesetzt."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Employees"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Mitarbeiter"
                ],
                "summary": "Anlegen: Mitarbeiter",
                "security": [
                    {
                        "bearer": [
                            "employees:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/EmployeesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Employees"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/employees/{id}": {
            "get": {
                "tags": [
                    "Mitarbeiter"
                ],
                "summary": "Ein Eintrag: Mitarbeiter",
                "security": [
                    {
                        "bearer": [
                            "employees:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Employees"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Mitarbeiter"
                ],
                "summary": "Ändern: Mitarbeiter",
                "security": [
                    {
                        "bearer": [
                            "employees:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/EmployeesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Employees"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Mitarbeiter"
                ],
                "summary": "Löschen: Mitarbeiter",
                "security": [
                    {
                        "bearer": [
                            "employees:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/placements": {
            "get": {
                "tags": [
                    "Zuordnungen"
                ],
                "summary": "Liste: Zuordnungen",
                "security": [
                    {
                        "bearer": [
                            "placements:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Person."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur an diesem Standort."
                    },
                    {
                        "name": "current",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur heute gültige Zuordnungen."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Placements"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Zuordnungen"
                ],
                "summary": "Anlegen: Zuordnungen",
                "security": [
                    {
                        "bearer": [
                            "placements:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PlacementsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Placements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/placements/{id}": {
            "get": {
                "tags": [
                    "Zuordnungen"
                ],
                "summary": "Ein Eintrag: Zuordnungen",
                "security": [
                    {
                        "bearer": [
                            "placements:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Placements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Zuordnungen"
                ],
                "summary": "Löschen: Zuordnungen",
                "security": [
                    {
                        "bearer": [
                            "placements:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/placements/{id}/end": {
            "post": {
                "tags": [
                    "Zuordnungen"
                ],
                "summary": "Beendet die Zuordnung am valid_to (nicht vor ihrem Beginn).",
                "security": [
                    {
                        "bearer": [
                            "placements:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "valid_to": {
                                        "type": "string",
                                        "format": "date",
                                        "example": "2026-06-30",
                                        "description": "Der letzte Tag der Zuordnung (Y-m-d)."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Placements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/placements/{id}/make-primary": {
            "post": {
                "tags": [
                    "Zuordnungen"
                ],
                "summary": "Macht sie zur Hauptzuordnung der Person; die bisherige Hauptzuordnung wird zur Nebenzuordnung.",
                "security": [
                    {
                        "bearer": [
                            "placements:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Placements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-types": {
            "get": {
                "tags": [
                    "Abwesenheitsarten"
                ],
                "summary": "Liste: Abwesenheitsarten",
                "security": [
                    {
                        "bearer": [
                            "leave_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaveTypes"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/leave-types/{id}": {
            "get": {
                "tags": [
                    "Abwesenheitsarten"
                ],
                "summary": "Ein Eintrag: Abwesenheitsarten",
                "security": [
                    {
                        "bearer": [
                            "leave_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-requests": {
            "get": {
                "tags": [
                    "Abwesenheitsanträge"
                ],
                "summary": "Liste: Abwesenheitsanträge",
                "security": [
                    {
                        "bearer": [
                            "leave_requests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Person."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "pending",
                                "approved",
                                "rejected",
                                "cancelled"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-07-01"
                        },
                        "description": "Berührt diesen Tag oder später."
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-07-31"
                        },
                        "description": "Berührt diesen Tag oder früher."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaveRequests"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Abwesenheitsanträge"
                ],
                "summary": "Anlegen: Abwesenheitsanträge",
                "security": [
                    {
                        "bearer": [
                            "leave_requests:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/LeaveRequestsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-requests/{id}": {
            "get": {
                "tags": [
                    "Abwesenheitsanträge"
                ],
                "summary": "Ein Eintrag: Abwesenheitsanträge",
                "security": [
                    {
                        "bearer": [
                            "leave_requests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-requests/{id}/approve": {
            "post": {
                "tags": [
                    "Abwesenheitsanträge"
                ],
                "summary": "Genehmigt den aktuellen Schritt (Kommentar optional).",
                "security": [
                    {
                        "bearer": [
                            "leave_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "comment": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 1000,
                                        "description": "Optionaler Kommentar für die Person."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-requests/{id}/reject": {
            "post": {
                "tags": [
                    "Abwesenheitsanträge"
                ],
                "summary": "Lehnt den Antrag ab; Kommentar (der Grund) erforderlich.",
                "security": [
                    {
                        "bearer": [
                            "leave_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "comment": {
                                        "type": "string",
                                        "maxLength": 1000,
                                        "description": "Der Grund, der Person angezeigt (erforderlich)."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-requests/{id}/cancel": {
            "post": {
                "tags": [
                    "Abwesenheitsanträge"
                ],
                "summary": "Storniert einen offenen oder genehmigten Antrag.",
                "security": [
                    {
                        "bearer": [
                            "leave_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/leave-balances": {
            "get": {
                "tags": [
                    "Urlaubskonten"
                ],
                "summary": "Liste: Urlaubskonten",
                "security": [
                    {
                        "bearer": [
                            "leave_balances:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "year",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "example": 2026
                        },
                        "description": "Das Jahr (Standard: dieses Jahr)."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Person."
                    },
                    {
                        "name": "leave_type_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Abwesenheitsart."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LeaveBalances"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/leave-balances/{id}": {
            "get": {
                "tags": [
                    "Urlaubskonten"
                ],
                "summary": "Ein Eintrag: Urlaubskonten",
                "security": [
                    {
                        "bearer": [
                            "leave_balances:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveBalances"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Urlaubskonten"
                ],
                "summary": "Ändern: Urlaubskonten",
                "security": [
                    {
                        "bearer": [
                            "leave_balances:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/LeaveBalancesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LeaveBalances"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/calendar-events": {
            "get": {
                "tags": [
                    "Kalendertermine"
                ],
                "summary": "Liste: Kalendertermine",
                "security": [
                    {
                        "bearer": [
                            "calendar_events:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-07-01"
                        },
                        "description": "Endet an diesem Tag oder später."
                    },
                    {
                        "name": "to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-07-31"
                        },
                        "description": "Beginnt an diesem Tag oder früher."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "cancelled",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur abgesagte; false: nur die übrigen."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CalendarEvents"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kalendertermine"
                ],
                "summary": "Anlegen: Kalendertermine",
                "security": [
                    {
                        "bearer": [
                            "calendar_events:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CalendarEventsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CalendarEvents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/calendar-events/{id}": {
            "get": {
                "tags": [
                    "Kalendertermine"
                ],
                "summary": "Ein Eintrag: Kalendertermine",
                "security": [
                    {
                        "bearer": [
                            "calendar_events:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CalendarEvents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kalendertermine"
                ],
                "summary": "Ändern: Kalendertermine",
                "security": [
                    {
                        "bearer": [
                            "calendar_events:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CalendarEventsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CalendarEvents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kalendertermine"
                ],
                "summary": "Löschen: Kalendertermine",
                "security": [
                    {
                        "bearer": [
                            "calendar_events:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/calendar-events/{id}/cancel": {
            "post": {
                "tags": [
                    "Kalendertermine"
                ],
                "summary": "Sagt diese Wiederholung ab; die Teilnehmenden werden informiert.",
                "security": [
                    {
                        "bearer": [
                            "calendar_events:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CalendarEvents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kpi-metrics": {
            "get": {
                "tags": [
                    "KPI-Kennzahlen"
                ],
                "summary": "Liste: KPI-Kennzahlen",
                "security": [
                    {
                        "bearer": [
                            "kpi_metrics:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "key",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "sales.actual"
                        },
                        "description": "Genauer Schlüssel (ohne Beachtung der Groß-/Kleinschreibung)."
                    },
                    {
                        "name": "source_type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "manual",
                                "import",
                                "module",
                                "derived",
                                "api",
                                "objective",
                                "review"
                            ]
                        },
                        "description": "Nur Kennzahlen mit dieser Quelle."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/KpiMetrics"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/kpi-metrics/{id}": {
            "get": {
                "tags": [
                    "KPI-Kennzahlen"
                ],
                "summary": "Ein Eintrag: KPI-Kennzahlen",
                "security": [
                    {
                        "bearer": [
                            "kpi_metrics:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/KpiMetrics"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/metric-values": {
            "get": {
                "tags": [
                    "KPI-Werte"
                ],
                "summary": "Liste: KPI-Werte",
                "security": [
                    {
                        "bearer": [
                            "metric_values:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "metric",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "sales.actual"
                        },
                        "description": "Nur die Werte dieser Kennzahl (ihr Schlüssel)."
                    },
                    {
                        "name": "period",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "2026-09"
                        },
                        "description": "Nur dieser Zeitraum (erfordert metric)."
                    },
                    {
                        "name": "subject_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieses Subjekt."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MetricValues"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "KPI-Werte"
                ],
                "summary": "Anlegen: KPI-Werte",
                "security": [
                    {
                        "bearer": [
                            "metric_values:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MetricValuesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MetricValues"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/metric-values/{id}": {
            "get": {
                "tags": [
                    "KPI-Werte"
                ],
                "summary": "Ein Eintrag: KPI-Werte",
                "security": [
                    {
                        "bearer": [
                            "metric_values:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MetricValues"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kpi-scorecards": {
            "get": {
                "tags": [
                    "KPI-Scorecards"
                ],
                "summary": "Liste: KPI-Scorecards",
                "security": [
                    {
                        "bearer": [
                            "kpi_scorecards:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "draft",
                                "published",
                                "archived"
                            ]
                        },
                        "description": "Nur Versionen mit diesem Status."
                    },
                    {
                        "name": "family",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Nur die Versionen dieser KPI-Scorecard."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/KpiScorecards"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/kpi-scorecards/{id}": {
            "get": {
                "tags": [
                    "KPI-Scorecards"
                ],
                "summary": "Ein Eintrag: KPI-Scorecards",
                "security": [
                    {
                        "bearer": [
                            "kpi_scorecards:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/KpiScorecards"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/kpi-results": {
            "get": {
                "tags": [
                    "KPI-Ergebnisse"
                ],
                "summary": "Liste: KPI-Ergebnisse",
                "security": [
                    {
                        "bearer": [
                            "kpi_results:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "scorecard_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Version der KPI-Scorecard."
                    },
                    {
                        "name": "period",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-09-01"
                        },
                        "description": "Erster Tag des Zeitraums (Y-m-d)."
                    },
                    {
                        "name": "subject_type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "employee",
                                "team",
                                "department",
                                "work_unit",
                                "geo_area",
                                "company"
                            ]
                        },
                        "description": "Nur diese Art von Subjekt."
                    },
                    {
                        "name": "subject_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieses Subjekt."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/KpiResults"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/kpi-results/{id}": {
            "get": {
                "tags": [
                    "KPI-Ergebnisse"
                ],
                "summary": "Ein Eintrag: KPI-Ergebnisse",
                "security": [
                    {
                        "bearer": [
                            "kpi_results:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/KpiResults"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/priorities": {
            "get": {
                "tags": [
                    "Prioritäten"
                ],
                "summary": "Liste: Prioritäten",
                "security": [
                    {
                        "bearer": [
                            "priorities:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "level",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "company",
                                "geo_area",
                                "work_unit",
                                "department",
                                "person"
                            ]
                        },
                        "description": "Nur diese Ebene."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "active",
                                "closed",
                                "cancelled"
                            ]
                        },
                        "description": "Nur dieser Status."
                    },
                    {
                        "name": "on",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-11-15"
                        },
                        "description": "Nur Prioritäten, die an diesem Tag laufen (Y-m-d)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Priorities"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/priorities/{id}": {
            "get": {
                "tags": [
                    "Prioritäten"
                ],
                "summary": "Ein Eintrag: Prioritäten",
                "security": [
                    {
                        "bearer": [
                            "priorities:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Priorities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/priorities/{id}/move": {
            "post": {
                "tags": [
                    "Prioritäten"
                ],
                "summary": "Ein von Hand verfolgtes Schlüsselergebnis bewegen: ein neuer Wert für eine Zahl, erreicht oder nicht für einen Schritt, mit optionaler Notiz.",
                "security": [
                    {
                        "bearer": [
                            "priorities:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "key_result_id": {
                                        "type": "integer",
                                        "example": 7,
                                        "description": "Das Schlüsselergebnis dieser Priorität."
                                    },
                                    "value": {
                                        "type": [
                                            "number",
                                            "null"
                                        ],
                                        "example": "8",
                                        "description": "Der neue Wert (ein Zahlen-Schlüsselergebnis)."
                                    },
                                    "done": {
                                        "type": [
                                            "boolean",
                                            "null"
                                        ],
                                        "description": "Erreicht oder nicht (ein Schritt)."
                                    },
                                    "note": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 1000,
                                        "description": "Warum es sich bewegt hat."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Priorities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/objectives": {
            "get": {
                "tags": [
                    "Ziele"
                ],
                "summary": "Liste: Ziele",
                "security": [
                    {
                        "bearer": [
                            "objectives:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "rule_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur unter dieser Regel."
                    },
                    {
                        "name": "period_start",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-09-01"
                        },
                        "description": "Erster Tag des Zeitraums (Y-m-d)."
                    },
                    {
                        "name": "external_ref",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Ihre genaue Referenz."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Objectives"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Ziele"
                ],
                "summary": "Anlegen: Ziele",
                "security": [
                    {
                        "bearer": [
                            "objectives:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ObjectivesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Objectives"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/objectives/{id}": {
            "get": {
                "tags": [
                    "Ziele"
                ],
                "summary": "Ein Eintrag: Ziele",
                "security": [
                    {
                        "bearer": [
                            "objectives:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Objectives"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Ziele"
                ],
                "summary": "Ändern: Ziele",
                "security": [
                    {
                        "bearer": [
                            "objectives:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ObjectivesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Objectives"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Ziele"
                ],
                "summary": "Löschen: Ziele",
                "security": [
                    {
                        "bearer": [
                            "objectives:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/objectives/{id}/record": {
            "post": {
                "tags": [
                    "Ziele"
                ],
                "summary": "Erfasst, was Subjekte erreicht haben: Ihre Messwerte ersetzen das bisher Erfasste; leere Messwerte verwerfen es (wieder keine Daten).",
                "security": [
                    {
                        "bearer": [
                            "objectives:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "achievements": {
                                        "type": "array",
                                        "items": {
                                            "type": "object"
                                        },
                                        "example": [
                                            {
                                                "subject_id": 345,
                                                "measures": {
                                                    "pieces": "34"
                                                }
                                            }
                                        ],
                                        "description": "Eine Liste von {subject_id, measures: {Name des Messwerts: Zahl}}; Subjekte auf der Ebene der Regel, in den Standorten mit Zielwert."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Objectives"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/reviews": {
            "get": {
                "tags": [
                    "Beurteilungen"
                ],
                "summary": "Liste: Beurteilungen",
                "security": [
                    {
                        "bearer": [
                            "reviews:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "submitted",
                                "cancelled"
                            ]
                        },
                        "description": "submitted oder cancelled."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Person."
                    },
                    {
                        "name": "form_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Version des Bogens."
                    },
                    {
                        "name": "period_start",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-09-01"
                        },
                        "description": "Erster Tag des Zeitraums (Y-m-d)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Reviews"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/reviews/{id}": {
            "get": {
                "tags": [
                    "Beurteilungen"
                ],
                "summary": "Ein Eintrag: Beurteilungen",
                "security": [
                    {
                        "bearer": [
                            "reviews:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Reviews"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contests": {
            "get": {
                "tags": [
                    "Wettbewerbe"
                ],
                "summary": "Liste: Wettbewerbe",
                "security": [
                    {
                        "bearer": [
                            "contests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Nur mit diesem Status."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Contests"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/contests/{id}": {
            "get": {
                "tags": [
                    "Wettbewerbe"
                ],
                "summary": "Ein Eintrag: Wettbewerbe",
                "security": [
                    {
                        "bearer": [
                            "contests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Contests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contest-results": {
            "get": {
                "tags": [
                    "Wettbewerbsergebnisse"
                ],
                "summary": "Liste: Wettbewerbsergebnisse",
                "security": [
                    {
                        "bearer": [
                            "contest_results:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "contest_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieses Wettbewerbs."
                    },
                    {
                        "name": "wins",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur Gewinner."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ContestResults"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/contest-results/{id}": {
            "get": {
                "tags": [
                    "Wettbewerbsergebnisse"
                ],
                "summary": "Ein Eintrag: Wettbewerbsergebnisse",
                "security": [
                    {
                        "bearer": [
                            "contest_results:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ContestResults"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contest-awards": {
            "get": {
                "tags": [
                    "Wettbewerbspreise"
                ],
                "summary": "Liste: Wettbewerbspreise",
                "security": [
                    {
                        "bearer": [
                            "contest_awards:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "contest_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieses Wettbewerbs."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Person."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Nur mit diesem Status."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ContestAwards"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/contest-awards/{id}": {
            "get": {
                "tags": [
                    "Wettbewerbspreise"
                ],
                "summary": "Ein Eintrag: Wettbewerbspreise",
                "security": [
                    {
                        "bearer": [
                            "contest_awards:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ContestAwards"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contest-awards/{id}/deliver": {
            "post": {
                "tags": [
                    "Wettbewerbspreise"
                ],
                "summary": "Den Preis als übergeben markieren.",
                "security": [
                    {
                        "bearer": [
                            "contest_awards:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ContestAwards"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contest-rewards": {
            "get": {
                "tags": [
                    "Preiskatalog"
                ],
                "summary": "Liste: Preiskatalog",
                "security": [
                    {
                        "bearer": [
                            "contest_rewards:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "kind",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Nur dieser Art."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur aktive."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ContestRewards"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Preiskatalog"
                ],
                "summary": "Anlegen: Preiskatalog",
                "security": [
                    {
                        "bearer": [
                            "contest_rewards:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ContestRewardsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ContestRewards"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/contest-rewards/{id}": {
            "get": {
                "tags": [
                    "Preiskatalog"
                ],
                "summary": "Ein Eintrag: Preiskatalog",
                "security": [
                    {
                        "bearer": [
                            "contest_rewards:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ContestRewards"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Preiskatalog"
                ],
                "summary": "Ändern: Preiskatalog",
                "security": [
                    {
                        "bearer": [
                            "contest_rewards:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ContestRewardsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ContestRewards"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/courses": {
            "get": {
                "tags": [
                    "Kurse"
                ],
                "summary": "Liste: Kurse",
                "security": [
                    {
                        "bearer": [
                            "courses:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "draft",
                                "published",
                                "archived"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "category_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur in dieser Kategorie."
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "incendiu"
                        },
                        "description": "Teil des Titels."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Courses"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kurse"
                ],
                "summary": "Anlegen: Kurse",
                "security": [
                    {
                        "bearer": [
                            "courses:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CoursesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Courses"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/courses/{id}": {
            "get": {
                "tags": [
                    "Kurse"
                ],
                "summary": "Ein Eintrag: Kurse",
                "security": [
                    {
                        "bearer": [
                            "courses:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Courses"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kurse"
                ],
                "summary": "Ändern: Kurse",
                "security": [
                    {
                        "bearer": [
                            "courses:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CoursesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Courses"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kurse"
                ],
                "summary": "Löschen: Kurse",
                "security": [
                    {
                        "bearer": [
                            "courses:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/learning-assignments": {
            "get": {
                "tags": [
                    "Zuweisungen von Weiterbildung"
                ],
                "summary": "Liste: Zuweisungen von Weiterbildung",
                "security": [
                    {
                        "bearer": [
                            "learning_assignments:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "course_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur für diesen Kurs."
                    },
                    {
                        "name": "test_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur für diesen Test."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/LearningAssignments"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Zuweisungen von Weiterbildung"
                ],
                "summary": "Anlegen: Zuweisungen von Weiterbildung",
                "security": [
                    {
                        "bearer": [
                            "learning_assignments:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/LearningAssignmentsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LearningAssignments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/learning-assignments/{id}": {
            "get": {
                "tags": [
                    "Zuweisungen von Weiterbildung"
                ],
                "summary": "Ein Eintrag: Zuweisungen von Weiterbildung",
                "security": [
                    {
                        "bearer": [
                            "learning_assignments:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/LearningAssignments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Zuweisungen von Weiterbildung"
                ],
                "summary": "Löschen: Zuweisungen von Weiterbildung",
                "security": [
                    {
                        "bearer": [
                            "learning_assignments:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/enrollments": {
            "get": {
                "tags": [
                    "Einschreibungen"
                ],
                "summary": "Liste: Einschreibungen",
                "security": [
                    {
                        "bearer": [
                            "enrollments:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Person."
                    },
                    {
                        "name": "course_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Kurs."
                    },
                    {
                        "name": "test_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Test."
                    },
                    {
                        "name": "assignment_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Zuweisung."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "assigned",
                                "in_progress",
                                "awaiting_grading",
                                "completed",
                                "failed",
                                "excused"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "completed_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Abgeschlossen ab diesem Datum (Y-m-d)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Enrollments"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/enrollments/{id}": {
            "get": {
                "tags": [
                    "Einschreibungen"
                ],
                "summary": "Ein Eintrag: Einschreibungen",
                "security": [
                    {
                        "bearer": [
                            "enrollments:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Enrollments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/enrollments/{id}/extend": {
            "post": {
                "tags": [
                    "Einschreibungen"
                ],
                "summary": "Eine spätere Fälligkeit festlegen.",
                "security": [
                    {
                        "bearer": [
                            "enrollments:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "due_on": {
                                        "type": "string",
                                        "format": "date",
                                        "example": "2026-06-30",
                                        "description": "Die neue Fälligkeit, nicht vor Öffnung der Einschreibung."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Enrollments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/enrollments/{id}/grant-attempt": {
            "post": {
                "tags": [
                    "Einschreibungen"
                ],
                "summary": "Einen weiteren Testversuch erlauben (nicht nach dem Bestehen).",
                "security": [
                    {
                        "bearer": [
                            "enrollments:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Enrollments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/enrollments/{id}/excuse": {
            "post": {
                "tags": [
                    "Einschreibungen"
                ],
                "summary": "Die Person befreien (nur bevor sie begonnen hat).",
                "security": [
                    {
                        "bearer": [
                            "enrollments:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Enrollments"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/certificates": {
            "get": {
                "tags": [
                    "Zertifikate"
                ],
                "summary": "Liste: Zertifikate",
                "security": [
                    {
                        "bearer": [
                            "certificates:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Person."
                    },
                    {
                        "name": "course_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Kurs."
                    },
                    {
                        "name": "issued_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Ausgestellt ab diesem Datum (Y-m-d)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Certificates"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/certificates/{id}": {
            "get": {
                "tags": [
                    "Zertifikate"
                ],
                "summary": "Ein Eintrag: Zertifikate",
                "security": [
                    {
                        "bearer": [
                            "certificates:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Certificates"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/audits": {
            "get": {
                "tags": [
                    "Audits"
                ],
                "summary": "Liste: Audits",
                "security": [
                    {
                        "bearer": [
                            "audits:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Standort."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "draft",
                                "completed"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "conducted_from",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Am oder nach diesem Datum durchgeführt."
                    },
                    {
                        "name": "conducted_to",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Am oder vor diesem Datum durchgeführt."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Audits"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/audits/{id}": {
            "get": {
                "tags": [
                    "Audits"
                ],
                "summary": "Ein Eintrag: Audits",
                "security": [
                    {
                        "bearer": [
                            "audits:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Audits"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/audit-action-plans": {
            "get": {
                "tags": [
                    "Maßnahmenpläne aus Audits"
                ],
                "summary": "Liste: Maßnahmenpläne aus Audits",
                "security": [
                    {
                        "bearer": [
                            "audit_action_plans:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "audit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur für dieses Audit."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "open",
                                "done",
                                "verified",
                                "cancelled"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "responsible_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur für diese Person."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/AuditActionPlans"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/audit-action-plans/{id}": {
            "get": {
                "tags": [
                    "Maßnahmenpläne aus Audits"
                ],
                "summary": "Ein Eintrag: Maßnahmenpläne aus Audits",
                "security": [
                    {
                        "bearer": [
                            "audit_action_plans:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/AuditActionPlans"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/audit-action-plans/{id}/mark-done": {
            "post": {
                "tags": [
                    "Maßnahmenpläne aus Audits"
                ],
                "summary": "Eine offene Maßnahme als erledigt markieren.",
                "security": [
                    {
                        "bearer": [
                            "audit_action_plans:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "note": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 2000,
                                        "description": "Was getan wurde."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/AuditActionPlans"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/audit-action-plans/{id}/verify": {
            "post": {
                "tags": [
                    "Maßnahmenpläne aus Audits"
                ],
                "summary": "Eine erledigte Maßnahme annehmen.",
                "security": [
                    {
                        "bearer": [
                            "audit_action_plans:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/AuditActionPlans"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/audit-action-plans/{id}/reopen": {
            "post": {
                "tags": [
                    "Maßnahmenpläne aus Audits"
                ],
                "summary": "Eine erledigte Maßnahme mit Grund zurückschicken.",
                "security": [
                    {
                        "bearer": [
                            "audit_action_plans:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "reason": {
                                        "type": "string",
                                        "maxLength": 2000,
                                        "description": "Warum sie nicht angenommen wird."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/AuditActionPlans"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/audit-action-plans/{id}/cancel": {
            "post": {
                "tags": [
                    "Maßnahmenpläne aus Audits"
                ],
                "summary": "Eine offene oder erledigte Maßnahme stornieren.",
                "security": [
                    {
                        "bearer": [
                            "audit_action_plans:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/AuditActionPlans"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ssm-types": {
            "get": {
                "tags": [
                    "Arbeitsschutzarten"
                ],
                "summary": "Liste: Arbeitsschutzarten",
                "security": [
                    {
                        "bearer": [
                            "ssm_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SsmTypes"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/ssm-types/{id}": {
            "get": {
                "tags": [
                    "Arbeitsschutzarten"
                ],
                "summary": "Ein Eintrag: Arbeitsschutzarten",
                "security": [
                    {
                        "bearer": [
                            "ssm_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SsmTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ssm-records": {
            "get": {
                "tags": [
                    "Arbeitsschutz-Nachweise"
                ],
                "summary": "Liste: Arbeitsschutz-Nachweise",
                "security": [
                    {
                        "bearer": [
                            "ssm_records:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Person."
                    },
                    {
                        "name": "type_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Art."
                    },
                    {
                        "name": "valid_until_before",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-12-31"
                        },
                        "description": "Gültig bis zu diesem Datum oder früher."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SsmRecords"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Arbeitsschutz-Nachweise"
                ],
                "summary": "Anlegen: Arbeitsschutz-Nachweise",
                "security": [
                    {
                        "bearer": [
                            "ssm_records:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SsmRecordsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SsmRecords"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/ssm-records/{id}": {
            "get": {
                "tags": [
                    "Arbeitsschutz-Nachweise"
                ],
                "summary": "Ein Eintrag: Arbeitsschutz-Nachweise",
                "security": [
                    {
                        "bearer": [
                            "ssm_records:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SsmRecords"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Arbeitsschutz-Nachweise"
                ],
                "summary": "Löschen: Arbeitsschutz-Nachweise",
                "security": [
                    {
                        "bearer": [
                            "ssm_records:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/document-categories": {
            "get": {
                "tags": [
                    "Dokumentkategorien"
                ],
                "summary": "Liste: Dokumentkategorien",
                "security": [
                    {
                        "bearer": [
                            "document_categories:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "scope",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "company",
                                "unit"
                            ]
                        },
                        "description": "Nur Unternehmens- oder nur Standortkategorien."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/DocumentCategories"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/document-categories/{id}": {
            "get": {
                "tags": [
                    "Dokumentkategorien"
                ],
                "summary": "Ein Eintrag: Dokumentkategorien",
                "security": [
                    {
                        "bearer": [
                            "document_categories:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/DocumentCategories"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/documents": {
            "get": {
                "tags": [
                    "Dokumente"
                ],
                "summary": "Liste: Dokumente",
                "security": [
                    {
                        "bearer": [
                            "documents:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die Dokumente dieses Standorts."
                    },
                    {
                        "name": "category_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Kategorie."
                    },
                    {
                        "name": "company",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur Unternehmensdokumente; false: nur Standortdokumente."
                    },
                    {
                        "name": "expires_before",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date",
                            "example": "2026-12-31"
                        },
                        "description": "Läuft an oder vor diesem Datum ab."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Documents"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Dokumente"
                ],
                "summary": "Anlegen: Dokumente",
                "security": [
                    {
                        "bearer": [
                            "documents:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DocumentsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Documents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/documents/{id}": {
            "get": {
                "tags": [
                    "Dokumente"
                ],
                "summary": "Ein Eintrag: Dokumente",
                "security": [
                    {
                        "bearer": [
                            "documents:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Documents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Dokumente"
                ],
                "summary": "Ändern: Dokumente",
                "security": [
                    {
                        "bearer": [
                            "documents:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DocumentsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Documents"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Dokumente"
                ],
                "summary": "Löschen: Dokumente",
                "security": [
                    {
                        "bearer": [
                            "documents:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/service-categories": {
            "get": {
                "tags": [
                    "Servicekategorien"
                ],
                "summary": "Liste: Servicekategorien",
                "security": [
                    {
                        "bearer": [
                            "service_categories:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ServiceCategories"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/service-categories/{id}": {
            "get": {
                "tags": [
                    "Servicekategorien"
                ],
                "summary": "Ein Eintrag: Servicekategorien",
                "security": [
                    {
                        "bearer": [
                            "service_categories:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ServiceCategories"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/service-requests": {
            "get": {
                "tags": [
                    "Serviceanfragen"
                ],
                "summary": "Liste: Serviceanfragen",
                "security": [
                    {
                        "bearer": [
                            "service_requests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "awaiting_approval",
                                "open",
                                "in_progress",
                                "resolved",
                                "unresolved",
                                "rejected",
                                "cancelled"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "category_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur diese Kategorie."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Standort."
                    },
                    {
                        "name": "closed_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Abgeschlossen ab diesem Datum (Y-m-d)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ServiceRequests"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Serviceanfragen"
                ],
                "summary": "Anlegen: Serviceanfragen",
                "security": [
                    {
                        "bearer": [
                            "service_requests:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ServiceRequestsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ServiceRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/service-requests/{id}": {
            "get": {
                "tags": [
                    "Serviceanfragen"
                ],
                "summary": "Ein Eintrag: Serviceanfragen",
                "security": [
                    {
                        "bearer": [
                            "service_requests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ServiceRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/service-requests/{id}/move": {
            "post": {
                "tags": [
                    "Serviceanfragen"
                ],
                "summary": "Die Anfrage in einen anderen Status bringen (in_progress, resolved, unresolved, open, cancelled), wie es die Person darf, die den Schlüssel angelegt hat. unresolved und Wiederöffnen brauchen einen Kommentar.",
                "security": [
                    {
                        "bearer": [
                            "service_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "status": {
                                        "type": "string",
                                        "enum": [
                                            "awaiting_approval",
                                            "open",
                                            "in_progress",
                                            "resolved",
                                            "unresolved",
                                            "rejected",
                                            "cancelled"
                                        ],
                                        "description": "Der neue Status."
                                    },
                                    "comment": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 2000,
                                        "description": "Warum (erforderlich bei unresolved und beim Wiederöffnen)."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ServiceRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/materials": {
            "get": {
                "tags": [
                    "Material"
                ],
                "summary": "Liste: Material",
                "security": [
                    {
                        "bearer": [
                            "materials:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Materials"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/materials/{id}": {
            "get": {
                "tags": [
                    "Material"
                ],
                "summary": "Ein Eintrag: Material",
                "security": [
                    {
                        "bearer": [
                            "materials:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Materials"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/material-requests": {
            "get": {
                "tags": [
                    "Materialanfragen"
                ],
                "summary": "Liste: Materialanfragen",
                "security": [
                    {
                        "bearer": [
                            "material_requests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "new",
                                "taken",
                                "completed",
                                "cancelled"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Standort."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MaterialRequests"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Materialanfragen"
                ],
                "summary": "Anlegen: Materialanfragen",
                "security": [
                    {
                        "bearer": [
                            "material_requests:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MaterialRequestsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MaterialRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/material-requests/{id}": {
            "get": {
                "tags": [
                    "Materialanfragen"
                ],
                "summary": "Ein Eintrag: Materialanfragen",
                "security": [
                    {
                        "bearer": [
                            "material_requests:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MaterialRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/material-requests/{id}/take": {
            "post": {
                "tags": [
                    "Materialanfragen"
                ],
                "summary": "Eine neue Anfrage zur Bearbeitung übernehmen.",
                "security": [
                    {
                        "bearer": [
                            "material_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MaterialRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/material-requests/{id}/complete": {
            "post": {
                "tags": [
                    "Materialanfragen"
                ],
                "summary": "Abschließen: Der Bestand geführter Materialien sinkt.",
                "security": [
                    {
                        "bearer": [
                            "material_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MaterialRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/material-requests/{id}/cancel": {
            "post": {
                "tags": [
                    "Materialanfragen"
                ],
                "summary": "Eine noch nicht abgeschlossene Anfrage stornieren.",
                "security": [
                    {
                        "bearer": [
                            "material_requests:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MaterialRequests"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/surveys": {
            "get": {
                "tags": [
                    "Umfragen"
                ],
                "summary": "Liste: Umfragen",
                "security": [
                    {
                        "bearer": [
                            "surveys:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "published",
                                "closed"
                            ]
                        },
                        "description": "published oder closed."
                    },
                    {
                        "name": "is_anonymous",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Surveys"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/surveys/{id}": {
            "get": {
                "tags": [
                    "Umfragen"
                ],
                "summary": "Ein Eintrag: Umfragen",
                "security": [
                    {
                        "bearer": [
                            "surveys:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Surveys"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/survey-responses": {
            "get": {
                "tags": [
                    "Antworten auf Umfragen"
                ],
                "summary": "Liste: Antworten auf Umfragen",
                "security": [
                    {
                        "bearer": [
                            "survey_responses:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "survey_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die Antworten dieser Umfrage."
                    },
                    {
                        "name": "employee_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die Antworten dieser Person."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SurveyResponses"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/survey-responses/{id}": {
            "get": {
                "tags": [
                    "Antworten auf Umfragen"
                ],
                "summary": "Ein Eintrag: Antworten auf Umfragen",
                "security": [
                    {
                        "bearer": [
                            "survey_responses:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SurveyResponses"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/posts": {
            "get": {
                "tags": [
                    "Beiträge"
                ],
                "summary": "Liste: Beiträge",
                "security": [
                    {
                        "bearer": [
                            "posts:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "post",
                                "news",
                                "announcement",
                                "promotion",
                                "contest"
                            ]
                        },
                        "description": "Nur diese Art."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/Posts"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Beiträge"
                ],
                "summary": "Anlegen: Beiträge",
                "security": [
                    {
                        "bearer": [
                            "posts:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/PostsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Posts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/posts/{id}": {
            "get": {
                "tags": [
                    "Beiträge"
                ],
                "summary": "Ein Eintrag: Beiträge",
                "security": [
                    {
                        "bearer": [
                            "posts:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/Posts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/knowledge-articles": {
            "get": {
                "tags": [
                    "Artikel der Wissensdatenbank"
                ],
                "summary": "Liste: Artikel der Wissensdatenbank",
                "security": [
                    {
                        "bearer": [
                            "knowledge_articles:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "category_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieses Thema."
                    },
                    {
                        "name": "is_featured",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true oder false."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/KnowledgeArticles"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/knowledge-articles/{id}": {
            "get": {
                "tags": [
                    "Artikel der Wissensdatenbank"
                ],
                "summary": "Ein Eintrag: Artikel der Wissensdatenbank",
                "security": [
                    {
                        "bearer": [
                            "knowledge_articles:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/KnowledgeArticles"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-contacts": {
            "get": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Liste: Kunden",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Name, E-Mail oder Telefon enthält dies."
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Genau diese E-Mail (Groß-/Kleinschreibung egal)."
                    },
                    {
                        "name": "phone",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Diese Telefonnummer (nur die Ziffern werden verglichen)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "lead",
                                "customer",
                                "inactive"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "owner_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kontos."
                    },
                    {
                        "name": "account_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Organisation."
                    },
                    {
                        "name": "tag",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Nur mit diesem Schlagwort."
                    },
                    {
                        "name": "consent",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur wer Marketing zustimmt; false: nur wer nicht zustimmt."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CrmContacts"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Anlegen: Kunden",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmContactsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmContacts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-contacts/{id}": {
            "get": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Ein Eintrag: Kunden",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmContacts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Ändern: Kunden",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmContactsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmContacts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Löschen: Kunden",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-contacts/{id}/consent": {
            "post": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Erfassen, dass die Person ihre Marketing-Einwilligung erteilt oder widerrufen hat, und wie.",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "granted": {
                                        "type": "boolean",
                                        "example": true,
                                        "description": "true: erteilt; false: widerrufen."
                                    },
                                    "channel": {
                                        "type": "string",
                                        "enum": [
                                            "form",
                                            "verbal",
                                            "email",
                                            "import",
                                            "api",
                                            "other"
                                        ],
                                        "example": "api",
                                        "description": "Wie: form, verbal, email, import, api oder other (weggelassen: api)."
                                    },
                                    "note": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255,
                                        "description": "Eine Notiz (zum Beispiel, wo das Formular aufbewahrt wird)."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmContacts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-contacts/{id}/erase": {
            "post": {
                "tags": [
                    "Kunden"
                ],
                "summary": "Die Daten der Person auf ihren Wunsch löschen (DSGVO). Nicht umkehrbar.",
                "security": [
                    {
                        "bearer": [
                            "crm_contacts:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmContacts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-accounts": {
            "get": {
                "tags": [
                    "Kundenorganisationen"
                ],
                "summary": "Liste: Kundenorganisationen",
                "security": [
                    {
                        "bearer": [
                            "crm_accounts:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Name enthält dies."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "owner_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kontos."
                    },
                    {
                        "name": "tag",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Nur mit diesem Schlagwort."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CrmAccounts"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kundenorganisationen"
                ],
                "summary": "Anlegen: Kundenorganisationen",
                "security": [
                    {
                        "bearer": [
                            "crm_accounts:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmAccountsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmAccounts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-accounts/{id}": {
            "get": {
                "tags": [
                    "Kundenorganisationen"
                ],
                "summary": "Ein Eintrag: Kundenorganisationen",
                "security": [
                    {
                        "bearer": [
                            "crm_accounts:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmAccounts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kundenorganisationen"
                ],
                "summary": "Ändern: Kundenorganisationen",
                "security": [
                    {
                        "bearer": [
                            "crm_accounts:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmAccountsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmAccounts"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kundenorganisationen"
                ],
                "summary": "Löschen: Kundenorganisationen",
                "security": [
                    {
                        "bearer": [
                            "crm_accounts:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-pipelines": {
            "get": {
                "tags": [
                    "Vertriebspipelines"
                ],
                "summary": "Liste: Vertriebspipelines",
                "security": [
                    {
                        "bearer": [
                            "crm_pipelines:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CrmPipelines"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/crm-pipelines/{id}": {
            "get": {
                "tags": [
                    "Vertriebspipelines"
                ],
                "summary": "Ein Eintrag: Vertriebspipelines",
                "security": [
                    {
                        "bearer": [
                            "crm_pipelines:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmPipelines"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-deals": {
            "get": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Liste: Verkaufschancen",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "open",
                                "won",
                                "lost"
                            ]
                        },
                        "description": "Nur offene, gewonnene oder verlorene."
                    },
                    {
                        "name": "pipeline_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Pipeline."
                    },
                    {
                        "name": "stage_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur in dieser Phase."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "owner_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kontos."
                    },
                    {
                        "name": "contact_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kunden."
                    },
                    {
                        "name": "account_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Organisation."
                    },
                    {
                        "name": "closed_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "An oder nach diesem Datum abgeschlossen."
                    },
                    {
                        "name": "closed_until",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "An oder vor diesem Datum abgeschlossen."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CrmDeals"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Anlegen: Verkaufschancen",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmDealsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-deals/{id}": {
            "get": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Ein Eintrag: Verkaufschancen",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Ändern: Verkaufschancen",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmDealsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Löschen: Verkaufschancen",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-deals/{id}/move": {
            "post": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Die Verkaufschance in eine andere Phase verschieben (ihrer Pipeline oder einer anderen – die Verkaufschance wechselt mit).",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "stage_id": {
                                        "type": "integer",
                                        "example": 4,
                                        "description": "Die Zielphase."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-deals/{id}/win": {
            "post": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Die Verkaufschance als gewonnen markieren (die Gewinnphase ihrer Pipeline).",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-deals/{id}/lose": {
            "post": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Die Verkaufschance als verloren markieren (die Verlustphase ihrer Pipeline), mit Grund.",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "lost_reason": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 255,
                                        "example": "Price",
                                        "description": "Warum sie verloren ging."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-deals/{id}/reopen": {
            "post": {
                "tags": [
                    "Verkaufschancen"
                ],
                "summary": "Eine abgeschlossene Verkaufschance in die letzte offene Phase ihrer Pipeline zurückholen.",
                "security": [
                    {
                        "bearer": [
                            "crm_deals:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmDeals"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-activities": {
            "get": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Liste: Kundenaktivitäten",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "call",
                                "meeting",
                                "visit",
                                "email",
                                "task",
                                "note",
                                "purchase"
                            ]
                        },
                        "description": "Nur diese Art."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "owner_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kontos."
                    },
                    {
                        "name": "contact_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kunden."
                    },
                    {
                        "name": "deal_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Verkaufschance."
                    },
                    {
                        "name": "done",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur erledigte; false: nur noch offene."
                    },
                    {
                        "name": "due_before",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Fällig vor diesem Zeitpunkt."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CrmActivities"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Anlegen: Kundenaktivitäten",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmActivitiesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmActivities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-activities/{id}": {
            "get": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Ein Eintrag: Kundenaktivitäten",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmActivities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Ändern: Kundenaktivitäten",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmActivitiesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmActivities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Löschen: Kundenaktivitäten",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-activities/{id}/complete": {
            "post": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Eine Aufgabe als erledigt markieren (jetzt).",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmActivities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-activities/{id}/reopen": {
            "post": {
                "tags": [
                    "Kundenaktivitäten"
                ],
                "summary": "Sie wieder als offen markieren (nicht bei Käufen).",
                "security": [
                    {
                        "bearer": [
                            "crm_activities:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmActivities"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-feedback": {
            "get": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Liste: Kundenfeedback",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "kind",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "feedback",
                                "complaint"
                            ]
                        },
                        "description": "Nur Feedback oder nur Reklamationen."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "open",
                                "resolved"
                            ]
                        },
                        "description": "Nur offene oder nur erledigte."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "contact_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Kunden."
                    },
                    {
                        "name": "received_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "An oder nach diesem Datum eingegangen."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/CrmFeedback"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Anlegen: Kundenfeedback",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmFeedbackInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmFeedback"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-feedback/{id}": {
            "get": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Ein Eintrag: Kundenfeedback",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmFeedback"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Ändern: Kundenfeedback",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CrmFeedbackInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmFeedback"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Löschen: Kundenfeedback",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-feedback/{id}/resolve": {
            "post": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Eine Reklamation erledigen, mit Angabe des Getanen.",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "resolution": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 5000,
                                        "example": "Called the customer and refunded the delivery.",
                                        "description": "Was getan wurde."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmFeedback"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/crm-feedback/{id}/reopen": {
            "post": {
                "tags": [
                    "Kundenfeedback"
                ],
                "summary": "Eine erledigte Reklamation wieder öffnen.",
                "security": [
                    {
                        "bearer": [
                            "crm_feedback:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/CrmFeedback"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-partners": {
            "get": {
                "tags": [
                    "Partner"
                ],
                "summary": "Liste: Partner",
                "security": [
                    {
                        "bearer": [
                            "merch_partners:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        },
                        "description": "Name enthält den Text."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur aktive; false: nur inaktive."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MerchPartners"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Partner"
                ],
                "summary": "Anlegen: Partner",
                "security": [
                    {
                        "bearer": [
                            "merch_partners:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MerchPartnersInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchPartners"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-partners/{id}": {
            "get": {
                "tags": [
                    "Partner"
                ],
                "summary": "Ein Eintrag: Partner",
                "security": [
                    {
                        "bearer": [
                            "merch_partners:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchPartners"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Partner"
                ],
                "summary": "Ändern: Partner",
                "security": [
                    {
                        "bearer": [
                            "merch_partners:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MerchPartnersInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchPartners"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/space-zone-types": {
            "get": {
                "tags": [
                    "Zonenarten"
                ],
                "summary": "Liste: Zonenarten",
                "security": [
                    {
                        "bearer": [
                            "space_zone_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur in Verwendung; false: nur ausgemustert."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SpaceZoneTypes"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Zonenarten"
                ],
                "summary": "Anlegen: Zonenarten",
                "security": [
                    {
                        "bearer": [
                            "space_zone_types:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SpaceZoneTypesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SpaceZoneTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/space-zone-types/{id}": {
            "get": {
                "tags": [
                    "Zonenarten"
                ],
                "summary": "Ein Eintrag: Zonenarten",
                "security": [
                    {
                        "bearer": [
                            "space_zone_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SpaceZoneTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Zonenarten"
                ],
                "summary": "Ändern: Zonenarten",
                "security": [
                    {
                        "bearer": [
                            "space_zone_types:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SpaceZoneTypesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SpaceZoneTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/space-zones": {
            "get": {
                "tags": [
                    "Zonen an Standorten"
                ],
                "summary": "Liste: Zonen an Standorten",
                "security": [
                    {
                        "bearer": [
                            "space_zones:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Standorts."
                    },
                    {
                        "name": "zone_type_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieser Art."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "active",
                                "unavailable"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "is_display",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur Präsentationsflächen."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/SpaceZones"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Zonen an Standorten"
                ],
                "summary": "Anlegen: Zonen an Standorten",
                "security": [
                    {
                        "bearer": [
                            "space_zones:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SpaceZonesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SpaceZones"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/space-zones/{id}": {
            "get": {
                "tags": [
                    "Zonen an Standorten"
                ],
                "summary": "Ein Eintrag: Zonen an Standorten",
                "security": [
                    {
                        "bearer": [
                            "space_zones:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SpaceZones"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Zonen an Standorten"
                ],
                "summary": "Ändern: Zonen an Standorten",
                "security": [
                    {
                        "bearer": [
                            "space_zones:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/SpaceZonesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/SpaceZones"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Zonen an Standorten"
                ],
                "summary": "Löschen: Zonen an Standorten",
                "security": [
                    {
                        "bearer": [
                            "space_zones:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/shelf-fixture-types": {
            "get": {
                "tags": [
                    "Möbel und Preise"
                ],
                "summary": "Liste: Möbel und Preise",
                "security": [
                    {
                        "bearer": [
                            "shelf_fixture_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur in Verwendung."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ShelfFixtureTypes"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Möbel und Preise"
                ],
                "summary": "Anlegen: Möbel und Preise",
                "security": [
                    {
                        "bearer": [
                            "shelf_fixture_types:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ShelfFixtureTypesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfFixtureTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/shelf-fixture-types/{id}": {
            "get": {
                "tags": [
                    "Möbel und Preise"
                ],
                "summary": "Ein Eintrag: Möbel und Preise",
                "security": [
                    {
                        "bearer": [
                            "shelf_fixture_types:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfFixtureTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Möbel und Preise"
                ],
                "summary": "Ändern: Möbel und Preise",
                "security": [
                    {
                        "bearer": [
                            "shelf_fixture_types:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ShelfFixtureTypesInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfFixtureTypes"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/shelf-planograms": {
            "get": {
                "tags": [
                    "Planogramme"
                ],
                "summary": "Liste: Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_planograms:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "fixture_type_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur mit diesem Möbel."
                    },
                    {
                        "name": "is_active",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur aktive."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ShelfPlanograms"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Planogramme"
                ],
                "summary": "Anlegen: Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_planograms:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ShelfPlanogramsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfPlanograms"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/shelf-planograms/{id}": {
            "get": {
                "tags": [
                    "Planogramme"
                ],
                "summary": "Ein Eintrag: Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_planograms:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfPlanograms"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Planogramme"
                ],
                "summary": "Ändern: Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_planograms:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ShelfPlanogramsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfPlanograms"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/shelf-placements": {
            "get": {
                "tags": [
                    "Aufgestellte Planogramme"
                ],
                "summary": "Liste: Aufgestellte Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_placements:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur an diesem Standort."
                    },
                    {
                        "name": "planogram_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur dieses Planogramm."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "active",
                                "removed"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/ShelfPlacements"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Aufgestellte Planogramme"
                ],
                "summary": "Anlegen: Aufgestellte Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_placements:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ShelfPlacementsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfPlacements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/shelf-placements/{id}": {
            "get": {
                "tags": [
                    "Aufgestellte Planogramme"
                ],
                "summary": "Ein Eintrag: Aufgestellte Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_placements:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfPlacements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Aufgestellte Planogramme"
                ],
                "summary": "Ändern: Aufgestellte Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_placements:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ShelfPlacementsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/ShelfPlacements"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Aufgestellte Planogramme"
                ],
                "summary": "Löschen: Aufgestellte Planogramme",
                "security": [
                    {
                        "bearer": [
                            "shelf_placements:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-campaigns": {
            "get": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Liste: Kampagnen",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "module",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "spaces",
                                "shelf"
                            ]
                        },
                        "description": "Nur dieses Modul."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "draft",
                                "launched",
                                "cancelled"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "partner_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieses Partners."
                    },
                    {
                        "name": "active_on",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date"
                        },
                        "description": "Nur die an diesem Tag laufenden (YYYY-MM-DD)."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MerchCampaigns"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            },
            "post": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Anlegen: Kampagnen",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:write"
                        ]
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MerchCampaignsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "201": {
                        "description": "Created",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchCampaigns"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "204": {
                        "description": "Zu viele Anfragen."
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-campaigns/{id}": {
            "get": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Ein Eintrag: Kampagnen",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchCampaigns"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            },
            "patch": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Ändern: Kampagnen",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/MerchCampaignsInput"
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchCampaigns"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Löschen: Kampagnen",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "204": {
                        "description": "Deleted"
                    },
                    "409": {
                        "description": "Wird noch anderswo verwendet.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "410": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "411": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "412": {
                        "description": "Zu viele Anfragen."
                    },
                    "413": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-campaigns/{id}/launch": {
            "post": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Den Entwurf starten: Platz prüfen und an jeden Standort senden.",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchCampaigns"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-campaigns/{id}/cancel": {
            "post": {
                "tags": [
                    "Kampagnen"
                ],
                "summary": "Eine gestartete Kampagne stornieren: Sie beginnt nicht, wo sie nicht aufgebaut wurde, und wird abgebaut, wo sie steht.",
                "security": [
                    {
                        "bearer": [
                            "merch_campaigns:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchCampaigns"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-executions": {
            "get": {
                "tags": [
                    "Umsetzung an den Standorten"
                ],
                "summary": "Liste: Umsetzung an den Standorten",
                "security": [
                    {
                        "bearer": [
                            "merch_executions:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "example": "-id"
                        },
                        "description": "id, created_at oder updated_at; ein vorangestelltes Minuszeichen für absteigend."
                    },
                    {
                        "name": "updated_since",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "format": "date-time"
                        },
                        "description": "Nur die seit diesem Zeitpunkt geänderten Einträge (ISO 8601)."
                    },
                    {
                        "name": "campaign_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur die dieser Kampagne."
                    },
                    {
                        "name": "work_unit_id",
                        "in": "query",
                        "schema": {
                            "type": "integer"
                        },
                        "description": "Nur an diesem Standort."
                    },
                    {
                        "name": "status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "waiting",
                                "pending",
                                "done",
                                "refused",
                                "removing",
                                "removed",
                                "cancelled"
                            ]
                        },
                        "description": "Nur mit diesem Status."
                    },
                    {
                        "name": "module",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "spaces",
                                "shelf"
                            ]
                        },
                        "description": "Nur dieses Modul."
                    },
                    {
                        "name": "late",
                        "in": "query",
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "true: nur verspätete."
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "$ref": "#/components/schemas/MerchExecutions"
                                            }
                                        },
                                        "meta": {
                                            "$ref": "#/components/schemas/Meta"
                                        },
                                        "links": {
                                            "$ref": "#/components/schemas/Links"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/merch-executions/{id}": {
            "get": {
                "tags": [
                    "Umsetzung an den Standorten"
                ],
                "summary": "Ein Eintrag: Umsetzung an den Standorten",
                "security": [
                    {
                        "bearer": [
                            "merch_executions:read"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchExecutions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-executions/{id}/confirm": {
            "post": {
                "tags": [
                    "Umsetzung an den Standorten"
                ],
                "summary": "Bestätigen, dass sie steht (mit Fotos, falls verlangt).",
                "security": [
                    {
                        "bearer": [
                            "merch_executions:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "photos": {
                                        "type": [
                                            "array",
                                            "null"
                                        ],
                                        "items": {
                                            "type": "object"
                                        },
                                        "example": [
                                            {
                                                "name": "raft.jpg",
                                                "content_base64": "/9j/4AAQ…"
                                            }
                                        ],
                                        "description": "Fotos: [{name, content_base64}], JPEG/PNG/WebP, je höchstens 10 MB, höchstens 10."
                                    },
                                    "note": {
                                        "type": [
                                            "string",
                                            "null"
                                        ],
                                        "maxLength": 2000,
                                        "description": "Anmerkungen."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchExecutions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-executions/{id}/refuse": {
            "post": {
                "tags": [
                    "Umsetzung an den Standorten"
                ],
                "summary": "Angeben, dass sie nicht aufgebaut werden kann, mit Grund.",
                "security": [
                    {
                        "bearer": [
                            "merch_executions:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "reason": {
                                        "type": "string",
                                        "maxLength": 2000,
                                        "example": "Afișele nu au ajuns în locație.",
                                        "description": "Der Grund."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchExecutions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-executions/{id}/reopen": {
            "post": {
                "tags": [
                    "Umsetzung an den Standorten"
                ],
                "summary": "Einen ablehnenden Standort erneut anfragen (wer die Kampagne verantwortet).",
                "security": [
                    {
                        "bearer": [
                            "merch_executions:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {}
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchExecutions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/merch-executions/{id}/removed": {
            "post": {
                "tags": [
                    "Umsetzung an den Standorten"
                ],
                "summary": "Bestätigen, dass das Material abgebaut wurde.",
                "security": [
                    {
                        "bearer": [
                            "merch_executions:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "photos": {
                                        "type": [
                                            "array",
                                            "null"
                                        ],
                                        "items": {
                                            "type": "object"
                                        },
                                        "example": [
                                            {
                                                "name": "raft.jpg",
                                                "content_base64": "/9j/4AAQ…"
                                            }
                                        ],
                                        "description": "Fotos nach dem Abbau (optional): [{name, content_base64}]."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "data": {
                                            "$ref": "#/components/schemas/MerchExecutions"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Kein solcher Eintrag in Ihrem Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "205": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/metrics": {
            "get": {
                "tags": [
                    "KPI-Werte"
                ],
                "summary": "Die Kennzahlen, die Werte über die API annehmen",
                "security": [
                    {
                        "bearer": [
                            "metrics:write"
                        ]
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    }
                }
            }
        },
        "/metrics/{key}/values": {
            "post": {
                "tags": [
                    "KPI-Werte"
                ],
                "summary": "Werte für eine Kennzahl und einen Zeitraum senden",
                "security": [
                    {
                        "bearer": [
                            "metrics:write"
                        ]
                    }
                ],
                "parameters": [
                    {
                        "name": "key",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "period",
                                    "values"
                                ],
                                "properties": {
                                    "period": {
                                        "type": "string",
                                        "example": "2026-09"
                                    },
                                    "values": {
                                        "type": "array",
                                        "maxItems": 1000,
                                        "items": {
                                            "type": "object",
                                            "properties": {
                                                "subject": {
                                                    "type": "string",
                                                    "example": "CJ01"
                                                },
                                                "value": {
                                                    "type": [
                                                        "number",
                                                        "string",
                                                        "null"
                                                    ],
                                                    "example": 1234.5
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "201": {
                        "description": "Der Schlüssel fehlt, ist unbekannt oder gehört zu einem anderen Unternehmen.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "202": {
                        "description": "Pausierter oder abgelaufener Schlüssel, fehlende Berechtigung, Adresse nicht erlaubt.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/Error"
                                }
                            }
                        }
                    },
                    "203": {
                        "description": "Zu viele Anfragen."
                    },
                    "204": {
                        "description": "Ungültige Daten; es wurde nichts gespeichert.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Error": {
                "type": "object",
                "required": [
                    "error",
                    "message"
                ],
                "properties": {
                    "error": {
                        "type": "string"
                    },
                    "message": {
                        "type": "string"
                    }
                }
            },
            "ValidationError": {
                "type": "object",
                "properties": {
                    "message": {
                        "type": "string"
                    },
                    "errors": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    }
                }
            },
            "Meta": {
                "type": "object",
                "properties": {
                    "page": {
                        "type": "integer"
                    },
                    "per_page": {
                        "type": "integer"
                    },
                    "total": {
                        "type": "integer"
                    },
                    "last_page": {
                        "type": "integer"
                    }
                }
            },
            "Links": {
                "type": "object",
                "properties": {
                    "next": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "prev": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            },
            "GeoAreas": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 3,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 160,
                        "example": "Nord-Vest",
                        "description": "Name, eindeutig unter den Gebieten mit demselben übergeordneten Gebiet."
                    },
                    "level_label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "regiune",
                        "description": "Wie diese Ebene heißt (Land, Region, Zone)."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 1,
                        "description": "Das Gebiet, in dem es liegt; null für ein oberstes Gebiet. Nie es selbst oder eines seiner Untergebiete."
                    },
                    "sort": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 0,
                        "description": "Reihenfolge unter seinen Geschwistern."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "GeoAreasInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 160,
                        "example": "Nord-Vest",
                        "description": "Name, eindeutig unter den Gebieten mit demselben übergeordneten Gebiet."
                    },
                    "level_label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "regiune",
                        "description": "Wie diese Ebene heißt (Land, Region, Zone)."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 1,
                        "description": "Das Gebiet, in dem es liegt; null für ein oberstes Gebiet. Nie es selbst oder eines seiner Untergebiete."
                    },
                    "sort": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 0,
                        "description": "Reihenfolge unter seinen Geschwistern."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "WorkUnits": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 12,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 160,
                        "example": "Farmacia Verde Centru",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "CJ01",
                        "description": "Ihr eigenes Kürzel, eindeutig im Unternehmen (zur Zuordnung von KPI-Werten)."
                    },
                    "geo_area_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 3,
                        "description": "Das Gebiet (Region, Land), zu dem er gehört."
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "example": "Str. Memorandumului 10",
                        "description": "Straße und Hausnummer."
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Cluj-Napoca",
                        "description": "Ort (aus der amtlichen Liste bei rumänischen Standorten)."
                    },
                    "county": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Cluj",
                        "description": "Kreis oder Region."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "description": "Telefon."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 160,
                        "description": "E-Mail."
                    },
                    "opened_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2016-03-01",
                        "description": "Eröffnungsdatum."
                    },
                    "closed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Schließungsdatum."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob er in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "WorkUnitsInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 160,
                        "example": "Farmacia Verde Centru",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "CJ01",
                        "description": "Ihr eigenes Kürzel, eindeutig im Unternehmen (zur Zuordnung von KPI-Werten)."
                    },
                    "geo_area_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 3,
                        "description": "Das Gebiet (Region, Land), zu dem er gehört."
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "example": "Str. Memorandumului 10",
                        "description": "Straße und Hausnummer."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "description": "Telefon."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 160,
                        "description": "E-Mail."
                    },
                    "opened_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2016-03-01",
                        "description": "Eröffnungsdatum."
                    },
                    "closed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Schließungsdatum."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob er in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "Departments": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Farmacie",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "FARM",
                        "description": "Ihr eigenes Kürzel, eindeutig im Unternehmen (zur Zuordnung von KPI-Werten)."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Abteilung, zu der sie gehört; nie sie selbst oder eine ihrer Unterabteilungen."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob sie in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "DepartmentsInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Farmacie",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "FARM",
                        "description": "Ihr eigenes Kürzel, eindeutig im Unternehmen (zur Zuordnung von KPI-Werten)."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Abteilung, zu der sie gehört; nie sie selbst oder eine ihrer Unterabteilungen."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob sie in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "Positions": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Farmacist",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "FA",
                        "description": "Ihr eigenes Kürzel, eindeutig im Unternehmen."
                    },
                    "level": {
                        "type": "integer",
                        "example": 2,
                        "description": "Hierarchiestufe, von 0 bis 100."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob sie in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "PositionsInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Farmacist",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "FA",
                        "description": "Ihr eigenes Kürzel, eindeutig im Unternehmen."
                    },
                    "level": {
                        "type": "integer",
                        "example": 2,
                        "description": "Hierarchiestufe, von 0 bis 100."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob sie in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    }
                },
                "required": [
                    "name",
                    "level"
                ]
            },
            "Teams": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Proiect inventar",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es in Verwendung ist."
                    },
                    "member_ids": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            345,
                            346
                        ],
                        "description": "Die Mitarbeiter im Team (nur lesbar; ändern Sie sie mit add-member / remove-member)."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "TeamsInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Proiect inventar",
                        "description": "Name, eindeutig im Unternehmen."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es in Verwendung ist."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID (siehe /custom-fields)."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CustomFields": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 12,
                        "description": "Kennung; der Schlüssel in den custom_fields eines Eintrags."
                    },
                    "entity": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "work_unit",
                            "department",
                            "position",
                            "team",
                            "company"
                        ],
                        "readOnly": true,
                        "example": "employee",
                        "description": "Die Art von Eintrag, zu der es gehört."
                    },
                    "label": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Mărime uniformă",
                        "description": "Sein Name, in der Sprache der Anfrage (Accept-Language)."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "text",
                            "textarea",
                            "number",
                            "date",
                            "boolean",
                            "select",
                            "multiselect",
                            "url"
                        ],
                        "readOnly": true,
                        "example": "select",
                        "description": "Was es enthält: text, textarea, number, date (Y-m-d), boolean, select, multiselect oder url."
                    },
                    "options": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "id": "m",
                                "label": "M"
                            }
                        ],
                        "description": "Die Auswahlen eines select oder multiselect: id und label; gespeichert wird die id."
                    },
                    "is_required": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": false,
                        "description": "Ob ein Wert erforderlich ist."
                    },
                    "visibility": {
                        "type": "string",
                        "enum": [
                            "reach",
                            "sensitive"
                        ],
                        "readOnly": true,
                        "example": "reach",
                        "description": "reach (alle, die die Person sehen) oder sensitive."
                    },
                    "is_active": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob es in Verwendung ist."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "Employees": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Kennung."
                    },
                    "employee_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "FV0012",
                        "description": "Ihre Personalnummer, eindeutig im Unternehmen (zur Zuordnung von KPI-Werten)."
                    },
                    "first_name": {
                        "type": "string",
                        "maxLength": 80,
                        "example": "Ana",
                        "description": "Vorname."
                    },
                    "last_name": {
                        "type": "string",
                        "maxLength": 80,
                        "example": "Popescu",
                        "description": "Nachname."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 160,
                        "example": "ana.popescu@example.com",
                        "description": "Dienstliche E-Mail."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "description": "Telefon."
                    },
                    "birth_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Geburtsdatum."
                    },
                    "hire_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2024-02-01",
                        "description": "Eintrittsdatum (die erste Zuordnung beginnt an diesem Tag)."
                    },
                    "termination_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Austrittsdatum."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "inactive",
                            "terminated"
                        ],
                        "example": "active",
                        "description": "active, inactive oder terminated."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Standort der aktuellen Hauptzuordnung; beim Anlegen erforderlich, danach nur lesbar."
                    },
                    "department_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Abteilung der aktuellen Hauptzuordnung (nur beim Anlegen)."
                    },
                    "position_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Position der aktuellen Hauptzuordnung (nur beim Anlegen)."
                    },
                    "has_login": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Ob sich die Person anmelden kann."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID; sensible nur mit der Berechtigung sensitive."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "EmployeesInput": {
                "type": "object",
                "properties": {
                    "employee_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 32,
                        "example": "FV0012",
                        "description": "Ihre Personalnummer, eindeutig im Unternehmen (zur Zuordnung von KPI-Werten)."
                    },
                    "first_name": {
                        "type": "string",
                        "maxLength": 80,
                        "example": "Ana",
                        "description": "Vorname."
                    },
                    "last_name": {
                        "type": "string",
                        "maxLength": 80,
                        "example": "Popescu",
                        "description": "Nachname."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 160,
                        "example": "ana.popescu@example.com",
                        "description": "Dienstliche E-Mail."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "description": "Telefon."
                    },
                    "birth_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Geburtsdatum."
                    },
                    "hire_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2024-02-01",
                        "description": "Eintrittsdatum (die erste Zuordnung beginnt an diesem Tag)."
                    },
                    "termination_date": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Austrittsdatum."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "inactive",
                            "terminated"
                        ],
                        "example": "active",
                        "description": "active, inactive oder terminated."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Standort der aktuellen Hauptzuordnung; beim Anlegen erforderlich, danach nur lesbar."
                    },
                    "department_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Abteilung der aktuellen Hauptzuordnung (nur beim Anlegen)."
                    },
                    "position_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Position der aktuellen Hauptzuordnung (nur beim Anlegen)."
                    },
                    "custom_fields": {
                        "type": "object",
                        "example": {
                            "12": "XL"
                        },
                        "description": "Die eigenen Felder des Unternehmens, nach Feld-ID; sensible nur mit der Berechtigung sensitive."
                    }
                },
                "required": [
                    "first_name",
                    "last_name",
                    "work_unit_id"
                ]
            },
            "Placements": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 901,
                        "description": "Kennung."
                    },
                    "employee_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die Person."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort."
                    },
                    "department_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Abteilung."
                    },
                    "position_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Position."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es die Hauptzuordnung der Person ist."
                    },
                    "valid_from": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-03-01",
                        "description": "Erster Tag."
                    },
                    "valid_to": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Letzter Tag (leer: noch aktuell)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "PlacementsInput": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die Person."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort."
                    },
                    "department_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Abteilung."
                    },
                    "position_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Position."
                    },
                    "is_primary": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es die Hauptzuordnung der Person ist."
                    },
                    "valid_from": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-03-01",
                        "description": "Erster Tag."
                    },
                    "valid_to": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Letzter Tag (leer: noch aktuell)."
                    }
                },
                "required": [
                    "employee_id",
                    "work_unit_id",
                    "valid_from"
                ]
            },
            "LeaveTypes": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Kennung."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "CO",
                        "description": "Kurzes Kürzel."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Concediu de odihnă",
                        "description": "Name, in der Sprache der Anfrage (Accept-Language), ersatzweise in der des Unternehmens."
                    },
                    "uses_balance": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob die Tage von einem Jahresurlaubskonto abgehen."
                    },
                    "default_entitlement": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 21,
                        "description": "Tage pro Jahr bei ganzjähriger Beschäftigung."
                    },
                    "is_paid": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Bezahlte Abwesenheit."
                    },
                    "requires_attachment": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Ein Dokument muss angehängt werden (Anträge, die eines brauchen, werden in der Anwendung gestellt)."
                    },
                    "requires_reference": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Eine Referenznummer ist erforderlich."
                    },
                    "requires_replacement": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Eine Vertretung ist erforderlich."
                    },
                    "is_active": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Ob sie beantragt werden kann."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "LeaveRequests": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 77,
                        "description": "Kennung."
                    },
                    "employee_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die abwesende Person."
                    },
                    "leave_type_id": {
                        "type": "integer",
                        "example": 1,
                        "description": "Die Abwesenheitsart."
                    },
                    "starts_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-07-06",
                        "description": "Erster Tag."
                    },
                    "ends_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-07-10",
                        "description": "Letzter Tag."
                    },
                    "half_start": {
                        "type": "boolean",
                        "example": false,
                        "description": "Der erste Tag ist nur nachmittags (zählt als halber Tag)."
                    },
                    "half_end": {
                        "type": "boolean",
                        "example": false,
                        "description": "Der letzte Tag ist nur vormittags (zählt als halber Tag)."
                    },
                    "days": {
                        "type": "number",
                        "readOnly": true,
                        "example": 5,
                        "description": "Gezählte Tage (Arbeitstage ohne Feiertage; halbe Tage zählen 0,5)."
                    },
                    "hours": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Bei einer in Stunden gezählten Art: die Stunden, die sie umfasst (die Stunden ihrer Tage laut Arbeitszeitmodell der Person). Beim Anlegen: ein Teil eines eintägigen Antrags."
                    },
                    "for_child": {
                        "type": "boolean",
                        "example": false,
                        "description": "Für ein erkranktes Kind beantragt (eine Art, die dafür eine weitere Woche erlaubt)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "approved",
                            "rejected",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "pending",
                        "description": "pending, approved, rejected oder cancelled."
                    },
                    "replacement_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die vertretende Person."
                    },
                    "reference": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "description": "Referenznummer (zum Beispiel einer Arbeitsunfähigkeitsbescheinigung)."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Anmerkung."
                    },
                    "has_certificate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "yes",
                            "no",
                            "pending"
                        ],
                        "description": "Gesundheitsbezogene Abwesenheit: ob eine ärztliche Bescheinigung vorliegt (yes / no / pending); nur mit dem Bereich für sensible Daten."
                    },
                    "certificate_from": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Erster Tag der Bescheinigung (wo das Land ihn erfasst)."
                    },
                    "certificate_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Letzter Tag der Bescheinigung."
                    },
                    "eau_status": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "not_retrieved",
                            "retrieved",
                            "confirmed"
                        ],
                        "readOnly": true,
                        "description": "Deutschland: ob die eAU bei der Krankenkasse abgerufen wurde."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Gestellt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "LeaveRequestsInput": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die abwesende Person."
                    },
                    "leave_type_id": {
                        "type": "integer",
                        "example": 1,
                        "description": "Die Abwesenheitsart."
                    },
                    "starts_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-07-06",
                        "description": "Erster Tag."
                    },
                    "ends_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-07-10",
                        "description": "Letzter Tag."
                    },
                    "half_start": {
                        "type": "boolean",
                        "example": false,
                        "description": "Der erste Tag ist nur nachmittags (zählt als halber Tag)."
                    },
                    "half_end": {
                        "type": "boolean",
                        "example": false,
                        "description": "Der letzte Tag ist nur vormittags (zählt als halber Tag)."
                    },
                    "hours": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Bei einer in Stunden gezählten Art: die Stunden, die sie umfasst (die Stunden ihrer Tage laut Arbeitszeitmodell der Person). Beim Anlegen: ein Teil eines eintägigen Antrags."
                    },
                    "for_child": {
                        "type": "boolean",
                        "example": false,
                        "description": "Für ein erkranktes Kind beantragt (eine Art, die dafür eine weitere Woche erlaubt)."
                    },
                    "replacement_employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die vertretende Person."
                    },
                    "reference": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "description": "Referenznummer (zum Beispiel einer Arbeitsunfähigkeitsbescheinigung)."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Anmerkung."
                    },
                    "has_certificate": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "yes",
                            "no",
                            "pending"
                        ],
                        "description": "Gesundheitsbezogene Abwesenheit: ob eine ärztliche Bescheinigung vorliegt (yes / no / pending); nur mit dem Bereich für sensible Daten."
                    },
                    "certificate_from": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Erster Tag der Bescheinigung (wo das Land ihn erfasst)."
                    },
                    "certificate_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Letzter Tag der Bescheinigung."
                    }
                },
                "required": [
                    "employee_id",
                    "leave_type_id",
                    "starts_on",
                    "ends_on"
                ]
            },
            "LeaveBalances": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 55,
                        "description": "Kennung."
                    },
                    "employee_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Die Person."
                    },
                    "leave_type_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Die Abwesenheitsart."
                    },
                    "year": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2026,
                        "description": "Das Jahr."
                    },
                    "entitlement": {
                        "type": "number",
                        "example": 21,
                        "description": "Tage für das Jahr (0–365)."
                    },
                    "adjustment": {
                        "type": "number",
                        "example": 0,
                        "description": "Hinzugefügte oder abgezogene Tage (−365–365)."
                    },
                    "carried_over": {
                        "type": "number",
                        "example": 3,
                        "description": "Aus dem Vorjahr übertragene Tage."
                    },
                    "carried_over_expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-03-31",
                        "description": "Bis wann die übertragenen Tage genutzt werden können."
                    },
                    "carried_usable": {
                        "type": "number",
                        "readOnly": true,
                        "example": 3,
                        "description": "Heute noch nutzbare übertragene Tage."
                    },
                    "earlier": {
                        "type": "number",
                        "readOnly": true,
                        "example": 0,
                        "description": "Noch verbleibende Tage aus den Jahren vor dem Vorjahr, heute nutzbar."
                    },
                    "earlier_expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "description": "Bis wann die frühesten dieser Tage genommen werden können."
                    },
                    "used": {
                        "type": "number",
                        "readOnly": true,
                        "example": 5,
                        "description": "Genommene Tage (genehmigt)."
                    },
                    "pending": {
                        "type": "number",
                        "readOnly": true,
                        "example": 2,
                        "description": "Beantragte Tage, die auf Genehmigung warten."
                    },
                    "available": {
                        "type": "number",
                        "readOnly": true,
                        "example": 17,
                        "description": "Verbleibende Tage."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Anmerkung."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Eröffnet."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "LeaveBalancesInput": {
                "type": "object",
                "properties": {
                    "entitlement": {
                        "type": "number",
                        "example": 21,
                        "description": "Tage für das Jahr (0–365)."
                    },
                    "adjustment": {
                        "type": "number",
                        "example": 0,
                        "description": "Hinzugefügte oder abgezogene Tage (−365–365)."
                    },
                    "carried_over": {
                        "type": "number",
                        "example": 3,
                        "description": "Aus dem Vorjahr übertragene Tage."
                    },
                    "carried_over_expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-03-31",
                        "description": "Bis wann die übertragenen Tage genutzt werden können."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Anmerkung."
                    }
                }
            },
            "CalendarEvents": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 410,
                        "description": "Kennung."
                    },
                    "event_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Terminart."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Inventar trimestrial",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100000,
                        "example": "<p>Toată echipa.</p>",
                        "description": "Beschreibung (HTML; bereinigt wie jeder in der Anwendung geschriebene Text)."
                    },
                    "location": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Ort."
                    },
                    "starts_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-07-06T15:00:00Z",
                        "description": "Beginn (ISO 8601)."
                    },
                    "ends_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-07-06T17:00:00Z",
                        "description": "Ende (ISO 8601)."
                    },
                    "all_day": {
                        "type": "boolean",
                        "description": "Ganztägig."
                    },
                    "visibility": {
                        "type": "string",
                        "enum": [
                            "everyone",
                            "unit",
                            "participants"
                        ],
                        "example": "everyone",
                        "description": "everyone, unit (die Personen des Standorts) oder participants."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Der Standort, bei visibility unit."
                    },
                    "participants": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            345,
                            346
                        ],
                        "description": "IDs der eingeladenen Mitarbeiter."
                    },
                    "rsvp": {
                        "type": "boolean",
                        "description": "Fragt, wer kommt."
                    },
                    "recurrence": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "weekly",
                            "biweekly",
                            "monthly",
                            "yearly"
                        ],
                        "description": "Nur beim Anlegen: weekly, biweekly, monthly oder yearly."
                    },
                    "recurrence_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Nur beim Anlegen: der letzte Tag der Serie (höchstens zwei Jahre im Voraus)."
                    },
                    "series_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Die Serie, zu der er gehört."
                    },
                    "cancelled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann er abgesagt wurde."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CalendarEventsInput": {
                "type": "object",
                "properties": {
                    "event_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Terminart."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Inventar trimestrial",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100000,
                        "example": "<p>Toată echipa.</p>",
                        "description": "Beschreibung (HTML; bereinigt wie jeder in der Anwendung geschriebene Text)."
                    },
                    "location": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Ort."
                    },
                    "starts_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-07-06T15:00:00Z",
                        "description": "Beginn (ISO 8601)."
                    },
                    "ends_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-07-06T17:00:00Z",
                        "description": "Ende (ISO 8601)."
                    },
                    "all_day": {
                        "type": "boolean",
                        "description": "Ganztägig."
                    },
                    "visibility": {
                        "type": "string",
                        "enum": [
                            "everyone",
                            "unit",
                            "participants"
                        ],
                        "example": "everyone",
                        "description": "everyone, unit (die Personen des Standorts) oder participants."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Der Standort, bei visibility unit."
                    },
                    "participants": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            345,
                            346
                        ],
                        "description": "IDs der eingeladenen Mitarbeiter."
                    },
                    "rsvp": {
                        "type": "boolean",
                        "description": "Fragt, wer kommt."
                    },
                    "recurrence": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "weekly",
                            "biweekly",
                            "monthly",
                            "yearly"
                        ],
                        "description": "Nur beim Anlegen: weekly, biweekly, monthly oder yearly."
                    },
                    "recurrence_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "description": "Nur beim Anlegen: der letzte Tag der Serie (höchstens zwei Jahre im Voraus)."
                    }
                },
                "required": [
                    "title",
                    "starts_at",
                    "ends_at",
                    "visibility"
                ]
            },
            "KpiMetrics": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Kennung."
                    },
                    "key": {
                        "type": "string",
                        "readOnly": true,
                        "example": "sales.actual",
                        "description": "Der Schlüssel der Kennzahl, verwendet in Formeln und beim Senden von Werten."
                    },
                    "label": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Sales",
                        "description": "Name, in der Sprache des Unternehmens."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Was sie misst."
                    },
                    "unit": {
                        "type": "string",
                        "enum": [
                            "currency",
                            "percent",
                            "count",
                            "score",
                            "days",
                            "hours",
                            "ratio"
                        ],
                        "readOnly": true,
                        "example": "currency",
                        "description": "Einheit: currency, percent, count, score, days, hours oder ratio."
                    },
                    "value_type": {
                        "type": "string",
                        "enum": [
                            "decimal",
                            "integer",
                            "percent",
                            "boolean"
                        ],
                        "readOnly": true,
                        "example": "decimal",
                        "description": "Art des Werts: decimal, integer, percent oder boolean."
                    },
                    "grain": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "team",
                            "department",
                            "work_unit",
                            "geo_area",
                            "company"
                        ],
                        "readOnly": true,
                        "example": "employee",
                        "description": "Für wen sie gemessen wird: employee, team, department, work_unit, geo_area oder company."
                    },
                    "period": {
                        "type": "string",
                        "enum": [
                            "day",
                            "week",
                            "month",
                            "quarter",
                            "year"
                        ],
                        "readOnly": true,
                        "example": "month",
                        "description": "Wie oft: day, week, month, quarter oder year."
                    },
                    "aggregation": {
                        "type": "string",
                        "enum": [
                            "sum",
                            "avg",
                            "last",
                            "min",
                            "max",
                            "count"
                        ],
                        "readOnly": true,
                        "example": "sum",
                        "description": "Wie sich Werte über einen längeren Zeitraum zusammenfassen."
                    },
                    "source_type": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "import",
                            "module",
                            "derived",
                            "api",
                            "objective",
                            "review"
                        ],
                        "readOnly": true,
                        "example": "api",
                        "description": "Woher ihre Werte kommen (manual, import, api, ein Modul …)."
                    },
                    "is_higher_better": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob ein höherer Wert besser ist."
                    },
                    "is_active": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob sie in Verwendung ist."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "MetricValues": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 5120,
                        "description": "Kennung."
                    },
                    "metric": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "sales.api",
                        "description": "Der Schlüssel der Kennzahl."
                    },
                    "subject_type": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "team",
                            "department",
                            "work_unit",
                            "geo_area",
                            "company"
                        ],
                        "readOnly": true,
                        "example": "employee",
                        "description": "Die Art des Subjekts (das grain der Kennzahl)."
                    },
                    "subject_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die ID des Subjekts (eine ID von Person, Standort, Abteilung, Gebiet oder Team; 0 für das Unternehmen)."
                    },
                    "period": {
                        "type": "string",
                        "maxLength": 16,
                        "example": "2026-09",
                        "description": "Der Schlüssel des Zeitraums: 2026-09 (Monat), 2026-W38 (Woche), 2026-Q3, 2026, 2026-09-14 (Tag)."
                    },
                    "period_start": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-01",
                        "description": "Erster Tag des Zeitraums."
                    },
                    "period_end": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-30",
                        "description": "Letzter Tag des Zeitraums."
                    },
                    "value": {
                        "type": [
                            "string",
                            "number",
                            "boolean",
                            "null"
                        ],
                        "example": "1234.5",
                        "description": "Der Wert, als Zahl oder Text („1234.5“, „1.234,5“, „87%“, true/false); null für keine Daten. Gespeichert als Dezimalzeichenkette."
                    },
                    "source": {
                        "type": "string",
                        "enum": [
                            "manual",
                            "import",
                            "module",
                            "derived",
                            "api",
                            "objective",
                            "review"
                        ],
                        "readOnly": true,
                        "example": "api",
                        "description": "Woher er kam."
                    },
                    "recorded_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann er geschrieben wurde."
                    }
                }
            },
            "MetricValuesInput": {
                "type": "object",
                "properties": {
                    "metric": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "sales.api",
                        "description": "Der Schlüssel der Kennzahl."
                    },
                    "subject_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die ID des Subjekts (eine ID von Person, Standort, Abteilung, Gebiet oder Team; 0 für das Unternehmen)."
                    },
                    "period": {
                        "type": "string",
                        "maxLength": 16,
                        "example": "2026-09",
                        "description": "Der Schlüssel des Zeitraums: 2026-09 (Monat), 2026-W38 (Woche), 2026-Q3, 2026, 2026-09-14 (Tag)."
                    },
                    "value": {
                        "type": [
                            "string",
                            "number",
                            "boolean",
                            "null"
                        ],
                        "example": "1234.5",
                        "description": "Der Wert, als Zahl oder Text („1234.5“, „1.234,5“, „87%“, true/false); null für keine Daten. Gespeichert als Dezimalzeichenkette."
                    }
                },
                "required": [
                    "metric",
                    "subject_id",
                    "period"
                ]
            },
            "KpiScorecards": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Kennung dieser Version."
                    },
                    "family": {
                        "type": "string",
                        "readOnly": true,
                        "example": "9b2e0c1e-0f0a-4b47-9f3a-2c1d7e8a1b20",
                        "description": "Die KPI-Scorecard über ihre Versionen hinweg."
                    },
                    "version": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2,
                        "description": "Versionsnummer."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Pharmacist performance",
                        "description": "Name."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Beschreibung."
                    },
                    "grain": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "team",
                            "department",
                            "work_unit",
                            "geo_area",
                            "company"
                        ],
                        "readOnly": true,
                        "example": "employee",
                        "description": "Wen sie bewertet."
                    },
                    "period": {
                        "type": "string",
                        "enum": [
                            "day",
                            "week",
                            "month",
                            "quarter",
                            "year"
                        ],
                        "readOnly": true,
                        "example": "month",
                        "description": "Wie oft sie bewertet."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "published",
                            "archived"
                        ],
                        "readOnly": true,
                        "example": "published",
                        "description": "draft, published oder archived."
                    },
                    "effective_from": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "description": "Gültig ab."
                    },
                    "effective_to": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "description": "Gültig bis."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann diese Version veröffentlicht wurde."
                    },
                    "components": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "key": "sales",
                                "label": "Sales achievement",
                                "weight": "0.55"
                            }
                        ],
                        "description": "Ihre Teile: key, label, Gewichtung (0–1), Zielwert, Anzeigeformat, ob die Person ihn sieht."
                    },
                    "levels": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "name": "Good",
                                "min_score": "85",
                                "color": "#2B6CB0"
                            }
                        ],
                        "description": "Ihre Stufen: Name, der niedrigste Score, der sie erreicht, Farbe."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "KpiResults": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 9811,
                        "description": "Kennung."
                    },
                    "scorecard_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Die Version der KPI-Scorecard, die bewertet hat."
                    },
                    "scorecard": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Pharmacist performance",
                        "description": "Ihr Name."
                    },
                    "subject_type": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "team",
                            "department",
                            "work_unit",
                            "geo_area",
                            "company"
                        ],
                        "readOnly": true,
                        "example": "employee",
                        "description": "Die Art des Subjekts."
                    },
                    "subject_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Die ID des Subjekts."
                    },
                    "subject": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Ana Popescu",
                        "description": "Der Name des Subjekts."
                    },
                    "period": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-01",
                        "description": "Erster Tag des Zeitraums."
                    },
                    "total": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "92.40",
                        "description": "Der Score als Dezimalzeichenkette; null, wenn es keine Daten gibt."
                    },
                    "level": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Good",
                        "description": "Die erreichte Stufe."
                    },
                    "level_color": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "#2B6CB0",
                        "description": "Die Farbe der Stufe."
                    },
                    "bonus": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Der Bonus, falls die KPI-Scorecard einen berechnet."
                    },
                    "parts": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "key": "sales",
                                "label": "Sales achievement",
                                "value": "104.2",
                                "points": "57.31"
                            }
                        ],
                        "description": "Jeder Teil: key, label, Wert und die Punkte, die er bringt (Dezimalzeichenketten; null für keine Daten)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann er berechnet wurde."
                    }
                }
            },
            "Priorities": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "description": "Kennung."
                    },
                    "parent_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Die Priorität, an der sie sich ausrichtet."
                    },
                    "level": {
                        "type": "string",
                        "enum": [
                            "company",
                            "geo_area",
                            "work_unit",
                            "department",
                            "person"
                        ],
                        "readOnly": true,
                        "description": "company, geo_area, work_unit, department oder person."
                    },
                    "subject_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 12,
                        "description": "Für wen: das Gebiet, der Standort, die Abteilung oder die Person (0 für das Unternehmen)."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Das verantwortliche Konto."
                    },
                    "title": {
                        "type": "string",
                        "readOnly": true,
                        "description": "Was erreicht werden soll."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Warum es wichtig ist."
                    },
                    "period_type": {
                        "type": "string",
                        "enum": [
                            "month",
                            "quarter",
                            "year"
                        ],
                        "readOnly": true,
                        "description": "month, quarter oder year."
                    },
                    "period_start": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "description": "Erster Tag des Zeitraums."
                    },
                    "period_end": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "description": "Letzter Tag."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "closed",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "description": "active, closed oder cancelled."
                    },
                    "progress": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "62.5",
                        "description": "Der Stand in Prozent (null = noch keine Daten)."
                    },
                    "expected": {
                        "type": "number",
                        "readOnly": true,
                        "example": "48.9",
                        "description": "Wo es heute stehen sollte, in Prozent."
                    },
                    "key_results": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "id": 7,
                                "kind": "manual",
                                "title": "Units taking online orders",
                                "unit": null,
                                "start_value": "0",
                                "target_value": "12",
                                "current": "7",
                                "progress": "58.3",
                                "metric_key": null
                            }
                        ],
                        "description": "Jedes Schlüsselergebnis: Art (manual, milestone, metric), Titel, Einheit, Start- und Zielwert, aktueller Wert, Fortschritt und die gelesene KPI-Kennzahl."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Erstellt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "Objectives": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 31,
                        "description": "Kennung."
                    },
                    "rule_id": {
                        "type": "integer",
                        "example": 2,
                        "description": "Die Regel, die es bewertet (nur beim Anlegen)."
                    },
                    "rule": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Focus products",
                        "description": "Der Name der Regel."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Vitamin C 1000",
                        "description": "Name."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Beschreibung."
                    },
                    "period": {
                        "type": "string",
                        "maxLength": 16,
                        "example": "2026-09",
                        "description": "Der Schlüssel des Zeitraums im Zeitraum der Regel (nur beim Anlegen), zum Beispiel 2026-09."
                    },
                    "period_start": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-01",
                        "description": "Erster Tag."
                    },
                    "period_end": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-30",
                        "description": "Letzter Tag."
                    },
                    "params": {
                        "type": "object",
                        "example": {
                            "bonus": "2"
                        },
                        "description": "Werte für die Parameter der Regel, nach Name (andere werden ignoriert); weggelassen: die Standardwerte der Regel."
                    },
                    "targets": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "work_unit_id": 12,
                                "target": "30"
                            }
                        ],
                        "description": "Zielwerte pro Standort: eine Liste von {work_unit_id, target}. Gibt es Zielwerte, gilt das Ziel nur für diese Standorte."
                    },
                    "external_ref": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100,
                        "example": "CAMP-2026-09",
                        "description": "Ihre eigene Referenz (nur beim Anlegen)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ObjectivesInput": {
                "type": "object",
                "properties": {
                    "rule_id": {
                        "type": "integer",
                        "example": 2,
                        "description": "Die Regel, die es bewertet (nur beim Anlegen)."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Vitamin C 1000",
                        "description": "Name."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Beschreibung."
                    },
                    "period": {
                        "type": "string",
                        "maxLength": 16,
                        "example": "2026-09",
                        "description": "Der Schlüssel des Zeitraums im Zeitraum der Regel (nur beim Anlegen), zum Beispiel 2026-09."
                    },
                    "params": {
                        "type": "object",
                        "example": {
                            "bonus": "2"
                        },
                        "description": "Werte für die Parameter der Regel, nach Name (andere werden ignoriert); weggelassen: die Standardwerte der Regel."
                    },
                    "targets": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "work_unit_id": 12,
                                "target": "30"
                            }
                        ],
                        "description": "Zielwerte pro Standort: eine Liste von {work_unit_id, target}. Gibt es Zielwerte, gilt das Ziel nur für diese Standorte."
                    },
                    "external_ref": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 100,
                        "example": "CAMP-2026-09",
                        "description": "Ihre eigene Referenz (nur beim Anlegen)."
                    }
                },
                "required": [
                    "rule_id",
                    "name",
                    "period"
                ]
            },
            "Reviews": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 812,
                        "description": "Kennung."
                    },
                    "form_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 3,
                        "description": "Die Version des Bogens."
                    },
                    "form": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Monthly evaluation",
                        "description": "Der Name des Bogens."
                    },
                    "employee_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Die beurteilte Person."
                    },
                    "evaluator_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 12,
                        "description": "Das Konto der beurteilenden Person."
                    },
                    "period_start": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-01",
                        "description": "Erster Tag des Zeitraums."
                    },
                    "period_end": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-09-30",
                        "description": "Letzter Tag."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "submitted",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "submitted",
                        "description": "submitted oder cancelled."
                    },
                    "total_points": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "8.00",
                        "description": "Erreichte Punkte."
                    },
                    "max_points": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "10.00",
                        "description": "Mögliche Punkte."
                    },
                    "result": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "80",
                        "description": "Das Ergebnis (Punkte oder ein Prozentsatz, wenn der Bogen einen liefert)."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Der Kommentar der beurteilenden Person, als reiner Text."
                    },
                    "submitted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie abgegeben wurde."
                    },
                    "cancelled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie storniert wurde."
                    },
                    "answers": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "criterion_key": "attitude",
                                "selected": [
                                    "teamwork"
                                ],
                                "value": null,
                                "points": "2.00",
                                "comment": null
                            }
                        ],
                        "description": "Jedes Kriterium: key, die gewählten Optionen, ein Wert, seine Punkte und ein Kommentar."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "Contests": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Store of the month",
                        "description": "Name (in der Sprache des Unternehmens)."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Beschreibung."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "scheduled",
                            "running",
                            "closing",
                            "to_confirm",
                            "final",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "running",
                        "description": "scheduled, running, closing (Tage für verspätete Daten), to_confirm, final oder cancelled."
                    },
                    "grain": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "team",
                            "work_unit",
                            "department",
                            "geo_area"
                        ],
                        "readOnly": true,
                        "example": "work_unit",
                        "description": "Wer antritt: employee, team, work_unit, department oder geo_area."
                    },
                    "period_type": {
                        "type": "string",
                        "enum": [
                            "week",
                            "month",
                            "quarter"
                        ],
                        "readOnly": true,
                        "example": "month",
                        "description": "week, month oder quarter."
                    },
                    "start_key": {
                        "type": "string",
                        "readOnly": true,
                        "example": "2026-11",
                        "description": "Der erste Zeitraum (2026-11, 2026-W45, 2026-Q1)."
                    },
                    "period_count": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Wie viele aufeinanderfolgende Zeiträume."
                    },
                    "starts_on": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "description": "Erster Tag."
                    },
                    "ends_on": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "description": "Letzter Tag."
                    },
                    "criterion_kind": {
                        "type": "string",
                        "enum": [
                            "metric",
                            "formula",
                            "scorecard"
                        ],
                        "readOnly": true,
                        "example": "metric",
                        "description": "Was gemessen wird: metric, formula oder scorecard."
                    },
                    "mode": {
                        "type": "string",
                        "enum": [
                            "threshold",
                            "rank"
                        ],
                        "readOnly": true,
                        "example": "rank",
                        "description": "threshold (alle, die das Ziel erreichen, gewinnen) oder rank (die ersten Plätze gewinnen)."
                    },
                    "measure": {
                        "type": "string",
                        "enum": [
                            "value",
                            "improvement_pct",
                            "improvement_abs"
                        ],
                        "readOnly": true,
                        "example": "value",
                        "description": "value, improvement_pct oder improvement_abs."
                    },
                    "visibility": {
                        "type": "string",
                        "enum": [
                            "leaders",
                            "own",
                            "hidden"
                        ],
                        "readOnly": true,
                        "example": "leaders",
                        "description": "Was die Teilnehmenden währenddessen sehen: leaders, own oder hidden."
                    },
                    "sponsor_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 3,
                        "description": "Der Hauptsponsor (siehe /merch-partners), falls vorhanden."
                    },
                    "launched_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Gestartet."
                    },
                    "confirmed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann die Ergebnisse bestätigt wurden."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ContestResults": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 120,
                        "description": "Kennung."
                    },
                    "contest_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Der Wettbewerb."
                    },
                    "subject_type": {
                        "type": "string",
                        "enum": [
                            "employee",
                            "team",
                            "work_unit",
                            "department",
                            "geo_area"
                        ],
                        "readOnly": true,
                        "example": "work_unit",
                        "description": "employee, team, work_unit, department oder geo_area."
                    },
                    "subject_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 12,
                        "description": "Die Teilnahme (leer nach der Anonymisierung)."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 1240.5,
                        "description": "Der Wert des Kriteriums im Wettbewerb."
                    },
                    "baseline": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Der Durchschnitt der Zeiträume davor (Fortschrittswettbewerbe)."
                    },
                    "measure": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 1240.5,
                        "description": "Was verglichen wurde: der Wert oder der Fortschritt."
                    },
                    "place": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 1,
                        "description": "Der Platz (Gleichstände teilen ihn)."
                    },
                    "tier_key": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Die erreichte Stufe (Wettbewerbe mit Stufen)."
                    },
                    "wins": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob gewonnen wurde."
                    },
                    "eligible": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob teilnahmeberechtigt."
                    },
                    "ineligible_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Warum nicht: excluded, inactive, not_placed, not_present, not_employed_long_enough, no_data oder no_baseline."
                    },
                    "period_keys": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            "2026-11"
                        ],
                        "description": "Die Zeiträume des Wettbewerbs."
                    },
                    "confirmed_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Bestätigt."
                    }
                }
            },
            "ContestAwards": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 55,
                        "description": "Kennung."
                    },
                    "contest_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Der Wettbewerb."
                    },
                    "reward_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Der Preis (siehe /contest-rewards)."
                    },
                    "employee_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 31,
                        "description": "Wer ihn erhält (leer nach der Anonymisierung)."
                    },
                    "subject_type": {
                        "type": "string",
                        "readOnly": true,
                        "example": "employee",
                        "description": "Was gewonnen hat: die Person oder ihr Team, Standort, ihre Abteilung oder ihr Bereich."
                    },
                    "subject_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 31,
                        "description": "Die gewinnende Teilnahme."
                    },
                    "quantity": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Anzahl."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 150,
                        "description": "Informativer Wert beim Gewinn."
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 250,
                        "description": "Der Betrag eines Bonus (nur mit dem Scope sensitive)."
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "RON",
                        "description": "Die Währung von Wert oder Betrag."
                    },
                    "days": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Die Tage eines freien Tages."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "ready",
                            "delivered",
                            "acknowledged",
                            "declined",
                            "revoked"
                        ],
                        "readOnly": true,
                        "example": "pending",
                        "description": "pending, ready, delivered, acknowledged, declined oder revoked."
                    },
                    "sponsor_may_know": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": false,
                        "description": "Ob der Gewinner zugestimmt hat, dass der Sponsor es erfährt."
                    },
                    "delivered_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Übergeben."
                    },
                    "acknowledged_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Erhalten, vom Gewinner bestätigt."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    }
                }
            },
            "ContestRewards": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Kennung."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "product",
                            "voucher",
                            "bonus",
                            "day_off",
                            "experience",
                            "recognition"
                        ],
                        "example": "voucher",
                        "description": "product, voucher, bonus, day_off, experience oder recognition."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Book voucher",
                        "description": "Bezeichnung."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "sponsor_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 3,
                        "description": "Der Sponsor, der ihn stellt (siehe /merch-partners); leer: das Unternehmen."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 150,
                        "description": "Informativer Wert."
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 3,
                        "example": "RON",
                        "description": "Währung von Wert oder Betrag."
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 250,
                        "description": "Der Betrag eines Bonus (nur mit dem Scope sensitive)."
                    },
                    "leave_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ein freier Tag: die Abwesenheitsart, deren Saldo die Tage erhält."
                    },
                    "days": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Ein freier Tag: ganze oder halbe Tage."
                    },
                    "stock": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 10,
                        "description": "Wie viele es gibt; leer: unbegrenzt."
                    },
                    "available": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 8,
                        "description": "Wie viele noch vergeben werden können (nur lesend)."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob neue Wettbewerbe ihn anbieten dürfen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ContestRewardsInput": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "product",
                            "voucher",
                            "bonus",
                            "day_off",
                            "experience",
                            "recognition"
                        ],
                        "example": "voucher",
                        "description": "product, voucher, bonus, day_off, experience oder recognition."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Book voucher",
                        "description": "Bezeichnung."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "sponsor_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 3,
                        "description": "Der Sponsor, der ihn stellt (siehe /merch-partners); leer: das Unternehmen."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 150,
                        "description": "Informativer Wert."
                    },
                    "currency": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 3,
                        "example": "RON",
                        "description": "Währung von Wert oder Betrag."
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 250,
                        "description": "Der Betrag eines Bonus (nur mit dem Scope sensitive)."
                    },
                    "leave_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ein freier Tag: die Abwesenheitsart, deren Saldo die Tage erhält."
                    },
                    "days": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Ein freier Tag: ganze oder halbe Tage."
                    },
                    "stock": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 10,
                        "description": "Wie viele es gibt; leer: unbegrenzt."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob neue Wettbewerbe ihn anbieten dürfen."
                    }
                },
                "required": [
                    "kind",
                    "name"
                ]
            },
            "Courses": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Kennung."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Siguranța la incendiu",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Kurzbeschreibung, reiner Text."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Kategorie."
                    },
                    "category": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Obligatorii",
                        "description": "Name der Kategorie."
                    },
                    "author": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 160,
                        "description": "Verfasst von."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "published",
                            "archived"
                        ],
                        "example": "published",
                        "description": "draft, published oder archived; nur veröffentlichte Kurse können zugewiesen werden."
                    },
                    "estimated_minutes": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 20,
                        "description": "Geschätzte Dauer in Minuten."
                    },
                    "validity_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Wie viele Monate das Zertifikat gültig bleibt; leer: läuft nicht ab."
                    },
                    "issues_certificate": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob der Abschluss ein Zertifikat ausstellt."
                    },
                    "recertifies": {
                        "type": "boolean",
                        "example": false,
                        "description": "Ob Personen vor Ablauf des Zertifikats erneut eingeschrieben werden."
                    },
                    "points": {
                        "type": "integer",
                        "example": 10,
                        "description": "Beim Abschluss erhaltene Punkte."
                    },
                    "chapters_count": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Anzahl der Kapitel."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CoursesInput": {
                "type": "object",
                "properties": {
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Siguranța la incendiu",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Kurzbeschreibung, reiner Text."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Kategorie."
                    },
                    "author": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 160,
                        "description": "Verfasst von."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "published",
                            "archived"
                        ],
                        "example": "published",
                        "description": "draft, published oder archived; nur veröffentlichte Kurse können zugewiesen werden."
                    },
                    "estimated_minutes": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 20,
                        "description": "Geschätzte Dauer in Minuten."
                    },
                    "validity_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Wie viele Monate das Zertifikat gültig bleibt; leer: läuft nicht ab."
                    },
                    "issues_certificate": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob der Abschluss ein Zertifikat ausstellt."
                    },
                    "recertifies": {
                        "type": "boolean",
                        "example": false,
                        "description": "Ob Personen vor Ablauf des Zertifikats erneut eingeschrieben werden."
                    },
                    "points": {
                        "type": "integer",
                        "example": 10,
                        "description": "Beim Abschluss erhaltene Punkte."
                    }
                },
                "required": [
                    "title",
                    "status",
                    "points"
                ]
            },
            "LearningAssignments": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 31,
                        "description": "Kennung."
                    },
                    "course_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 7,
                        "description": "Der Kurs (oder test_id)."
                    },
                    "test_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ein eigenständiger Test (oder course_id)."
                    },
                    "available_from": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-05-01",
                        "description": "Ab wann er absolviert werden kann."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-05-31",
                        "description": "Fälligkeit."
                    },
                    "enrolls_newcomers": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob Personen, die später zu den Zielen passen, automatisch eingeschrieben werden."
                    },
                    "targets": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "type": "work_unit",
                                "id": 12
                            }
                        ],
                        "description": "Wer: eine Liste von {type, id}; type ist all, employee, position, work_unit, department oder geo_area (id leer bei all)."
                    },
                    "enrollments_count": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 14,
                        "description": "Eingeschriebene Personen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "LearningAssignmentsInput": {
                "type": "object",
                "properties": {
                    "course_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 7,
                        "description": "Der Kurs (oder test_id)."
                    },
                    "test_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Ein eigenständiger Test (oder course_id)."
                    },
                    "available_from": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-05-01",
                        "description": "Ab wann er absolviert werden kann."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-05-31",
                        "description": "Fälligkeit."
                    },
                    "enrolls_newcomers": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob Personen, die später zu den Zielen passen, automatisch eingeschrieben werden."
                    },
                    "targets": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "type": "work_unit",
                                "id": 12
                            }
                        ],
                        "description": "Wer: eine Liste von {type, id}; type ist all, employee, position, work_unit, department oder geo_area (id leer bei all)."
                    }
                },
                "required": [
                    "available_from",
                    "targets"
                ]
            },
            "Enrollments": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 501,
                        "description": "Kennung."
                    },
                    "assignment_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 31,
                        "description": "Die Zuweisung, aus der sie stammt."
                    },
                    "employee_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Die Person."
                    },
                    "course_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 7,
                        "description": "Der Kurs."
                    },
                    "test_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Der Test."
                    },
                    "available_from": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "description": "Verfügbar ab."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-05-31",
                        "description": "Fälligkeit."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "assigned",
                            "in_progress",
                            "awaiting_grading",
                            "completed",
                            "failed",
                            "excused"
                        ],
                        "readOnly": true,
                        "example": "completed",
                        "description": "assigned, in_progress, awaiting_grading, completed, failed oder excused."
                    },
                    "started_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Begonnen."
                    },
                    "completed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Abgeschlossen."
                    },
                    "score": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 90,
                        "description": "Testergebnis (%)."
                    },
                    "passed": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Ob der Test bestanden wurde."
                    },
                    "extra_attempts": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 0,
                        "description": "Gewährte zusätzliche Versuche."
                    },
                    "is_overdue": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": false,
                        "description": "Überfällig und nicht abgeschlossen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "Certificates": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 88,
                        "description": "Kennung."
                    },
                    "enrollment_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 501,
                        "description": "Die Einschreibung, aus der es stammt."
                    },
                    "employee_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Die Person."
                    },
                    "course_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Der Kurs."
                    },
                    "number": {
                        "type": "string",
                        "readOnly": true,
                        "example": "FV-2026-0042",
                        "description": "Zertifikatsnummer."
                    },
                    "verification_code": {
                        "type": "string",
                        "readOnly": true,
                        "example": "K7Q2M9XA",
                        "description": "Der öffentliche Prüfcode."
                    },
                    "issued_on": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-05-12",
                        "description": "Ausgestellt am."
                    },
                    "expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "example": "2027-05-12",
                        "description": "Gültig bis; leer: läuft nicht ab."
                    },
                    "is_valid": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Heute gültig."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "Audits": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 19,
                        "description": "Kennung."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 12,
                        "description": "Der geprüfte Standort."
                    },
                    "template_name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Verificare lunară farmacie",
                        "description": "Die verwendete Checkliste."
                    },
                    "auditor_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer es durchgeführt hat (Konto)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "completed"
                        ],
                        "readOnly": true,
                        "example": "completed",
                        "description": "draft oder completed."
                    },
                    "conducted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann es stattfand."
                    },
                    "completed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann es abgeschlossen wurde."
                    },
                    "score": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 88.89,
                        "description": "Score (%)."
                    },
                    "pass_score": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 80,
                        "description": "Bestehensgrenze (%)."
                    },
                    "passed": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Bestanden (nur abgeschlossene Audits)."
                    },
                    "critical_findings": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 0,
                        "description": "Nicht erfüllte kritische Punkte."
                    },
                    "is_self_check": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Von einer Person durchgeführt, die am Standort arbeitet oder ihn leitet (zählt nicht in die Audit-Kennzahlen)."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Anmerkungen."
                    },
                    "findings": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "section": "Frigider",
                                "item": "Termometrul este calibrat",
                                "weight": 2,
                                "critical": true,
                                "result": "not_ok",
                                "comment": "Ultima calibrare în martie."
                            }
                        ],
                        "description": "Jeder Punkt: {id, section, item, weight, critical, result (ok, not_ok, na), comment}."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "AuditActionPlans": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Kennung."
                    },
                    "audit_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 19,
                        "description": "Das Audit."
                    },
                    "result_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Die Feststellung, auf die sie antwortet."
                    },
                    "description": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Calibrați termometrul frigiderului și păstrați certificatul.",
                        "description": "Was getan werden muss."
                    },
                    "responsible_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer es tun muss (Konto)."
                    },
                    "due_on": {
                        "type": "string",
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-05-20",
                        "description": "Fälligkeit."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "done",
                            "verified",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "open",
                        "description": "open, done, verified oder cancelled."
                    },
                    "is_overdue": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Offen und überfällig."
                    },
                    "done_note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Was getan wurde (und warum sie wieder geöffnet wurde)."
                    },
                    "done_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Als erledigt markiert."
                    },
                    "verified_by": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer sie bestätigt hat (Konto)."
                    },
                    "verified_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Bestätigt."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "SsmTypes": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Instruire periodică",
                        "description": "Name."
                    },
                    "validity_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 6,
                        "description": "Monate der Gültigkeit; leer: läuft nicht ab."
                    },
                    "is_required": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "Für alle erforderlich."
                    },
                    "is_active": {
                        "type": "boolean",
                        "readOnly": true,
                        "description": "In Verwendung."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "SsmRecords": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 120,
                        "description": "Kennung."
                    },
                    "employee_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die Person."
                    },
                    "type_id": {
                        "type": "integer",
                        "example": 2,
                        "description": "Die Unterweisung oder Vorsorge."
                    },
                    "done_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-04-15",
                        "description": "Wann sie stattfand (nicht in der Zukunft)."
                    },
                    "valid_until": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-10-15",
                        "description": "Gültig bis (aus der Art)."
                    },
                    "state": {
                        "type": "string",
                        "enum": [
                            "valid",
                            "expiring",
                            "expired",
                            "missing",
                            "none"
                        ],
                        "readOnly": true,
                        "example": "valid",
                        "description": "Heute: valid, expiring, expired."
                    },
                    "trainer": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Unterweisende Person oder Arzt / Ärztin."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Anmerkungen."
                    },
                    "recorded_by": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer ihn erfasst hat (Konto)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "SsmRecordsInput": {
                "type": "object",
                "properties": {
                    "employee_id": {
                        "type": "integer",
                        "example": 345,
                        "description": "Die Person."
                    },
                    "type_id": {
                        "type": "integer",
                        "example": 2,
                        "description": "Die Unterweisung oder Vorsorge."
                    },
                    "done_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-04-15",
                        "description": "Wann sie stattfand (nicht in der Zukunft)."
                    },
                    "trainer": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "description": "Unterweisende Person oder Arzt / Ärztin."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 500,
                        "description": "Anmerkungen."
                    }
                },
                "required": [
                    "employee_id",
                    "type_id",
                    "done_on"
                ]
            },
            "DocumentCategories": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Autorizații",
                        "description": "Name, in der angefragten Sprache."
                    },
                    "scope": {
                        "type": "string",
                        "enum": [
                            "company",
                            "unit"
                        ],
                        "readOnly": true,
                        "example": "company",
                        "description": "company (Unternehmensdokumente) oder unit (Standortdokumente)."
                    },
                    "sort": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Position in Listen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "Documents": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 31,
                        "description": "Kennung."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Autorizație sanitară de funcționare",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 4,
                        "description": "Kategorie (siehe /document-categories)."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort, zu dem es gehört; leer für ein Unternehmensdokument. Nur beim Anlegen festgelegt."
                    },
                    "is_internal": {
                        "type": "boolean",
                        "example": false,
                        "description": "Nur sichtbar für die Verwaltung der Dokumente."
                    },
                    "expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-12-31",
                        "description": "Ablaufdatum."
                    },
                    "expiry_state": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "valid",
                            "expiring",
                            "expired"
                        ],
                        "readOnly": true,
                        "example": "valid",
                        "description": "valid, expiring oder expired (leer ohne Ablaufdatum)."
                    },
                    "repeat_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Alle so viele Monate erneuert."
                    },
                    "alert_days": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            30,
                            7
                        ],
                        "description": "Tage vor Ablauf, an denen Erinnerungen versendet werden (höchstens 6)."
                    },
                    "versions": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2,
                        "description": "Wie viele Versionen der Datei es gibt."
                    },
                    "file_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "autorizatie.pdf",
                        "description": "Der Name der aktuellen Datei."
                    },
                    "file_size": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 184220,
                        "description": "Ihre Größe in Byte."
                    },
                    "file_mime": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "application/pdf",
                        "description": "Ihr Typ."
                    },
                    "version_note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Ein Hinweis zur Version der Datei (angezeigt: der der aktuellen Version)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "DocumentsInput": {
                "type": "object",
                "properties": {
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Autorizație sanitară de funcționare",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Beschreibung."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 4,
                        "description": "Kategorie (siehe /document-categories)."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort, zu dem es gehört; leer für ein Unternehmensdokument. Nur beim Anlegen festgelegt."
                    },
                    "is_internal": {
                        "type": "boolean",
                        "example": false,
                        "description": "Nur sichtbar für die Verwaltung der Dokumente."
                    },
                    "expires_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-12-31",
                        "description": "Ablaufdatum."
                    },
                    "repeat_months": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Alle so viele Monate erneuert."
                    },
                    "alert_days": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            30,
                            7
                        ],
                        "description": "Tage vor Ablauf, an denen Erinnerungen versendet werden (höchstens 6)."
                    },
                    "file": {
                        "type": "object",
                        "properties": {
                            "name": {
                                "type": "string"
                            },
                            "content_base64": {
                                "type": "string"
                            }
                        },
                        "description": "Die Datei: {\"name\": \"…\", \"content_base64\": \"…\"}. Beim Anlegen erforderlich; beim Ändern fügt sie eine Version hinzu."
                    },
                    "version_note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Ein Hinweis zur Version der Datei (angezeigt: der der aktuellen Version)."
                    }
                },
                "required": [
                    "title",
                    "file"
                ]
            },
            "ServiceCategories": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Mentenanță și reparații",
                        "description": "Name, in der angefragten Sprache."
                    },
                    "is_active": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob darunter Anfragen gestellt werden können."
                    },
                    "needs_approval": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": false,
                        "description": "Ob eine Anfrage vor der Öffnung auf Genehmigung wartet."
                    },
                    "sort": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Position in Listen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ServiceRequests": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 88,
                        "description": "Kennung."
                    },
                    "category_id": {
                        "type": "integer",
                        "example": 2,
                        "description": "Kategorie (siehe /service-categories)."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort, für den sie ist."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Frigiderul de vaccinuri nu mai răcește",
                        "description": "Kurzer Titel."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 5000,
                        "description": "Was nicht stimmt oder gebraucht wird."
                    },
                    "requested_by": {
                        "type": "integer",
                        "example": 17,
                        "description": "Das Konto, für das sie gestellt wird (eine Person des Unternehmens); weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "employee_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Der Personaldatensatz der anfragenden Person."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "awaiting_approval",
                            "open",
                            "in_progress",
                            "resolved",
                            "unresolved",
                            "rejected",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "open",
                        "description": "awaiting_approval, open, in_progress, resolved, unresolved, rejected oder cancelled."
                    },
                    "assigned_to": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Das Konto, das sie übernommen hat."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie geschlossen wurde."
                    },
                    "history": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "status_from": "open",
                                "status_to": "in_progress",
                                "comment": "Vine tehnicianul mâine.",
                                "user_id": 9,
                                "at": "2026-05-04T08:00:00Z"
                            }
                        ],
                        "description": "Jede Statusänderung: von, nach, Kommentar, von wem, wann."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ServiceRequestsInput": {
                "type": "object",
                "properties": {
                    "category_id": {
                        "type": "integer",
                        "example": 2,
                        "description": "Kategorie (siehe /service-categories)."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort, für den sie ist."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Frigiderul de vaccinuri nu mai răcește",
                        "description": "Kurzer Titel."
                    },
                    "description": {
                        "type": "string",
                        "maxLength": 5000,
                        "description": "Was nicht stimmt oder gebraucht wird."
                    },
                    "requested_by": {
                        "type": "integer",
                        "example": 17,
                        "description": "Das Konto, für das sie gestellt wird (eine Person des Unternehmens); weggelassen: die Person, die den Schlüssel angelegt hat."
                    }
                },
                "required": [
                    "category_id",
                    "work_unit_id",
                    "title",
                    "description"
                ]
            },
            "Materials": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 7,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Mănuși nitril",
                        "description": "Name."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Beschreibung."
                    },
                    "unit": {
                        "type": "string",
                        "readOnly": true,
                        "example": "cutie",
                        "description": "Einheit."
                    },
                    "track_stock": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob der Bestand geführt wird."
                    },
                    "stock": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 35,
                        "description": "Aktueller Bestand (leer, wenn nicht geführt)."
                    },
                    "is_active": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob es angefordert werden kann."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "MaterialRequests": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 51,
                        "description": "Kennung."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort, für den sie ist."
                    },
                    "requested_by": {
                        "type": "integer",
                        "example": 17,
                        "description": "Das Konto, für das sie gestellt wird; weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "new",
                            "taken",
                            "completed",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "new",
                        "description": "new, taken, completed oder cancelled."
                    },
                    "handled_by": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Das bearbeitende Konto."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Eine Anmerkung."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "material_id": 7,
                                "quantity": 5
                            }
                        ],
                        "description": "Was angefordert wird: [{\"material_id\": 7, \"quantity\": 5}] (mindestens eine Position)."
                    },
                    "completed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie abgeschlossen wurde."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "MaterialRequestsInput": {
                "type": "object",
                "properties": {
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort, für den sie ist."
                    },
                    "requested_by": {
                        "type": "integer",
                        "example": 17,
                        "description": "Das Konto, für das sie gestellt wird; weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Eine Anmerkung."
                    },
                    "items": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "material_id": 7,
                                "quantity": 5
                            }
                        ],
                        "description": "Was angefordert wird: [{\"material_id\": 7, \"quantity\": 5}] (mindestens eine Position)."
                    }
                },
                "required": [
                    "work_unit_id",
                    "items"
                ]
            },
            "Surveys": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 5,
                        "description": "Kennung."
                    },
                    "title": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Climatul de lucru",
                        "description": "Titel."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Beschreibung."
                    },
                    "is_anonymous": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob die Antworten anonym sind."
                    },
                    "is_mandatory": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": false,
                        "description": "Ob die Teilnahme verpflichtend ist."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "published",
                            "closed"
                        ],
                        "readOnly": true,
                        "example": "closed",
                        "description": "published oder closed."
                    },
                    "opens_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie beginnt."
                    },
                    "closes_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie endet."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie veröffentlicht wurde."
                    },
                    "series_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Die Umfrageserie, deren Ausgabe sie ist; leer bei einer einmaligen Umfrage."
                    },
                    "edition": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Ihre Nummer in der Serie."
                    },
                    "questions": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "id": 11,
                                "type": "single",
                                "text": "Ați recomanda compania?",
                                "is_required": true,
                                "options": [
                                    {
                                        "id": 31,
                                        "label": "Da"
                                    }
                                ]
                            }
                        ],
                        "description": "Die Fragen: id, type (single, multiple, scale, text), text, required, options."
                    },
                    "results": {
                        "type": "object",
                        "readOnly": true,
                        "example": {
                            "hidden": false,
                            "responses": 14,
                            "questions": [
                                {
                                    "question_id": 11,
                                    "answered": 14,
                                    "counts": {
                                        "31": 11
                                    },
                                    "average": null
                                }
                            ]
                        },
                        "description": "Summen: hidden, sealed, responses, assigned, completed und pro Frage, wie viele geantwortet haben, Anzahl pro Option oder Skalenwert, der Durchschnitt."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "SurveyResponses": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "string",
                        "readOnly": true,
                        "example": "9b2f4c1e-6f0a-4e7c-9a51-3c2d1e0f7a88",
                        "description": "Kennung (eine UUID)."
                    },
                    "survey_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 5,
                        "description": "Die Umfrage."
                    },
                    "employee_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 345,
                        "description": "Wer geantwortet hat."
                    },
                    "submitted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann."
                    },
                    "answers": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "question_id": 11,
                                "option_id": 31,
                                "value": null,
                                "text": null
                            }
                        ],
                        "description": "Die Antworten: Frage, gewählte Option, Wert (Skala) oder Text."
                    }
                }
            },
            "Posts": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 120,
                        "description": "Kennung."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "post",
                            "news",
                            "announcement",
                            "promotion",
                            "contest"
                        ],
                        "example": "announcement",
                        "description": "post, news, announcement, promotion oder contest."
                    },
                    "title": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "example": "Program de sărbători",
                        "description": "Titel (optional)."
                    },
                    "body": {
                        "type": "string",
                        "maxLength": 200000,
                        "example": "Între 24 și 26 decembrie programul este 9–14.",
                        "description": "Der Text (beim Lesen reiner Text)."
                    },
                    "author": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Maria Matei",
                        "description": "Wer ihn geschrieben hat."
                    },
                    "comments_enabled": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob kommentiert werden kann."
                    },
                    "comments_count": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 3,
                        "description": "Wie viele Kommentare."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Wann er veröffentlicht wird; ein Zeitpunkt in der Zukunft plant ihn ein."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "PostsInput": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "post",
                            "news",
                            "announcement",
                            "promotion",
                            "contest"
                        ],
                        "example": "announcement",
                        "description": "post, news, announcement, promotion oder contest."
                    },
                    "title": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 200,
                        "example": "Program de sărbători",
                        "description": "Titel (optional)."
                    },
                    "body": {
                        "type": "string",
                        "maxLength": 200000,
                        "example": "Între 24 și 26 decembrie programul este 9–14.",
                        "description": "Der Text (beim Lesen reiner Text)."
                    },
                    "comments_enabled": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob kommentiert werden kann."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "description": "Wann er veröffentlicht wird; ein Zeitpunkt in der Zukunft plant ihn ein."
                    }
                },
                "required": [
                    "type",
                    "body"
                ]
            },
            "KnowledgeArticles": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 9,
                        "description": "Kennung."
                    },
                    "category_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 2,
                        "description": "Thema."
                    },
                    "category": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "example": "Operațiuni",
                        "description": "Name des Themas."
                    },
                    "title": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Recepția mărfii",
                        "description": "Titel."
                    },
                    "summary": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Zusammenfassung."
                    },
                    "body": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Der Artikel, als reiner Text."
                    },
                    "is_featured": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob er empfohlen ist."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Erstmals veröffentlicht."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmContacts": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 120,
                        "description": "Kennung."
                    },
                    "first_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Ioana",
                        "description": "Vorname."
                    },
                    "last_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Pop",
                        "description": "Nachname."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "example": "ioana.pop@example.com",
                        "description": "E-Mail-Adresse (eindeutig im Unternehmen, in Kleinbuchstaben gespeichert)."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "0722 111 222",
                        "description": "Telefonnummer, wie geschrieben."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 31,
                        "description": "Die Organisation, zu der die Person gehört (siehe /crm-accounts)."
                    },
                    "job_title": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Ihre Funktion dort."
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Cluj-Napoca",
                        "description": "Ort."
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2,
                        "example": "RO",
                        "description": "Land, als zweistelliger ISO-Code."
                    },
                    "locale": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2,
                        "example": "ro",
                        "description": "Die Sprache, in der sie angesprochen wird (ro, en …)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "lead",
                            "customer",
                            "inactive"
                        ],
                        "example": "customer",
                        "description": "lead, customer oder inactive. Ein Kauf oder eine gewonnene Verkaufschance macht aus einem Interessenten einen Kunden."
                    },
                    "source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "walk_in",
                            "website",
                            "phone",
                            "referral",
                            "campaign",
                            "event",
                            "partner",
                            "other"
                        ],
                        "example": "walk_in",
                        "description": "Woher die Person kam: walk_in, website, phone, referral, campaign, event, partner oder other."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            "loyalty"
                        ],
                        "description": "Schlagwörter (Kleinbuchstaben, höchstens 20)."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    },
                    "marketing_consent": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob die Person derzeit Marketing zustimmt (nur lesbar – geändert über die Aktion consent)."
                    },
                    "consent_updated_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sich die Einwilligung zuletzt geändert hat."
                    },
                    "last_activity_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann zuletzt etwas mit ihr getan wurde."
                    },
                    "erased_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann ihre Daten auf Wunsch gelöscht wurden (der Eintrag ist dann nur lesbar)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmContactsInput": {
                "type": "object",
                "properties": {
                    "first_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Ioana",
                        "description": "Vorname."
                    },
                    "last_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Pop",
                        "description": "Nachname."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "example": "ioana.pop@example.com",
                        "description": "E-Mail-Adresse (eindeutig im Unternehmen, in Kleinbuchstaben gespeichert)."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "0722 111 222",
                        "description": "Telefonnummer, wie geschrieben."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 31,
                        "description": "Die Organisation, zu der die Person gehört (siehe /crm-accounts)."
                    },
                    "job_title": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "description": "Ihre Funktion dort."
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Cluj-Napoca",
                        "description": "Ort."
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2,
                        "example": "RO",
                        "description": "Land, als zweistelliger ISO-Code."
                    },
                    "locale": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2,
                        "example": "ro",
                        "description": "Die Sprache, in der sie angesprochen wird (ro, en …)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "lead",
                            "customer",
                            "inactive"
                        ],
                        "example": "customer",
                        "description": "lead, customer oder inactive. Ein Kauf oder eine gewonnene Verkaufschance macht aus einem Interessenten einen Kunden."
                    },
                    "source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "walk_in",
                            "website",
                            "phone",
                            "referral",
                            "campaign",
                            "event",
                            "partner",
                            "other"
                        ],
                        "example": "walk_in",
                        "description": "Woher die Person kam: walk_in, website, phone, referral, campaign, event, partner oder other."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            "loyalty"
                        ],
                        "description": "Schlagwörter (Kleinbuchstaben, höchstens 20)."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    }
                }
            },
            "CrmAccounts": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 31,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Hotel Sigma SRL",
                        "description": "Name (eindeutig im Unternehmen)."
                    },
                    "registration_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "J12/345/2019",
                        "description": "Handelsregisternummer."
                    },
                    "vat_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "RO12345678",
                        "description": "USt-IdNr."
                    },
                    "industry": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Hospitality",
                        "description": "Branche."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "example": "office@sigma.example",
                        "description": "E-Mail-Adresse."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "0264 000 111",
                        "description": "Telefonnummer."
                    },
                    "website": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "description": "Website."
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Adresse."
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Cluj-Napoca",
                        "description": "Ort."
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2,
                        "example": "RO",
                        "description": "Land, als zweistelliger ISO-Code."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            "corporate",
                            "events"
                        ],
                        "description": "Schlagwörter (Kleinbuchstaben, höchstens 20)."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmAccountsInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Hotel Sigma SRL",
                        "description": "Name (eindeutig im Unternehmen)."
                    },
                    "registration_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "J12/345/2019",
                        "description": "Handelsregisternummer."
                    },
                    "vat_number": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "RO12345678",
                        "description": "USt-IdNr."
                    },
                    "industry": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Hospitality",
                        "description": "Branche."
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "example": "office@sigma.example",
                        "description": "E-Mail-Adresse."
                    },
                    "phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "0264 000 111",
                        "description": "Telefonnummer."
                    },
                    "website": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "description": "Website."
                    },
                    "address": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 255,
                        "description": "Adresse."
                    },
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Cluj-Napoca",
                        "description": "Ort."
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2,
                        "example": "RO",
                        "description": "Land, als zweistelliger ISO-Code."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "tags": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            "corporate",
                            "events"
                        ],
                        "description": "Schlagwörter (Kleinbuchstaben, höchstens 20)."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "CrmPipelines": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "readOnly": true,
                        "example": "Sales",
                        "description": "Name."
                    },
                    "is_default": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": true,
                        "description": "Ob neue Verkaufschancen hierher gehen, wenn keine Pipeline angegeben ist."
                    },
                    "sort": {
                        "type": "integer",
                        "readOnly": true,
                        "description": "Position in Listen."
                    },
                    "stages": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "id": 3,
                                "name": "Proposal sent",
                                "kind": "open",
                                "probability": 60,
                                "sort": 20
                            },
                            {
                                "id": 5,
                                "name": "Won",
                                "kind": "won",
                                "probability": 100,
                                "sort": 40
                            }
                        ],
                        "description": "Ihre Phasen in Reihenfolge: id, name, kind (open, won oder lost), probability (0–100) und sort."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmDeals": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 77,
                        "description": "Kennung."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Corporate rates 2027",
                        "description": "Was verkauft wird."
                    },
                    "pipeline_id": {
                        "type": "integer",
                        "example": 1,
                        "description": "Die Pipeline (siehe /crm-pipelines). Nur beim Anlegen festgelegt."
                    },
                    "stage_id": {
                        "type": "integer",
                        "example": 3,
                        "description": "Die Phase. Nur beim Anlegen festgelegt; danach über die Aktionen."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "won",
                            "lost"
                        ],
                        "readOnly": true,
                        "example": "open",
                        "description": "open, won oder lost – die Art ihrer Phase."
                    },
                    "contact_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 120,
                        "description": "Der Kunde (siehe /crm-contacts)."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 31,
                        "description": "Die Organisation (siehe /crm-accounts)."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 12500.5,
                        "description": "Was sie wert ist."
                    },
                    "currency": {
                        "type": "string",
                        "maxLength": 3,
                        "example": "RON",
                        "description": "Die Währung des Werts (ISO-Code); weggelassen: die CRM-Währung des Unternehmens."
                    },
                    "expected_close_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-12-15",
                        "description": "Wann der Abschluss erwartet wird."
                    },
                    "closed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann sie gewonnen oder verloren wurde."
                    },
                    "lost_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Warum sie verloren ging."
                    },
                    "source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "walk_in",
                            "website",
                            "phone",
                            "referral",
                            "campaign",
                            "event",
                            "partner",
                            "other"
                        ],
                        "example": "referral",
                        "description": "Woher sie kam (wie bei Kunden)."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmDealsInput": {
                "type": "object",
                "properties": {
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Corporate rates 2027",
                        "description": "Was verkauft wird."
                    },
                    "pipeline_id": {
                        "type": "integer",
                        "example": 1,
                        "description": "Die Pipeline (siehe /crm-pipelines). Nur beim Anlegen festgelegt."
                    },
                    "stage_id": {
                        "type": "integer",
                        "example": 3,
                        "description": "Die Phase. Nur beim Anlegen festgelegt; danach über die Aktionen."
                    },
                    "contact_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 120,
                        "description": "Der Kunde (siehe /crm-contacts)."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 31,
                        "description": "Die Organisation (siehe /crm-accounts)."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 12500.5,
                        "description": "Was sie wert ist."
                    },
                    "currency": {
                        "type": "string",
                        "maxLength": 3,
                        "example": "RON",
                        "description": "Die Währung des Werts (ISO-Code); weggelassen: die CRM-Währung des Unternehmens."
                    },
                    "expected_close_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-12-15",
                        "description": "Wann der Abschluss erwartet wird."
                    },
                    "source": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "walk_in",
                            "website",
                            "phone",
                            "referral",
                            "campaign",
                            "event",
                            "partner",
                            "other"
                        ],
                        "example": "referral",
                        "description": "Woher sie kam (wie bei Kunden)."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    }
                },
                "required": [
                    "title"
                ]
            },
            "CrmActivities": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 530,
                        "description": "Kennung."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "call",
                            "meeting",
                            "visit",
                            "email",
                            "task",
                            "note",
                            "purchase"
                        ],
                        "example": "purchase",
                        "description": "call, meeting, visit, email, task, note oder purchase."
                    },
                    "subject": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Receipt 1243",
                        "description": "Kurzbeschreibung."
                    },
                    "body": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Details."
                    },
                    "contact_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 120,
                        "description": "Der Kunde."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Organisation."
                    },
                    "deal_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Verkaufschance, zu der sie gehört."
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 240,
                        "description": "Der Betrag eines Kaufs, in der CRM-Währung des Unternehmens (leer bei den anderen Arten)."
                    },
                    "due_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "example": "2026-11-03T09:00:00Z",
                        "description": "Wann eine Aufgabe fällig ist."
                    },
                    "done_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "example": "2026-11-02T15:20:00Z",
                        "description": "Wann sie erledigt wurde; leer bei einer noch offenen Aufgabe."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmActivitiesInput": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "enum": [
                            "call",
                            "meeting",
                            "visit",
                            "email",
                            "task",
                            "note",
                            "purchase"
                        ],
                        "example": "purchase",
                        "description": "call, meeting, visit, email, task, note oder purchase."
                    },
                    "subject": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Receipt 1243",
                        "description": "Kurzbeschreibung."
                    },
                    "body": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Details."
                    },
                    "contact_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 120,
                        "description": "Der Kunde."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Organisation."
                    },
                    "deal_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Verkaufschance, zu der sie gehört."
                    },
                    "amount": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 240,
                        "description": "Der Betrag eines Kaufs, in der CRM-Währung des Unternehmens (leer bei den anderen Arten)."
                    },
                    "due_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "example": "2026-11-03T09:00:00Z",
                        "description": "Wann eine Aufgabe fällig ist."
                    },
                    "done_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "example": "2026-11-02T15:20:00Z",
                        "description": "Wann sie erledigt wurde; leer bei einer noch offenen Aufgabe."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    }
                },
                "required": [
                    "type",
                    "subject"
                ]
            },
            "CrmFeedback": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 64,
                        "description": "Kennung."
                    },
                    "kind": {
                        "type": "string",
                        "enum": [
                            "feedback",
                            "complaint"
                        ],
                        "example": "feedback",
                        "description": "feedback oder complaint. Nur beim Anlegen festgelegt."
                    },
                    "contact_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 120,
                        "description": "Der Kunde."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Organisation."
                    },
                    "score": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 9,
                        "description": "Von 0 bis 10."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "example": "Quick and friendly service.",
                        "description": "Was gesagt wurde."
                    },
                    "channel": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "in_person",
                            "phone",
                            "email",
                            "website",
                            "review_site",
                            "survey",
                            "other"
                        ],
                        "example": "in_person",
                        "description": "Wie es kam: in_person, phone, email, website, review_site, survey oder other."
                    },
                    "received_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-11-02",
                        "description": "Wann es einging (weggelassen: heute)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "open",
                            "resolved"
                        ],
                        "readOnly": true,
                        "example": "resolved",
                        "description": "open (eine noch nicht erledigte Reklamation) oder resolved."
                    },
                    "resolved_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann die Reklamation erledigt wurde."
                    },
                    "resolution": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Was dazu getan wurde."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "CrmFeedbackInput": {
                "type": "object",
                "properties": {
                    "kind": {
                        "type": "string",
                        "enum": [
                            "feedback",
                            "complaint"
                        ],
                        "example": "feedback",
                        "description": "feedback oder complaint. Nur beim Anlegen festgelegt."
                    },
                    "contact_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 120,
                        "description": "Der Kunde."
                    },
                    "account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "description": "Die Organisation."
                    },
                    "score": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 9,
                        "description": "Von 0 bis 10."
                    },
                    "comment": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "example": "Quick and friendly service.",
                        "description": "Was gesagt wurde."
                    },
                    "channel": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "enum": [
                            "in_person",
                            "phone",
                            "email",
                            "website",
                            "review_site",
                            "survey",
                            "other"
                        ],
                        "example": "in_person",
                        "description": "Wie es kam: in_person, phone, email, website, review_site, survey oder other."
                    },
                    "received_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-11-02",
                        "description": "Wann es einging (weggelassen: heute)."
                    },
                    "work_unit_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 12,
                        "description": "Der Standort (Filiale, Hotel, Büro), der sie betreut; leer für keinen."
                    },
                    "owner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 17,
                        "description": "Das Konto, das sie betreut; beim Anlegen weggelassen: die Person, die den Schlüssel angelegt hat."
                    }
                },
                "required": [
                    "kind"
                ]
            },
            "MerchPartners": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 3,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 150,
                        "example": "Dermalab",
                        "description": "Name des Partners (eindeutig im Unternehmen)."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "DLB",
                        "description": "Internes Kürzel."
                    },
                    "contact_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150,
                        "example": "Ana Ionescu",
                        "description": "Ansprechperson."
                    },
                    "contact_email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "example": "ana@dermalab.example",
                        "description": "E-Mail der Ansprechperson."
                    },
                    "contact_phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "0722 000 111",
                        "description": "Telefon der Ansprechperson."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    },
                    "crm_account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 31,
                        "description": "Die passende CRM-Organisation (siehe /crm-accounts), falls vorhanden."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob er neue Kampagnen erhalten kann."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "MerchPartnersInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150,
                        "example": "Dermalab",
                        "description": "Name des Partners (eindeutig im Unternehmen)."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "DLB",
                        "description": "Internes Kürzel."
                    },
                    "contact_name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 150,
                        "example": "Ana Ionescu",
                        "description": "Ansprechperson."
                    },
                    "contact_email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 190,
                        "example": "ana@dermalab.example",
                        "description": "E-Mail der Ansprechperson."
                    },
                    "contact_phone": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "0722 000 111",
                        "description": "Telefon der Ansprechperson."
                    },
                    "notes": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 5000,
                        "description": "Notizen."
                    },
                    "crm_account_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 31,
                        "description": "Die passende CRM-Organisation (siehe /crm-accounts), falls vorhanden."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob er neue Kampagnen erhalten kann."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "SpaceZoneTypes": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 2,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Ramă click A2",
                        "description": "Name."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Beschreibung."
                    },
                    "width_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 50,
                        "description": "Breite in Zentimetern."
                    },
                    "height_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 70,
                        "description": "Höhe in Zentimetern."
                    },
                    "depth_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Tiefe in Zentimetern."
                    },
                    "faces": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Seiten (1 oder 2: A, B)."
                    },
                    "capacity": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Stück auf eine Seite passen."
                    },
                    "capacity_label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "example": "afișe A2",
                        "description": "Was die Kapazität zählt (z. B. „A2-Plakate“)."
                    },
                    "is_display": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es eine Präsentationsfläche ist (kann Kampagnen aufnehmen)."
                    },
                    "monthly_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 150,
                        "description": "Der Monatspreis für eine Kapazitätseinheit (Vorschlag für Kampagnenwerte)."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob sie noch verwendet wird."
                    },
                    "sort": {
                        "type": "integer",
                        "example": 10,
                        "description": "Reihenfolge in Listen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "SpaceZoneTypesInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Ramă click A2",
                        "description": "Name."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Beschreibung."
                    },
                    "width_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 50,
                        "description": "Breite in Zentimetern."
                    },
                    "height_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 70,
                        "description": "Höhe in Zentimetern."
                    },
                    "depth_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Tiefe in Zentimetern."
                    },
                    "faces": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Seiten (1 oder 2: A, B)."
                    },
                    "capacity": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Stück auf eine Seite passen."
                    },
                    "capacity_label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "example": "afișe A2",
                        "description": "Was die Kapazität zählt (z. B. „A2-Plakate“)."
                    },
                    "is_display": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es eine Präsentationsfläche ist (kann Kampagnen aufnehmen)."
                    },
                    "monthly_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 150,
                        "description": "Der Monatspreis für eine Kapazitätseinheit (Vorschlag für Kampagnenwerte)."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob sie noch verwendet wird."
                    },
                    "sort": {
                        "type": "integer",
                        "example": 10,
                        "description": "Reihenfolge in Listen."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "SpaceZones": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 41,
                        "description": "Kennung."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort – nur beim Anlegen."
                    },
                    "zone_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 2,
                        "description": "Die Zonenart (siehe /space-zone-types), falls vorhanden."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Ramă click intrare",
                        "description": "Name (z. B. „Totem rechts neben der Tür“)."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Beschreibung."
                    },
                    "width_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 50,
                        "description": "Breite in Zentimetern."
                    },
                    "height_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 70,
                        "description": "Höhe in Zentimetern."
                    },
                    "depth_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Tiefe in Zentimetern."
                    },
                    "area_m2": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Fläche in Quadratmetern."
                    },
                    "faces": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Seiten (1 oder 2)."
                    },
                    "capacity": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Stück auf eine Seite passen."
                    },
                    "capacity_label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "example": "afișe A2",
                        "description": "Was die Kapazität zählt."
                    },
                    "is_display": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es eine Präsentationsfläche ist."
                    },
                    "monthly_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 150,
                        "description": "Monatspreis (schreibt nur, wer Beträge sieht)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "unavailable"
                        ],
                        "example": "active",
                        "description": "active oder unavailable (vorübergehend)."
                    },
                    "pin_x": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 42.5,
                        "description": "Position auf der Skizze des Standorts, Prozent von links (in der Anwendung platziert)."
                    },
                    "pin_y": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 88,
                        "description": "Position auf der Skizze des Standorts, Prozent von oben."
                    },
                    "sort": {
                        "type": "integer",
                        "example": 100,
                        "description": "Reihenfolge am Standort."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "SpaceZonesInput": {
                "type": "object",
                "properties": {
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort – nur beim Anlegen."
                    },
                    "zone_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 2,
                        "description": "Die Zonenart (siehe /space-zone-types), falls vorhanden."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Ramă click intrare",
                        "description": "Name (z. B. „Totem rechts neben der Tür“)."
                    },
                    "description": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 1000,
                        "description": "Beschreibung."
                    },
                    "width_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 50,
                        "description": "Breite in Zentimetern."
                    },
                    "height_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 70,
                        "description": "Höhe in Zentimetern."
                    },
                    "depth_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Tiefe in Zentimetern."
                    },
                    "area_m2": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Fläche in Quadratmetern."
                    },
                    "faces": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Seiten (1 oder 2)."
                    },
                    "capacity": {
                        "type": "integer",
                        "example": 2,
                        "description": "Wie viele Stück auf eine Seite passen."
                    },
                    "capacity_label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "example": "afișe A2",
                        "description": "Was die Kapazität zählt."
                    },
                    "is_display": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es eine Präsentationsfläche ist."
                    },
                    "monthly_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 150,
                        "description": "Monatspreis (schreibt nur, wer Beträge sieht)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "unavailable"
                        ],
                        "example": "active",
                        "description": "active oder unavailable (vorübergehend)."
                    },
                    "sort": {
                        "type": "integer",
                        "example": 100,
                        "description": "Reihenfolge am Standort."
                    }
                },
                "required": [
                    "work_unit_id",
                    "name"
                ]
            },
            "ShelfFixtureTypes": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 1,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Gondolă",
                        "description": "Name."
                    },
                    "face_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 25,
                        "description": "Preis pro Produkt-Facing und Monat."
                    },
                    "meter_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Preis pro Regalmeter und Monat."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es noch verwendet wird."
                    },
                    "sort": {
                        "type": "integer",
                        "example": 10,
                        "description": "Reihenfolge in Listen."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ShelfFixtureTypesInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 120,
                        "example": "Gondolă",
                        "description": "Name."
                    },
                    "face_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 25,
                        "description": "Preis pro Produkt-Facing und Monat."
                    },
                    "meter_price": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Preis pro Regalmeter und Monat."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es noch verwendet wird."
                    },
                    "sort": {
                        "type": "integer",
                        "example": 10,
                        "description": "Reihenfolge in Listen."
                    }
                },
                "required": [
                    "name"
                ]
            },
            "ShelfPlanograms": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 4,
                        "description": "Kennung."
                    },
                    "name": {
                        "type": "string",
                        "maxLength": 150,
                        "example": "Capăt de raft vitamine",
                        "description": "Name (eindeutig)."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "CR-VIT",
                        "description": "Internes Kürzel."
                    },
                    "fixture_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 2,
                        "description": "Die Möbelart (siehe /shelf-fixture-types)."
                    },
                    "category": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Suplimente",
                        "description": "Produktkategorie."
                    },
                    "width_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 100,
                        "description": "Breite in Zentimetern."
                    },
                    "height_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 180,
                        "description": "Höhe in Zentimetern."
                    },
                    "depth_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Tiefe in Zentimetern."
                    },
                    "capacity_unit": {
                        "type": "string",
                        "enum": [
                            "faces",
                            "cm"
                        ],
                        "example": "faces",
                        "description": "faces: Regalkapazität in Produkt-Facings; cm: in Zentimetern."
                    },
                    "instructions": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20000,
                        "description": "Wie es aufgebaut wird (formatierter Text, bereinigt)."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es noch aufgestellt wird."
                    },
                    "shelves": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "position": 1,
                                "label": null,
                                "capacity": 8,
                                "price_factor": 1.2
                            },
                            {
                                "position": 2,
                                "label": "La nivelul ochilor",
                                "capacity": 8,
                                "price_factor": 1.5
                            }
                        ],
                        "description": "Die Regalböden, von oben nach unten: [{label, capacity, price_factor}] (die Position folgt der Liste; price_factor schreibt nur, wer Preise sieht)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ShelfPlanogramsInput": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "maxLength": 150,
                        "example": "Capăt de raft vitamine",
                        "description": "Name (eindeutig)."
                    },
                    "code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 40,
                        "example": "CR-VIT",
                        "description": "Internes Kürzel."
                    },
                    "fixture_type_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 2,
                        "description": "Die Möbelart (siehe /shelf-fixture-types)."
                    },
                    "category": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 120,
                        "example": "Suplimente",
                        "description": "Produktkategorie."
                    },
                    "width_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 100,
                        "description": "Breite in Zentimetern."
                    },
                    "height_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 180,
                        "description": "Höhe in Zentimetern."
                    },
                    "depth_cm": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Tiefe in Zentimetern."
                    },
                    "capacity_unit": {
                        "type": "string",
                        "enum": [
                            "faces",
                            "cm"
                        ],
                        "example": "faces",
                        "description": "faces: Regalkapazität in Produkt-Facings; cm: in Zentimetern."
                    },
                    "instructions": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20000,
                        "description": "Wie es aufgebaut wird (formatierter Text, bereinigt)."
                    },
                    "is_active": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob es noch aufgestellt wird."
                    },
                    "shelves": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "position": 1,
                                "label": null,
                                "capacity": 8,
                                "price_factor": 1.2
                            },
                            {
                                "position": 2,
                                "label": "La nivelul ochilor",
                                "capacity": 8,
                                "price_factor": 1.5
                            }
                        ],
                        "description": "Die Regalböden, von oben nach unten: [{label, capacity, price_factor}] (die Position folgt der Liste; price_factor schreibt nur, wer Preise sieht)."
                    }
                },
                "required": [
                    "name",
                    "shelves"
                ]
            },
            "ShelfPlacements": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 88,
                        "description": "Kennung."
                    },
                    "planogram_id": {
                        "type": "integer",
                        "example": 4,
                        "description": "Das Planogramm – nur beim Anlegen."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort – nur beim Anlegen."
                    },
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "example": "lângă casă",
                        "description": "Eine Bezeichnung, die es von einer weiteren Aufstellung desselben Planogramms am Standort unterscheidet."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "active",
                            "removed"
                        ],
                        "readOnly": true,
                        "example": "active",
                        "description": "active oder removed."
                    },
                    "installed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-02-18",
                        "description": "Datum der Aufstellung."
                    },
                    "removed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "description": "Datum der Entfernung."
                    },
                    "local_note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Was hier vom üblichen Planogramm abweicht."
                    },
                    "setup_cost": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Aufbaukosten."
                    },
                    "monthly_cost": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 25,
                        "description": "Monatliche Kosten hier (Pflege, Abschreibung)."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "ShelfPlacementsInput": {
                "type": "object",
                "properties": {
                    "planogram_id": {
                        "type": "integer",
                        "example": 4,
                        "description": "Das Planogramm – nur beim Anlegen."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "example": 12,
                        "description": "Der Standort – nur beim Anlegen."
                    },
                    "label": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 60,
                        "example": "lângă casă",
                        "description": "Eine Bezeichnung, die es von einer weiteren Aufstellung desselben Planogramms am Standort unterscheidet."
                    },
                    "installed_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "example": "2026-02-18",
                        "description": "Datum der Aufstellung."
                    },
                    "local_note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 2000,
                        "description": "Was hier vom üblichen Planogramm abweicht."
                    },
                    "setup_cost": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "description": "Aufbaukosten."
                    },
                    "monthly_cost": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 25,
                        "description": "Monatliche Kosten hier (Pflege, Abschreibung)."
                    }
                },
                "required": [
                    "planogram_id",
                    "work_unit_id"
                ]
            },
            "MerchCampaigns": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 15,
                        "description": "Kennung."
                    },
                    "module": {
                        "type": "string",
                        "enum": [
                            "spaces",
                            "shelf"
                        ],
                        "example": "shelf",
                        "description": "spaces oder shelf – nur beim Anlegen."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Dermalab – raftul de la ochi",
                        "description": "Titel der Kampagne."
                    },
                    "partner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 3,
                        "description": "Der zahlende Partner (siehe /merch-partners); leer: eigene Kampagne des Unternehmens."
                    },
                    "instructions": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20000,
                        "description": "Anleitung zur Umsetzung (formatierter Text, bereinigt)."
                    },
                    "starts_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-11-02",
                        "description": "Erster Tag."
                    },
                    "ends_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-11-30",
                        "description": "Letzter Tag."
                    },
                    "implement_days": {
                        "type": "integer",
                        "example": 3,
                        "description": "Tage, die ein Standort ab Beginn zum Aufbauen hat."
                    },
                    "remove_days": {
                        "type": "integer",
                        "example": 2,
                        "description": "Tage, die ein Standort nach dem Ende zum Abbauen hat."
                    },
                    "proof_required": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob ein Standort beim Bestätigen Fotos senden muss."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 9600,
                        "description": "Was der Partner für die ganze Kampagne zahlt, ohne Umsatzsteuer."
                    },
                    "cost": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 0,
                        "description": "Was sie das Unternehmen kostet (Material, Aufbau), ohne Umsatzsteuer."
                    },
                    "currency": {
                        "type": "string",
                        "readOnly": true,
                        "example": "RON",
                        "description": "Die Währung der Beträge (aus den Einstellungen des Moduls)."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "launched",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "draft",
                        "description": "draft, launched oder cancelled."
                    },
                    "phase": {
                        "type": "string",
                        "enum": [
                            "draft",
                            "scheduled",
                            "running",
                            "ended",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "scheduled",
                        "description": "draft, scheduled, running, ended oder cancelled."
                    },
                    "units": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            12,
                            13
                        ],
                        "description": "Die Standorte (Standort-IDs), zusammen mit rules."
                    },
                    "rules": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "planogram_id": 4,
                                "position": 2,
                                "quantity": 6,
                                "products": "Vitamina D3"
                            }
                        ],
                        "description": "Die Regeln, die Plätze nennen, zusammen mit units. spaces: [{zone_type_id oder zone_id, face (A/B), quantity}]; shelf: [{planogram_id oder placement_id, position (Regalboden, von oben), quantity, products}]."
                    },
                    "targets": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "readOnly": true,
                        "example": [
                            {
                                "work_unit_id": 12,
                                "placement_id": 88,
                                "shelf_id": 210,
                                "quantity": 6,
                                "products": "Vitamina D3"
                            }
                        ],
                        "description": "Die sich ergebenden Plätze: pro Standort Zone und Seite oder Aufstellung und Regalboden, mit der Menge."
                    },
                    "launched_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann gestartet."
                    },
                    "cancelled_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann storniert."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            },
            "MerchCampaignsInput": {
                "type": "object",
                "properties": {
                    "module": {
                        "type": "string",
                        "enum": [
                            "spaces",
                            "shelf"
                        ],
                        "example": "shelf",
                        "description": "spaces oder shelf – nur beim Anlegen."
                    },
                    "title": {
                        "type": "string",
                        "maxLength": 200,
                        "example": "Dermalab – raftul de la ochi",
                        "description": "Titel der Kampagne."
                    },
                    "partner_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "example": 3,
                        "description": "Der zahlende Partner (siehe /merch-partners); leer: eigene Kampagne des Unternehmens."
                    },
                    "instructions": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "maxLength": 20000,
                        "description": "Anleitung zur Umsetzung (formatierter Text, bereinigt)."
                    },
                    "starts_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-11-02",
                        "description": "Erster Tag."
                    },
                    "ends_on": {
                        "type": "string",
                        "format": "date",
                        "example": "2026-11-30",
                        "description": "Letzter Tag."
                    },
                    "implement_days": {
                        "type": "integer",
                        "example": 3,
                        "description": "Tage, die ein Standort ab Beginn zum Aufbauen hat."
                    },
                    "remove_days": {
                        "type": "integer",
                        "example": 2,
                        "description": "Tage, die ein Standort nach dem Ende zum Abbauen hat."
                    },
                    "proof_required": {
                        "type": "boolean",
                        "example": true,
                        "description": "Ob ein Standort beim Bestätigen Fotos senden muss."
                    },
                    "value": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 9600,
                        "description": "Was der Partner für die ganze Kampagne zahlt, ohne Umsatzsteuer."
                    },
                    "cost": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "example": 0,
                        "description": "Was sie das Unternehmen kostet (Material, Aufbau), ohne Umsatzsteuer."
                    },
                    "units": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            12,
                            13
                        ],
                        "description": "Die Standorte (Standort-IDs), zusammen mit rules."
                    },
                    "rules": {
                        "type": "array",
                        "items": {
                            "type": "object"
                        },
                        "example": [
                            {
                                "planogram_id": 4,
                                "position": 2,
                                "quantity": 6,
                                "products": "Vitamina D3"
                            }
                        ],
                        "description": "Die Regeln, die Plätze nennen, zusammen mit units. spaces: [{zone_type_id oder zone_id, face (A/B), quantity}]; shelf: [{planogram_id oder placement_id, position (Regalboden, von oben), quantity, products}]."
                    }
                },
                "required": [
                    "module",
                    "title",
                    "starts_on",
                    "ends_on"
                ]
            },
            "MerchExecutions": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 501,
                        "description": "Kennung."
                    },
                    "campaign_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 15,
                        "description": "Die Kampagne (siehe /merch-campaigns)."
                    },
                    "module": {
                        "type": "string",
                        "enum": [
                            "spaces",
                            "shelf"
                        ],
                        "readOnly": true,
                        "example": "shelf",
                        "description": "spaces oder shelf (das der Kampagne)."
                    },
                    "work_unit_id": {
                        "type": "integer",
                        "readOnly": true,
                        "example": 12,
                        "description": "Der Standort."
                    },
                    "implementer_id": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "example": 17,
                        "description": "Wer sie konkret umsetzt; leer: die Leitung des Standorts."
                    },
                    "status": {
                        "type": "string",
                        "enum": [
                            "waiting",
                            "pending",
                            "done",
                            "refused",
                            "removing",
                            "removed",
                            "cancelled"
                        ],
                        "readOnly": true,
                        "example": "pending",
                        "description": "waiting (noch nicht begonnen), pending (aufzubauen), done (aufgebaut), refused, removing (abzubauen), removed oder cancelled."
                    },
                    "late": {
                        "type": "boolean",
                        "readOnly": true,
                        "example": false,
                        "description": "Ob sie nach der Frist aufgebaut wurde oder nicht steht und die Frist vorbei ist."
                    },
                    "due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "example": "2026-11-04",
                        "description": "Aufbau bis."
                    },
                    "done_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann bestätigt."
                    },
                    "done_by": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer bestätigt hat."
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Anmerkungen aus der Bestätigung."
                    },
                    "refused_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann abgelehnt."
                    },
                    "refused_by": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer abgelehnt hat."
                    },
                    "refusal_reason": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Warum es nicht möglich ist."
                    },
                    "remove_due_on": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date",
                        "readOnly": true,
                        "description": "Abbau bis."
                    },
                    "removed_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Wann der Abbau bestätigt wurde."
                    },
                    "removed_by": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "readOnly": true,
                        "description": "Wer den Abbau bestätigt hat."
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Angelegt."
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "readOnly": true,
                        "description": "Zuletzt geändert."
                    }
                }
            }
        },
        "securitySchemes": {
            "bearer": {
                "type": "http",
                "scheme": "bearer",
                "description": "Ein API-Schlüssel, gesendet als Authorization: Bearer hq_<id>_<secret>."
            }
        }
    }
}