Sign in

v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Workforce Planning

Update Position

Updates an existing position Notes:<br> - Currently, you cannot use approval flows, which are not supported via the API.<br> - This endpoint requires linking the position to a job profile, and can be used only with Job Catalog 2.0. To retrieve the jobProfile, use the <a href="https://apidocs.hibob.com/reference/job-catalog">Job Catalog API</a>.<br> - For fields that require reference to a list in Bob (e.g. department), use the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname">metadata endpoint</a> to fetch list values.<br> - For custom fields, use the Examples > Request Example, and copy to an external API client tool to add custom fields to the payload.<br>

patch/workforce-planning/positions/{positionId}

Path parameters

positionIdnumber required

The ID of the position to update

Request body

Example request

{
  "items": [
    {
      "fields": {
        "/position/effectiveDate": {
          "value": "2025-04-01"
        }
      }
    }
  ]
}

Response

Position updated successfully