Keys / UploadThing

UPLOADTHING_TOKEN

The token your server uploads and signs file URLs with. It's base64-encoded JSON holding your app ID, regions and API key.

Expires
the docs don't say
API
none; dashboard only

Get it

Create one on uploadthing.com/dashboard. The steps aren't recorded yet.

Set it

UPLOADTHING_TOKEN=...

The uploadthing SDK reads it from this variable when you don't pass a token. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. The docs don't describe replacing a key. Open the dashboard's API Keys page and copy the token for a new key from the V7 tab.
  2. Deploy it everywhere that reads UPLOADTHING_TOKEN.
  3. Check that uploads work, then delete or revoke the old API key. Signed URLs made with it stop working then.

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