# GET /api/v1/datasets/{}/fields is deprecated

BambooHR API deprecated GET /api/v1/datasets/{id}/fields without giving a shutdown date yet.

BambooHR API deprecated the GET /api/v1/datasets/{id}/fields endpoint without a shutdown date. Calls made to this route are slated for removal and will eventually fail. The change was announced on March 25, 2026, marking the endpoint as deprecated in the API documentation.

## What to use instead

Use GET /api/v1_2/datasets/{datasetName}/fields 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: `GET /api/v1/datasets/{id}/fields`
- 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/get-api-v1-datasets-fields-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