Keys / CircleCI

CIRCLE_TOKEN

A CircleCI personal API token that scripts and the CircleCI CLI call the CircleCI API with.

Starts with
CCIPAT_
Expires
you choose, up to 1 year
API
none for tokens you make by hand; an OAuth app can request a 90-day token

Get it

Create one on app.circleci.com/settings/user/tokens. The steps aren't recorded yet.

Set it

CIRCLE_TOKEN=CCIPAT_...

The CircleCI CLI reads it on its own, before a token saved by circleci auth login. CircleCI's deprecated local MCP server read CIRCLECI_TOKEN instead. Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. On the Personal API Tokens page, create a new token and pick its expiry date.
  2. Deploy it everywhere that reads CIRCLE_TOKEN.
  3. Check that nothing still uses the old token, then remove it with the X in the Remove column.

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