# POST /v1/oauth/refresh is deprecated

Figma REST API deprecated POST /v1/oauth/refresh without giving a shutdown date yet.

The POST /v1/oauth/refresh endpoint was deprecated on May 16, 2025, without a shutdown date. It continues to be supported for now, but calls to it will eventually fail once removed. This change affects callers of the POST /v1/oauth/refresh endpoint.

## What to use instead

Refresh tokens using POST /v1/oauth/token with grant_type=refresh_token.

- API: Figma REST API (api.figma.com)
- Kind: Endpoint removal
- Announced: May 16, 2025
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `POST /v1/oauth/refresh`
- Source: [Announcement](https://developers.figma.com/docs/rest-api/changelog/)
- Verified: November 6, 2026, against Figma REST API's own pages
- Page: https://www.okapi.bot/providers/figma-rest-api/breaking-changes/post-v1-oauth-refresh-is-deprecated/

## Figma REST API's words

> The legacy endpoint will continue to be supported for now, but we recommend you migrate to using the new endpoint.

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