# GET /2.0/file_version_retentions/{} is deprecated

Box API deprecated GET /2.0/file_version_retentions/{} without giving a shutdown date yet.

The provider has deprecated the GET /2.0/file_version_retentions/{} endpoint without a shutdown date. The provider noted that the file retention API is now deprecated. Requests to this endpoint will fail.

## What to use instead

Read retention through GET /2.0/retention_policy_assignments/{id}/files_under_retention or GET /2.0/retention_policy_assignments/{id}/file_versions_under_retention instead.

- API: Box API (api.box.com)
- Kind: Endpoint removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /2.0/file_version_retentions/{}`
- Source: [Announcement](https://developer.box.com/reference/get-file-version-retentions-id/)
- Verified: October 26, 2026, against Box API's own pages
- Page: https://www.okapi.bot/providers/box-api/breaking-changes/get-2-0-file-version-retentions-is-deprecated-2/

## Box API's words

> File retention API is now deprecated

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