p202 app rotate-token

Replace the app token (the old token stops working immediately)

Writessupports --staged
All commands

p202 CLI reference

Back to the docs

01Run it

Replace the <placeholders> with your own values, or use the builder below.

p202 app rotate-token <id>

02What you get

Pick the shape you need. People get a table. Add --json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats

03Build your command

Pick values and the command line writes itself, quoted and ready to paste.

p202 app rotate-token

Set flags below; the command updates as you type.

04How it works

Mints a new app token for the registration and invalidates the old one — the remedy when builds should no longer reach the server with the token they shipped. The token is an identifier, not a secret: it ships inside every copy of the app.

05For agents

Running this from an agent

  • Read the same facts as JSON: p202 commands app rotate-token --json.
  • With AI_AGENT, CLAUDECODE or another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with a hint.
  • Exit codes: 0 ok, 1 bad input, 2 auth, 3 network, 4 server error, 5 partial failure.
  • This command writes. Add --staged to record it as a proposal a person applies with p202 change apply.
p202 commands app rotate-token --json
{
  "path": "p202 app rotate-token",
  "use": "rotate-token <id>",
  "short": "Replace the app token (the old token stops working immediately)",
  "long": "Mints a new app token for the registration and invalidates the old one — the\nremedy when builds should no longer reach the server with the token they shipped.\nThe token is an identifier, not a secret: it ships inside every copy of the app.",
  "runnable": true
}