---
title: "Cancel Position"
method: PATCH
path: "/workforce-planning/positions/{positionId}/cancel"
tags: ["Workforce Planning"]
---

# Cancel Position

`PATCH /workforce-planning/positions/{positionId}/cancel`

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](/reference/post_workforce-planning-positions-schedule-cancellation) endpoint, which automatically unassigns employees before cancelling the position.

## Path parameters

- `positionId` number, required

## Response `200`

Position cancelled successfully

## Other responses

- `204` — No Content
- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)