{"openapi":"3.1.0","info":{"title":"Trello (BYOK) API","version":"0.1.0","description":"Trello (BYOK) lets an AI assistant read your own Trello data through the Trello API with a key you supply (Trello API key). Read-only: 9 tools (get_me, list_my_boards, get_board, list_board_lists, list_list_cards, list_board_cards, get_card, list_card_comments, list_my_workspaces). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-trello.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-trello/docs"},"termsOfService":"https://connectorbay.com/byok-trello/terms"},"servers":[{"url":"https://byok-trello.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-trello/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_me":{"post":{"operationId":"get_me","summary":"Show the Trello member the key and token belong to: username, full name, profile URL, initials and member type. Use for ","description":"Show the Trello member the key and token belong to: username, full name, profile URL, initials and member type. Use for \"Which Trello account is my token connected to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_meArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_my_boards":{"post":{"operationId":"list_my_boards","summary":"List the Trello boards the member belongs to with name, description, closed flag, workspace id, last activity and URL. U","description":"List the Trello boards the member belongs to with name, description, closed flag, workspace id, last activity and URL. Use for \"What Trello boards do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter":{"anyOf":[{"enum":["all","closed","members","open","organization","public","starred"],"type":"string"},{"type":"null"}],"default":"open","description":"Which boards: open, closed, starred, members, organization, public or all.","title":"Filter"}},"title":"list_my_boardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_board":{"post":{"operationId":"get_board","summary":"Get one Trello board: name, description, closed flag, workspace id, last activity and URL. Use for \"Show me the details ","description":"Get one Trello board: name, description, closed flag, workspace id, last activity and URL. Use for \"Show me the details of this Trello board\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"board_id":{"description":"Trello board ID (24 hex characters, or the 8-character short link from the board URL).","maxLength":200,"title":"Board Id","type":"string"}},"required":["board_id"],"title":"get_boardArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_board_lists":{"post":{"operationId":"list_board_lists","summary":"List the lists (columns) of a Trello board in board order with name, closed flag and position. List IDs are used by list","description":"List the lists (columns) of a Trello board in board order with name, closed flag and position. List IDs are used by list_list_cards. Use for \"What columns does my Trello product roadmap board have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"board_id":{"description":"Trello board ID (24 hex characters, or the 8-character short link from the board URL).","maxLength":200,"title":"Board Id","type":"string"},"filter":{"anyOf":[{"enum":["all","closed","none","open"],"type":"string"},{"type":"null"}],"default":"open","description":"Which lists: open, closed or all.","title":"Filter"}},"required":["board_id"],"title":"list_board_listsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_list_cards":{"post":{"operationId":"list_list_cards","summary":"List the cards in one Trello list with name, description, due date, labels, members and URL. Use for \"Which cards are in","description":"List the cards in one Trello list with name, description, due date, labels, members and URL. Use for \"Which cards are in this Trello list\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"list_id":{"description":"Trello list ID (24 hex characters), from list_board_lists.","maxLength":200,"title":"List Id","type":"string"}},"required":["list_id"],"title":"list_list_cardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_board_cards":{"post":{"operationId":"list_board_cards","summary":"List the cards on a Trello board filtered by state (open by default), with name, description, due date, list, labels and","description":"List the cards on a Trello board filtered by state (open by default), with name, description, due date, list, labels and members. Use for \"Which open cards are on my Trello product roadmap board\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"board_id":{"description":"Trello board ID (24 hex characters, or the 8-character short link from the board URL).","maxLength":200,"title":"Board Id","type":"string"},"filter":{"description":"Which cards: open, closed, visible or all.","enum":["all","closed","open","visible"],"title":"Filter","type":"string"}},"required":["board_id","filter"],"title":"list_board_cardsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_card":{"post":{"operationId":"get_card","summary":"Get one Trello card: name, description, due date, list, labels, members and URL. Use for \"Show me the details of this Tr","description":"Get one Trello card: name, description, due date, list, labels, members and URL. Use for \"Show me the details of this Trello card\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"card_id":{"description":"Trello card ID (24 hex characters, or the 8-character short link from the card URL).","maxLength":200,"title":"Card Id","type":"string"}},"required":["card_id"],"title":"get_cardArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_card_comments":{"post":{"operationId":"list_card_comments","summary":"List the comments on a Trello card, newest first, 50 per page, with date and author id. Use for \"What comments were writ","description":"List the comments on a Trello card, newest first, 50 per page, with date and author id. Use for \"What comments were written on this Trello card\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"card_id":{"description":"Trello card ID (24 hex characters, or the 8-character short link from the card URL).","maxLength":200,"title":"Card Id","type":"string"},"filter":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":"commentCard","description":"Action types to list; the default here is comments only.","title":"Filter"},"page":{"anyOf":[{"maximum":19,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page number starting at 0 (50 actions per page, highest page 19).","title":"Page"}},"required":["card_id"],"title":"list_card_commentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_my_workspaces":{"post":{"operationId":"list_my_workspaces","summary":"List the Trello workspaces (organizations) the member belongs to with name, display name, URL and board ids. Use for \"Wh","description":"List the Trello workspaces (organizations) the member belongs to with name, display name, URL and board ids. Use for \"Which Trello workspaces am I in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"filter":{"anyOf":[{"enum":["all","members","none","public"],"type":"string"},{"type":"null"}],"default":"all","description":"Which workspaces: all, members (private only), public or none.","title":"Filter"}},"title":"list_my_workspacesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}