From 4438cd42f2ec836310b962f8cf835701284e2d7c Mon Sep 17 00:00:00 2001 From: Dino Pehratovic Date: Fri, 23 Jan 2026 10:24:31 +0100 Subject: [PATCH 1/2] [ATTPOL-8578] Mark individual v1 PAPI projects and attendance endpoints deprecated in public documentation --- personio-personnel-data-api-oa3.yaml | 73 ++++++++++++++++++++++------ 1 file changed, 57 insertions(+), 16 deletions(-) diff --git a/personio-personnel-data-api-oa3.yaml b/personio-personnel-data-api-oa3.yaml index 88e74da..eeac227 100644 --- a/personio-personnel-data-api-oa3.yaml +++ b/personio-personnel-data-api-oa3.yaml @@ -1196,8 +1196,14 @@ paths: - BearerAuth: [] tags: - Attendances - description: Fetch attendance data for the company employees. The result can be `paginated` and `filtered` by period, the date and/or time they were updated, and/or specific employee/employees. The result contains a list of attendances. - summary: List Attendances + description: This endpoint is deprecated, please use v2. Fetch attendance data for the company employees. The result can be `paginated` and `filtered` by period, the date and/or time they were updated, and/or specific employee/employees. The result contains a list of attendances. + deprecated: true + summary: List Attendances (deprecated) + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/attendance-periods" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" parameters: - name: start_date in: query @@ -1408,9 +1414,14 @@ paths: - BearerAuth: [] tags: - Attendances - description: This endpoint is responsible for deleting attendance data for the - company employees. - summary: Delete Attendance by ID + description: This endpoint is deprecated, please use v2. It deletes attendance data for the company employees. + deprecated: true + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/attendance-periods/{id}" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" + summary: Delete Attendance by ID (deprecated) parameters: - name: id in: path @@ -1475,8 +1486,14 @@ paths: - BearerAuth: [] tags: - Attendances - description: This endpoint is responsible for updating attendance data for the company employees. Attributes are not required and if not specified, the current value will be used. It is not possible to change the employee id. - summary: Update Attendance by ID + description: This endpoint is deprecated, please use v2. It is responsible for updating attendance data for the company employees. Attributes are not required and if not specified, the current value will be used. It is not possible to change the employee id. + deprecated: true + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/attendance-periods/{id}" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" + summary: Update Attendance by ID (deprecated) parameters: - name: id in: path @@ -1545,8 +1562,14 @@ paths: - BearerAuth: [] tags: - Projects - description: Provides a list of all company projects. - summary: List Projects + description: This endpoint is deprecated, please use v2. Provides a list of all company projects. + deprecated: true + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/projects" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" + summary: List Projects (deprecated) responses: "200": description: List of projects returned @@ -1566,8 +1589,14 @@ paths: - BearerAuth: [] tags: - Projects - description: Creates a project into the company account - summary: Create a Project + description: This endpoint is deprecated, please use v2. Creates a project into the company account + deprecated: true + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/projects" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" + summary: Create a Project (deprecated) requestBody: content: application/json: @@ -1620,8 +1649,14 @@ paths: - BearerAuth: [] tags: - Projects - description: Deletes a project from the company account - summary: Delete Project by ID + description: This endpoint is deprecated, please use v2. Deletes a project from the company account + deprecated: true + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/projects/{id}" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" + summary: Delete Project by ID (deprecated) parameters: - name: id in: path @@ -1675,8 +1710,14 @@ paths: - BearerAuth: [] tags: - Projects - description: Updates a project with the given data - summary: Update Project by ID + description: This endpoint is deprecated, please use v2. Updates a project with the given data. + deprecated: true + x-papi-meta: + deprecation: + effective_from: "2025-01-15T00:00:00Z" + successor: "/v2/projects/{id}" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" + summary: Update Project by ID (deprecated) parameters: - name: id in: path @@ -2628,7 +2669,7 @@ paths: - BearerAuth: [] tags: - Documents - description: | + description: | This endpoint is responsible for uploading documents for the company employees. The Documents endpoint has a rate limit of 60 requests per minute. summary: Upload Document From 5a32fae32840e3c3f71cf047bf7b3e9a3e01f5b7 Mon Sep 17 00:00:00 2001 From: Dino Pehratovic Date: Fri, 23 Jan 2026 14:45:06 +0100 Subject: [PATCH 2/2] [ATTPOL-8578] Mark individual v1 PAPI projects and attendance endpoints deprecated in public documentation --- personio-personnel-data-api-oa3.yaml | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/personio-personnel-data-api-oa3.yaml b/personio-personnel-data-api-oa3.yaml index eeac227..4ea6e4a 100644 --- a/personio-personnel-data-api-oa3.yaml +++ b/personio-personnel-data-api-oa3.yaml @@ -1201,7 +1201,7 @@ paths: summary: List Attendances (deprecated) x-papi-meta: deprecation: - effective_from: "2025-01-15T00:00:00Z" + effective_from: "2026-07-28T00:00:00Z" successor: "/v2/attendance-periods" guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" parameters: @@ -1331,8 +1331,14 @@ paths: - BearerAuth: [] tags: - Attendances - description: This endpoint is responsible for adding attendance data for the company employees. It is possible to add attendances for one or many employees at the same time. The payload sent on the request should be a list of attendance periods, in the form of an array containing attendance period objects. - summary: Create an Attendance + description: This endpoint is deprecated, please use v2. The endpoint is responsible for adding attendance data for the company employees. It is possible to add attendances for one or many employees at the same time. The payload sent on the request should be a list of attendance periods, in the form of an array containing attendance period objects. + deprecated: true + summary: Create an Attendance (deprecated) + x-papi-meta: + deprecation: + effective_from: "2026-07-28T00:00:00Z" + successor: "/v2/attendance-periods" + guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" requestBody: content: application/json: @@ -1418,7 +1424,7 @@ paths: deprecated: true x-papi-meta: deprecation: - effective_from: "2025-01-15T00:00:00Z" + effective_from: "2026-07-28T00:00:00Z" successor: "/v2/attendance-periods/{id}" guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" summary: Delete Attendance by ID (deprecated) @@ -1490,7 +1496,7 @@ paths: deprecated: true x-papi-meta: deprecation: - effective_from: "2025-01-15T00:00:00Z" + effective_from: "2026-07-28T00:00:00Z" successor: "/v2/attendance-periods/{id}" guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" summary: Update Attendance by ID (deprecated) @@ -1566,7 +1572,7 @@ paths: deprecated: true x-papi-meta: deprecation: - effective_from: "2025-01-15T00:00:00Z" + effective_from: "2026-07-28T00:00:00Z" successor: "/v2/projects" guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" summary: List Projects (deprecated) @@ -1593,7 +1599,7 @@ paths: deprecated: true x-papi-meta: deprecation: - effective_from: "2025-01-15T00:00:00Z" + effective_from: "2026-07-28T00:00:00Z" successor: "/v2/projects" guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" summary: Create a Project (deprecated) @@ -1653,7 +1659,7 @@ paths: deprecated: true x-papi-meta: deprecation: - effective_from: "2025-01-15T00:00:00Z" + effective_from: "2026-07-28T00:00:00Z" successor: "/v2/projects/{id}" guide: "https://developer.personio.de/v1.0/changelog/deprecation-of-attendances-and-projects-v1-endpoints" summary: Delete Project by ID (deprecated)