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
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
204The assignment was unassigned, or it was already not something that could be unassigned. No response body either way.
