{"openapi":"3.1.0","info":{"title":"Trello Checklists and Fields (BYOK) API","version":"0.1.0","description":"Trello Checklists and Fields (BYOK) lets an AI assistant read your own Trello Checklists and Fields data through the Trello Checklists and Fields API with a key you supply (Trello API key). Read-only: 10 tools (list_card_checklists, list_board_checklists, get_checklist, list_checklist_items, list_card_attachments, list_board_labels, get_label, list_board_custom_fields, list_custom_field_options,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-trello-checklists-fields.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-trello-checklists-fields/docs"},"termsOfService":"https://connectorbay.com/byok-trello-checklists-fields/terms"},"servers":[{"url":"https://byok-trello-checklists-fields.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-trello-checklists-fields/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/list_card_checklists":{"post":{"operationId":"list_card_checklists","summary":"List the checklists on a card with their check items (name, state complete or incomplete, position). Use for \"What check","description":"List the checklists on a card with their check items (name, state complete or incomplete, position). Use for \"What checklist items does Trello card 5abbe4b7ddc1b351ef961416 have and which are done\".","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":"list_card_checklistsArguments","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_checklists":{"post":{"operationId":"list_board_checklists","summary":"List every checklist on a board with its check items; large boards return a long list, so the answer is capped. Use for ","description":"List every checklist on a board with its check items; large boards return a long list, so the answer is capped. Use for \"Show all checklists on Trello board 5abbe4b7ddc1b351ef961414\".","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":"list_board_checklistsArguments","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_checklist":{"post":{"operationId":"get_checklist","summary":"Get one checklist by id with its name, board, card, position and check items. Use for \"Show Trello checklist 5abbe4b7ddc","description":"Get one checklist by id with its name, board, card, position and check items. Use for \"Show Trello checklist 5abbe4b7ddc1b351ef961419\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"checklist_id":{"description":"Trello checklist ID (24 hex characters), from list_card_checklists or list_board_checklists.","maxLength":200,"title":"Checklist Id","type":"string"}},"required":["checklist_id"],"title":"get_checklistArguments","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_checklist_items":{"post":{"operationId":"list_checklist_items","summary":"List the check items of one checklist: name, state, position and due date when set. Use for \"Which items on Trello check","description":"List the check items of one checklist: name, state, position and due date when set. Use for \"Which items on Trello checklist 5abbe4b7ddc1b351ef961419 are still open\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"checklist_id":{"description":"Trello checklist ID (24 hex characters), from list_card_checklists or list_board_checklists.","maxLength":200,"title":"Checklist Id","type":"string"}},"required":["checklist_id"],"title":"list_checklist_itemsArguments","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_attachments":{"post":{"operationId":"list_card_attachments","summary":"List the attachments on a card (file uploads and links): name, URL, size in bytes, MIME type, date and whether it was up","description":"List the attachments on a card (file uploads and links): name, URL, size in bytes, MIME type, date and whether it was uploaded. File contents are not downloaded. Use for \"What files are attached to Trello card 5abbe4b7ddc1b351ef961416\".","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":"list_card_attachmentsArguments","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_labels":{"post":{"operationId":"list_board_labels","summary":"List the labels defined on a board with name and color. Use for \"Which labels does Trello board 5abbe4b7ddc1b351ef961414","description":"List the labels defined on a board with name and color. Use for \"Which labels does Trello board 5abbe4b7ddc1b351ef961414 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"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many labels to return (1 to 1000, default 50).","title":"Limit"}},"required":["board_id"],"title":"list_board_labelsArguments","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_label":{"post":{"operationId":"get_label","summary":"Get one label by id: name, color and the board it belongs to. Use for \"Show Trello label 5abbe4b7ddc1b351ef961417\".","description":"Get one label by id: name, color and the board it belongs to. Use for \"Show Trello label 5abbe4b7ddc1b351ef961417\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"label_id":{"description":"Trello label ID (24 hex characters), from list_board_labels.","maxLength":200,"title":"Label Id","type":"string"}},"required":["label_id"],"title":"get_labelArguments","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_custom_fields":{"post":{"operationId":"list_board_custom_fields","summary":"List the custom fields defined on a board (Custom Fields Power-Up): id, type (text, number, date, checkbox, list), where","description":"List the custom fields defined on a board (Custom Fields Power-Up): id, type (text, number, date, checkbox, list), where it shows on cards and its name. Use for \"Which custom fields does Trello board 5abbe4b7ddc1b351ef961414 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"}},"required":["board_id"],"title":"list_board_custom_fieldsArguments","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_custom_field_options":{"post":{"operationId":"list_custom_field_options","summary":"List the choices of a drop-down custom field with their value and color. Use for \"What choices does Trello custom field ","description":"List the choices of a drop-down custom field with their value and color. Use for \"What choices does Trello custom field 5abbe4b7ddc1b351ef96141a offer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"custom_field_id":{"description":"Trello custom field ID (24 hex characters), from list_board_custom_fields.","maxLength":200,"title":"Custom Field Id","type":"string"}},"required":["custom_field_id"],"title":"list_custom_field_optionsArguments","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_custom_field_items":{"post":{"operationId":"list_card_custom_field_items","summary":"List the custom field values set on a card: field id, the value, and the value's type key. Use for \"Which custom field v","description":"List the custom field values set on a card: field id, the value, and the value's type key. Use for \"Which custom field values does Trello card 5abbe4b7ddc1b351ef961416 have\".","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":"list_card_custom_field_itemsArguments","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}}}}