---
updatedAt: 2026-01-12T08:29:51.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Workforce Planning

The Workforce Planning API provides access to positions in your company.

> 📘 Note:
>
> If you have not purchased Workforce planning, you will not have access to this feature. To learn more, see [Workforce planning](https://www.hibob.com/features/workforce-planning/).

# Before you begin

* Read [Explore Workforce Planning API](https://apidocs.hibob.com/docs/explore-workforce-planning) to learn how to use the API.

# Permissions required

To use the Workforce planning endpoints, make sure to set up the following permissions:

| Action                        | Permission                                                                                         |
| :---------------------------- | :------------------------------------------------------------------------------------------------- |
| Metadata and Search endpoints | Features > Workforce planning > Position management > Manage positions                             |
| Create positions              | Features > Workforce planning > Position management > Add and edit multiple openings in a position |
| Create and update Budgets     | Features > Workforce planning > Position management > Position budget settings                     |

# Rate limiting

Rate limits are restrictions that our API imposes on the number of times a user can access our endpoints within a specified period of time. To learn more about rate limiting best practices, see [Rate limiting](https://apidocs.hibob.com/docs/rate-limit).

Below is a table detailing the rate limits for each endpoint in the Hiring endpoints.

| Method | Endpoint                                                                                                                                          | Limit per minute |
| :----- | :------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------- |
| GET    | [Get all positions fields](https://apidocs.hibob.com/reference/get_metadata-objects-position)                                                     | 50               |
| GET    | [Get all position opening fields](https://apidocs.hibob.com/reference/get_positions-position-openings-metadata)                                   | 50               |
| GET    | [Get all position budget fields](https://apidocs.hibob.com/reference/get_positions-position-budget-metadata)                                      | 50               |
| POST   | [Read company positions](https://apidocs.hibob.com/reference/post_objects-position-search)                                                        | 100              |
| POST   | [Read company positions openings](https://apidocs.hibob.com/reference/post_positions-position-openings-search)                                    | 100              |
| POST   | [Read company positions budgets](https://apidocs.hibob.com/reference/post_positions-position-budget-search)                                       | 100              |
| POST   | [Create Position](https://apidocs.hibob.com/reference/post_workforce-planning-positions)                                                          | 10               |
| POST   | [Create Position opening](https://apidocs.hibob.com/reference/post_workforce-planning-positions-positionid-position-openings)                     | 10               |
| PATCH  | [Update Position](https://apidocs.hibob.com/reference/patch_workforce-planning-positions-positionid)                                              | 10               |
| PATCH  | [Update Position Opening](https://apidocs.hibob.com/reference/patch_workforce-planning-positions-positionid-position-openings-positionopeningid)  | 10               |
| DEL    | [Delete Position Opening](https://apidocs.hibob.com/reference/delete_workforce-planning-positions-positionid-position-openings-positionopeningid) | 10               |
| POST   | [Create Position Budget](https://apidocs.hibob.com/reference/post_workforce-planning-positions-positionid-position-budget)                        | 10               |
| PATCH  | [Update Position Budget](https://apidocs.hibob.com/reference/patch_workforce-planning-positions-positionid-position-budget-positionbudgetid)      | 10               |
| PATCH  | [Cancel Position](https://apidocs.hibob.com/reference/patch_workforce-planning-positions-positionid-cancel)                                       | 10               |