Keys / Trello
TRELLO_API_KEY
The API key that identifies your Trello Power-Up. It's meant to be public; with a user's token it reads and writes that user's Trello data.
- Expires
- the docs don't say
- API
- none for keys; tokens can be deleted
Get it
Create one on trello.com/power-ups/admin. The steps aren't recorded yet.
Set it
TRELLO_API_KEY=...
Your app passes it in: requests send it as the key query parameter, next to token, and Trello's Power-Up REST API client takes it as appKey. Or keep it out of .env with keypin: keypin run -- npm run dev
Replace it
- The key is public; the token is what to keep secret. If a token leaks, revoke it: the user clicks Revoke next to it in their Trello account settings, or your app calls
DELETE /1/tokens/{token}. - Trello's docs don't describe replacing a key. An answer on Atlassian's developer forum says tokens belong to the key that issued them, so with a new key every user must authorize again.
- If you switch keys, deploy the new key and the new tokens everywhere that reads
TRELLO_API_KEY.
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.