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

# Cancel Position

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

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/workforce-planning/positions/{positionId}/cancel`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

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.dev/hibob/apis/workforce-planning-api.md) - [All operations](https://skmtc.dev/hibob/apis/workforce-planning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/workforce-planning-api/revisions/07e0d5841251?raw)