Discussions
Missing error documentation and inconsistent error response formats in Personio API V2
Hello,
I am currently integrating with the Personio API (specifically the attendance endpoints) and noticed an inconsistency between the documentation and the actual API responses.
The documentation references the error definitions page:
https://developer.personio.de/reference/errors
However, this page appears to be missing or not accessible.
Additionally, the endpoint documentation (e.g. https://developer.personio.de/reference/get_v2-attendance-periods-id) describes error responses in the following format:
{
"title": "Access denied",
"detail": "Access denied to perform attendance period operations.",
"type": "https://developer.personio.de/reference/errors#common.forbidden_response"
}
However, the actual responses returned by the API differ significantly. For example:
{
"id": "93c06d6b-f00e-4891-8026-03c1c41676c6",
"status": "403",
"title": "Blocking attendance ... Minimum break duration of PT15M was not respected.",
"type": "MINIMUM_BREAK_RULE_VIOLATION"
}
Because of this discrepancy, I would like to ask:
Is the error documentation page available at a different location?
Is there an up-to-date and complete list of possible error type values (e.g. MINIMUM_BREAK_RULE_VIOLATION)?
?
Thank you very much for your support.
Best regards,
Fabian Tryba
