Improved
Time Off API: policyTypeCustomName on get request details
3 days ago
We added policyTypeCustomName to the response for the Get the details of an existing time off request endpoint.
What changed
Time off request responses now include a dedicated field for the policy’s configured custom label:
policyTypeCustomName— the custom label configured on the policy, when one exists.
This field is returned together with the existing policyTypeDisplayName and visibility fields, so integrations can understand which policy name is safe to show and when the original policy type name may be exposed.
How visibility affects policy type names
The policy type's visibility field explains how the policy type name should be treated:
- Public: the policy type name is not sensitive. Use
policyTypeDisplayName;policyTypeCustomNameisnull. - Custom name: the policy has a public-facing custom label. Use
policyTypeCustomNamewhen you need the non-sensitive label.policyTypeDisplayNamemay contain the original policy type name if the caller has permission to see it. - Private: the policy type name is sensitive. The request is returned only when the caller has permission, and
policyTypeDisplayNamecontains the original policy type name.policyTypeCustomNameisnull.
Affected endpoint
Notes
- This is an additive and backward-compatible change.
- Existing integrations can continue using
policyTypeDisplayNameas before. - For the full behavior by visibility and permission, see Policy type names in API responses.

