Keys / Dropbox

DROPBOX_ACCESS_TOKEN

A short-lived OAuth access token your app calls the Dropbox API with as one user.

Expires
short-lived; the token response gives the time
API
new access tokens from a refresh token; revoke with the token itself

Get it

Create one on www.dropbox.com/developers/console/apps. The steps aren't recorded yet.

Set it

DROPBOX_ACCESS_TOKEN=...

The official JavaScript and Python SDKs don't read it; your app passes it as accessToken or oauth2_access_token. Dropbox's JavaScript README passes process.env.DROPBOX_ACCESS_TOKEN. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. An access token expires on its own; the token response says when. To test, click Generate access token on your app's Settings tab in the Developer Console.
  2. For anything that runs unattended, keep a refresh token from the OAuth flow with token_access_type=offline instead. The SDKs use it to get new access tokens.
  3. To stop a token, call /2/auth/token/revoke with it. That also disables its refresh token and every access token from that refresh token.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16