> ## Documentation Index
> Fetch the complete documentation index at: https://opensre.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Trello

> Connect Trello so OpenSRE can view cards and boards during investigations and incident management

When incidents happen, keeping everyone organized matters. OpenSRE connects to Trello so you can create incident cards, track investigation progress, and manage follow-up tasks — all without leaving your incident response workflow.

## What you need

* A Trello account with access to the boards you want OpenSRE to use
* A Trello API key and token
* Optional board and list IDs for automatic card creation

## Setting up Trello

### Quick setup

```bash theme={null}
opensre integrations setup
```

Choose **Trello** and enter your API key and token when prompted.

### Manual config: Environment variables

Or add these to your `.env`:

```bash theme={null}
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token
TRELLO_BOARD_ID=board_id_optional
TRELLO_LIST_ID=list_id_optional
TRELLO_BASE_URL=https://api.trello.com/1
```

| Variable          | Default                    | Description                                 |
| ----------------- | -------------------------- | ------------------------------------------- |
| `TRELLO_API_KEY`  | —                          | **Required.** Trello API key                |
| `TRELLO_TOKEN`    | —                          | **Required.** Trello API token              |
| `TRELLO_BOARD_ID` | *(empty)*                  | Optional default board ID for card creation |
| `TRELLO_LIST_ID`  | *(empty)*                  | Optional default list ID for card creation  |
| `TRELLO_BASE_URL` | `https://api.trello.com/1` | Trello API base URL                         |

### Persistent store

You can also save your Trello configuration to `~/.opensre/integrations.json`:

```json theme={null}
{
  "version": 1,
  "integrations": [
    {
      "id": "trello-prod",
      "service": "trello",
      "status": "active",
      "credentials": {
        "api_key": "your_api_key",
        "token": "your_token",
        "board_id": "board_id_optional",
        "list_id": "list_id_optional"
      }
    }
  ]
}
```

## Getting your API key and token

1. Visit [https://trello.com/app-key](https://trello.com/app-key)
2. Copy your Trello API key
3. Generate a token from the same page
4. Authorize access when prompted
5. Store both values securely

## Optional: Finding board and list IDs

If you'd like OpenSRE to create cards in a specific location, you'll need the board and list IDs.

### Using the API

```bash theme={null}
curl "https://api.trello.com/1/members/me/boards?key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN}"
```

### Manual method

1. Open the board in Trello
2. Append `.json` to the board URL
3. Search the response for the board ID
4. Locate the desired list and copy its ID

## Token longevity

Trello tokens can be created with different expiration periods. When generating a token, choose an expiration period that aligns with your organization's security requirements.

For long-lived OpenSRE integrations, consider using an appropriately scoped token and rotating it regularly according to your security policies.

## Required permissions

Your Trello token should have:

* **read** — Allows OpenSRE to view boards, lists, and cards
* **write** — Allows OpenSRE to create or update cards during investigations

## Usage

Once configured, OpenSRE can:

* Create Trello cards from investigation findings
* Send incident titles and descriptions to a target list
* Track follow-up tasks on your incident board

Set `TRELLO_LIST_ID` to the list where new cards should appear. If omitted, card creation requires the list ID at investigation time.

<Info>
  Trello does not currently support `opensre integrations verify trello`. Confirm your credentials during interactive setup or by creating a test card from an investigation.
</Info>