v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Workforce Planning

Cancel Position

Immediately cancels a position and updates its status to cancelled.

Important: This operation will fail if the position is currently filled (i.e., employees are still assigned to its openings).

To cancel filled positions, use the Schedule Positions Cancellation endpoint, which automatically unassigns employees before cancelling the position.

patch/workforce-planning/positions/{positionId}/cancel

Path parameters

positionIdnumber required

The ID of the position

Response

Position cancelled successfully