trello-api

# Trello Access the Trello API with managed OAuth authentication. Manage boards, lists, cards, checklists, labels, and members for project and task management. ## Quick Start ```bash # Get boards for current user python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/trello/1/members/me/boards') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ## Base URL ``` https://gateway.maton.ai/trello/{native-api-path} ``` Replace `{native-api-path}` with the actual Trello API endpoint path. The gateway proxies requests to `api.trello.com` and automatically injects your OAuth token. ## Authentication All requests require the Maton API key in the Authorization header: ``` Authorization: Bearer $MATON_API_KEY ``` **Environment Variable:** Set your API key as `MATON_API_KEY`: ```bash export MATON_API_KEY="YOUR_API_KEY" ``` ### Getting Your API Key 1. Sign in or create an account at [maton.ai](https://maton.ai) 2. Go to [maton.ai/settings](https://maton.ai/settings) 3. Copy your API key ## Connection Management Manage your Trello OAuth connections at `https://ctrl.maton.ai`. ### List Connections ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=trello&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Create Connection ```bash python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'trello'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Get Connection ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` **Response:** ```json { "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "trello", "metadata": {} } } ``` Open the returned `url` in a browser to complete OAuth authorization. ### Delete Connection ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Specifying Connection If you have multiple Trello connections, specify which one to use with the `Maton-Connection` header: ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/trello/1/members/me/boards') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` If omitted, the gateway uses the default (oldest) active connection. ## API Reference ### Members #### Get Current Member ```bash GET /trello/1/members/me ``` #### Get Member's Boards ```bash GET /trello/1/members/me/boards ``` Query parameters: - `filter` - Filter boards: `all`, `open`, `closed`, `members`, `organization`, `starred` - `fields` - Comma-separated fields to include ### Boards #### Get Board ```bash GET /trello/1/boards/{id} ``` Query parameters: - `fields` - Comma-separated fields - `lists` - Include lists: `all`, `open`, `closed`, `none` - `cards` - Include cards: `all`, `open`, `closed`, `none` - `members` - Include members: `all`, `none` **Example:** ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/trello/1/boards/BOARD_ID?lists=open&cards=open') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` #### Create Board ```bash POST /trello/1/boards Content-Type: application/json { "name": "Project Alpha", "desc": "Main project board", "defaultLists": false, "prefs_permissionLevel": "private" } ``` #### Update Board ```bash PUT /trello/1/boards/{id} Content-Type: application/json { "name": "Project Alpha - Updated", "desc": "Updated description" } ``` #### Delete Board ```bash DELETE /trello/1/boards/{id} ``` #### Get Board Lists ```bash GET /trello/1/boards/{id}/lists ``` Query parameters: - `filter` - Filter: `all`, `open`, `closed`, `none` #### Get Board Cards ```bash GET /trello/1/boards/{id}/cards ``` #### Get Board Members ```bash GET /trello/1/boards/{id}/members ``` ### Lists #### Get List ```bash GET /trello/1/lists/{id} ``` #### Create List ```bash POST /trello/1/lists Content-Type: application/json { "name": "To Do", "idBoard": "BOARD_ID", "pos": "top" } ``` #### Update List ```bash PUT /trello/1/lists/{id} Content-Type: application/json { "name": "In Progress" } ``` #### Archive List ```bash PUT /trello/1/lists/{id}/closed Content-Type: application/json { "value": true } ``` #### Get Cards in List ```bash GET /trello/1/lists/{id}/cards ``` #### Move All Cards in List ```bash POST /trello/1/lists/{id}/moveAllCards Content-Type: application/json { "idBoard": "BOARD_ID", "idList": "TARGET_LIST_ID" } ``` ### Cards #### Get Card ```bash GET /trello/1/cards/{id} ``` Query parameters: - `fields` - Comma-separated fields - `members` - Include members (true/false) - `checklists` - Include checklists: `all`, `none` - `attachments` - Include attachments (true/false) #### Create Card ```bash POST /trello/1/cards Content-Type: application/json { "name": "Implement feature X", "desc": "Description of the task", "idList": "LIST_ID", "pos": "bottom", "due": "2025-03-30T12:00:00.000Z", "idMembers": ["MEMBER_ID"], "idLabels": ["LABEL_ID"] } ``` #### Update Card ```bash PUT /trello/1/cards/{id} Content-Type: application/json { "name": "Updated card name", "desc": "Updated description", "due": "2025-04-15T12:00:00.000Z", "dueComplete": false } ``` #### Move Card to List ```bash PUT /trello/1/cards/{id} Content-Type: application/json { "idList": "NEW_LIST_ID", "pos": "top" } ``` #### Delete Card ```bash DELETE /trello/1/cards/{id} ``` #### Add Comment to Card ```bash POST /trello/1/cards/{id}/actions/comments Content-Type: application/json { "text": "This is a comment" } ``` #### Add Member to Card ```bash POST /trello/1/cards/{id}/idMembers Content-Type: application/json { "value": "MEMBER_ID" } ``` #### Remove Member from Card ```bash DELETE /trello/1/cards/{id}/idMembers/{idMember} ``` #### Add Label to Card ```bash POST /trello/1/cards/{id}/idLabels Content-Type: application/json { "value": "LABEL_ID" } ``` ### Checklists #### Get Checklist ```bash GET /trello/1/checklists/{id} ``` #### Create Checklist ```bash POST /trello/1/checklists Content-Type: application/json { "idCard": "CARD_ID", "name": "Task Checklist" } ``` #### Create Checklist Item ```bash POST /trello/1/checklists/{id}/checkItems Content-Type: application/json { "name": "Subtask 1", "pos": "bottom", "checked": false } ``` #### Update Checklist Item