# @kody/trello `community-icon.svg` is Trello's official logomark from the [Wikimedia Commons Trello logo](https://commons.wikimedia.org/wiki/File:Trello-logo-blue.svg) (Atlassian product mark, Pacific Bridge gradient `#0052CC` → `#2684FF`). Trello® is a trademark of Atlassian. This package is not affiliated with or endorsed by Atlassian. Share this package as https://kody.codes/@kody/trello (never a `/community/{listing_id}` URL). ## Intent Reusable Trello helpers so Kody agents can list and update **the caller's** boards, lists, cards, and comments. Reads are free-form. Mutations support `dryRun: true` and require `confirm: true`. This listing is meant to be forked. After you fork, connect **your** Trello account. No board ids, list names, or workspace ids are baked in. ## What it does - List or inspect the caller's boards, lists, cards, and comments - Create or update boards, lists, cards, and comments after explicit confirmation - Call an unwrapped Trello REST path through `./request` - Verify credentials with a smoke test before any write ## Prerequisites / setup Trello has **no built-in Kody OAuth app**. Trello REST still authenticates with an **API key + user token** (query `key` and `token`). Trello OAuth 2 is not generally available; Kody can still use a saved `trello` / `trello-*` integration when one exists. | Lane | When to use | Credential | | --- | --- | --- | | **API key + token** (recommended) | Personal automation, Power-Up key | User secrets `trelloApiKey` + `trelloToken` (or `trelloApiKey-` / `trelloToken-`) | | **OAuth integration** | Saved `trello` / `trello-*` connection | `createAuthenticatedFetch` via `integrationName` | Required API host: **`api.trello.com`**. Approve it in the account secrets UI. Saving a secret does not approve hosts by itself. Never paste keys or tokens into chat. ### Lane A — API key + token 1. Create a Power-Up and API key at [Trello Power-Ups admin](https://trello.com/power-ups/admin) 2. Save the API key (do not paste the value in chat): https://kody.codes/account/secrets/new?name=trelloApiKey&description=Trello%20API%20key%20for%20boards%2C%20lists%2C%20cards%2C%20and%20comments&allowedHosts=api.trello.com&scope=user 3. Authorize a user token with that key (`read,write`; replace `YOUR_API_KEY` with the key you just created — in the Trello page, not in chat): https://trello.com/1/authorize?expiration=never&name=Kody&scope=read%2Cwrite&response_type=token&key=YOUR_API_KEY 4. Save the user token: https://kody.codes/account/secrets/new?name=trelloToken&description=Trello%20user%20token%20for%20boards%2C%20lists%2C%20cards%2C%20and%20comments&allowedHosts=api.trello.com&scope=user 5. Approve host `api.trello.com` ### Lane B — Saved OAuth integration Trello's live OAuth is 1.0 (`/1/OAuthGetRequestToken`, `/1/OAuthAuthorizeToken`, `/1/OAuthGetAccessToken`). Kody `/connect/oauth` is OAuth 2, so a first-time Trello OAuth 2 connect is not available until Atlassian ships those endpoints. If a `trello` integration is already saved, reconnect while signed in to Kody: https://kody.codes/connect/oauth?provider=trello For a new BYO connection page (provider + API host prefilled; add authorize and token URLs when Trello documents OAuth 2): https://kody.codes/connect/oauth?provider=trello&apiBaseUrl=https%3A%2F%2Fapi.trello.com%2F1&allowedHosts=api.trello.com&dashboardUrl=https%3A%2F%2Ftrello.com%2Fpower-ups%2Fadmin&flow=confidential Redirect URI for any future Trello OAuth 2 app: `https://kody.codes/connect/oauth`. To connect a second account, change `provider` (for example `provider=trello-work`) and pass `account: 'work'` or `integrationName: 'trello-work'` / `secretName: 'trelloToken-work'` / `apiKeySecretName: 'trelloApiKey-work'` on every call. Agents: see [`AGENTS.md`](./AGENTS.md) for import paths, smoke checks, and mutation guards. ## Done when - `trelloApiKey` + `trelloToken` are saved (or OAuth `trello` is connected); host `api.trello.com` is approved - Smoke test returns `ok: true` (live member/boards sample when credentials exist) - Live writes refuse unless `confirm: true`; `dryRun: true` never contacts Trello - Board/list/card ids always come from the caller — this package has no default board ## Jobs `account-health` calls `./scheduled-account-health` weekly (Monday 09:00 UTC). It is **`enabled: false`**. Enabling it is an operator choice after you fork and confirm the read is right for your account. ## Branding Keep `LICENSE` (MIT), `## Intent`, and `community-icon.svg` intact for community listing. ## Auth docs https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/