Unassign Employee Time Off Policy

Unassigns a time off policy from an employee. The assignment stops being current as of today; nothing is deleted, and the employee's historical balances and time off requests are preserved. Because the assignment is end-dated rather than removed, a subsequent GET of the employee's policies still returns it, under a new ID and carrying the past endDate. A future-dated assignment is unassigned as of its own effective date, and because it was never in force it leaves no historical record. Unassigning also ends any other assignment the employee holds in the same time off category that is scheduled to start after the unassignment date, so that they are not re-enrolled in that category later. An assignment whose endDate has already passed is left unchanged: it was only ever in force up to that date, and it still contributes to historical accrual. This operation is idempotent: it returns 204 whether or not an assignment was changed, including when no assignment carries the given ID, when the ID belongs to a different employee, and when the assignment is no longer live.

OAuth Scopes: time_off:policies.write

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The employee ID.

integer
required

The policy assignment ID.

Responses
204

The assignment was unassigned, or it was already not something that could be unassigned. No response body either way.

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/problem+json