# POST /api/v1/datasets/{}/field-options is deprecated

BambooHR API deprecated POST /api/v1/datasets/{id}/field-options without giving a shutdown date yet.

BambooHR deprecated POST /api/v1/datasets/{id}/field-options on March 25, 2026, without a shutdown date. Calls to this endpoint will eventually fail once the removal takes effect. BambooHR API has marked the endpoint as deprecated in its OpenAPI documentation.

## What to use instead

Use POST /api/v1_2/datasets/{datasetName}/field-options instead.

- API: BambooHR API (*.bamboohr.com)
- Kind: Endpoint removal
- Announced: March 25, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `POST /api/v1/datasets/{id}/field-options`
- Source: [Announcement](https://documentation.bamboohr.com/docs/past-changes-to-the-api)
- Verified: November 6, 2026, against BambooHR API's own pages
- Page: https://www.okapi.bot/providers/bamboohr-api/breaking-changes/post-api-v1-datasets-field-options-is-deprecated/

## BambooHR API's words

> We marked the following Dataset discovery endpoints as deprecated in our OpenAPI documentation and added guidance directing consumers to the v1.2 versions: - GET /api/v1/datasets → GET /api/v1_2/datasets - GET /api/v1/datasets/{datasetName}/fields → GET /api/v1_2/datasets/{datasetName}/fields - POST /api/v1/datasets/{datasetName}/field-options → POST /api/v1_2/datasets/{datasetName}/field-options

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent