By Scott H
The docs for the OAuth API appear to be incorrect regarding how to use a refresh token to get a new access token:
https://docs.digitalocean.com/reference/api/oauth/#refresh
The docs say to use the endpoint ending in /refresh but that endpoint appears to always return a 200 with a huge blob of HTML in the response, as if it is not a real API endpoint. I have tried a lot of variations (different request methods, GET parameters vs POST body, including client_id/secret or not, including the refresh token as a bearer token, etc.) and none of them seem to work.
I have found that the endpoint that actually works is just to call /token instead, as described here:
https://www.oauth.com/oauth2-servers/making-authenticated-requests/refreshing-an-access-token/
Was not sure where else to report this.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!
Hi there,
Thanks for flagging this. You are likely right that the /refresh endpoint in the docs is outdated or incorrect, and using /token with grant_type=refresh_token is the standard OAuth2 approach anyway.
That said, for a docs issue like this the best place to report it is directly to the DigitalOcean team rather than the community forum. You can open a support ticket at https://cloud.digitalocean.com/support and flag it as a documentation error. That way it gets in front of the right people who can actually update the docs.
Become a contributor for community
Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.
DigitalOcean Documentation
Full documentation for every DigitalOcean product.
Resources for startups and AI-native businesses
The Wave has everything you need to know about building a business, from raising funding to marketing your product.
The developer cloud
Scale up as you grow — whether you're running one virtual machine or ten thousand.
Start building today
From GPU-powered inference and Kubernetes to managed databases and storage, get everything you need to build, scale, and deploy intelligent applications.
