---
title: "Update Position Opening"
method: PATCH
path: "/workforce-planning/positions/{positionId}/position-openings/{positionOpeningId}"
tags: ["Workforce Planning"]
---

# Update Position Opening

`PATCH /workforce-planning/positions/{positionId}/position-openings/{positionOpeningId}`

## Request

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

Updates a specific position opening within a position **Notes:**<br> - For fields that require reference to a list in Bob, use the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname">metadata endpoint</a> to fetch list values.<br>

## Path parameters

- `positionId` number, required
- `positionOpeningId` number, required

## Request body

- PublicPositionOpeningUpdateRequest
  - `items` PublicPositionOpeningUpdateItem[], required
    - `objectType` 'positionOpening', required
    - `fields` PublicPositionOpeningUpdate, required
      - `/positionOpening/positionOpeningName` object: A unique identifier for each opening within a position. Using the API you can provide the name that reflects the format chosen by your organization. If not passed, the system will automatically fill this out.
        - `value` string, nullable
      - `/positionOpening/expectedStartDate` object: The expected start date is the realistic forecast of the date on which the position should be filled. This is a mandatory field.
        - `value` string, date
      - `/positionOpening/recruitmentStatus` object: A list of possible recruitment status for the position opening. Out-of-the-box values include: `open`, `onHold`, and `closed` (list name: `recruitmentStatus`).
        - `value` string, nullable

## Response `200`

Position opening updated 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)