Keys / Databricks

DATABRICKS_TOKEN

A Databricks personal access token for one workspace's REST APIs, CLI and SDKs. Databricks recommends OAuth where possible.

Expires
you choose; revoked after 90 days unused
API
create, list, update and revoke, with the Token API

Get it

Create one on docs.databricks.com/aws/en/dev-tools/auth/pat. The steps aren't recorded yet.

Set it

DATABRICKS_TOKEN=...

The Databricks SDKs for Python and Go read it on their own, with DATABRICKS_HOST for the workspace. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. In the workspace, open Settings > Developer > Access tokens and create a new token with the same scopes as the old one.
  2. Deploy it everywhere that reads DATABRICKS_TOKEN.
  3. Check that nothing still uses the old token, then revoke it on the same page.

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