Absolute URLs in Pagination Links for Attendance Periods API V2

Summary:

We are updating the self and next pagination links in the _meta.links object of the GET /v2/attendance-periods API endpoint. Starting September 15th, the href values will change from relative URLs (e.g., /v2/attendance-periods?...) to absolute URLs that include the full host name (e.g., https://api.personio.de/v2/attendance-periods?...).

Note: This change only affects the V2 endpoint; V1 remains unchanged.

Current Response Example:

"_meta": {  
  "links": {  
    "self": { "href": "/v2/attendance-periods?cursor=..." },  
    "next": { "href": "/v2/attendance-periods?cursor=..." }  
  }  
}

New Response Example:

"_meta": {  
  "links": {  
    "self": { "href": "https://api.personio.de/v2/attendance-periods?cursor=..." },  
    "next": { "href": "https://api.personio.de/v2/attendance-periods?cursor=..." }  
  }  
}

Impact:

If your integration parses the self or next links assuming they are relative paths, you may need to update your logic to handle absolute URLs. To ensure a smooth transition, you may also choose to support both relative and absolute URLs, which can help avoid immediate changes on September 15th.

Action Required:

Review your use of the self and next links in the _meta.links object for the V2 endpoint.
Update any code that assumes these are relative URLs so it can also handle absolute URLs.

Background:

This update is part of our ongoing efforts to move V2 out of beta and make it more robust and standards-compliant. We appreciate your understanding as we make these improvements.

If you have any questions or concerns, please reach out to us through the Help & Feedback section.