{"openapi":"3.1.0","info":{"title":"Trello Workspaces (BYOK) API","version":"0.1.0","description":"Trello Workspaces (BYOK) lets an AI assistant read your own Trello Workspaces data through the Trello Workspaces API with a key you supply (Trello API key). Read-only: 7 tools (get_organization, list_organization_boards, list_organization_tags, get_board_settings, list_saved_searches, get_enterprise, list_enterprise_organizations). The BYOK key travels with each request, is used for that one call...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-trello-workspaces.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-trello-workspaces/docs"},"termsOfService":"https://connectorbay.com/byok-trello-workspaces/terms"},"servers":[{"url":"https://byok-trello-workspaces.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-trello-workspaces/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_organization":{"post":{"operationId":"get_organization","summary":"Get one Trello workspace: name, plan offering, last activity, permission level, enabled premium features and the ids of ","description":"Get one Trello workspace: name, plan offering, last activity, permission level, enabled premium features and the ids of its boards. Use for \"What plan and settings does Trello workspace acmeinc have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Trello workspace (organization) id, 24 hex characters, or its short name such as 'acmeinc'. List yours with the Trello connector's list_my_workspaces.","maxLength":200,"title":"Organization Id","type":"string"}},"required":["organization_id"],"title":"get_organizationArguments","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_organization_boards":{"post":{"operationId":"list_organization_boards","summary":"List the boards of a Trello workspace with name, closed flag, last activity and URL. Use for \"Which boards are in Trello","description":"List the boards of a Trello workspace with name, closed flag, last activity and URL. Use for \"Which boards are in Trello workspace acmeinc\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Trello workspace (organization) id, 24 hex characters, or its short name such as 'acmeinc'. List yours with the Trello connector's list_my_workspaces.","maxLength":200,"title":"Organization Id","type":"string"},"filter":{"anyOf":[{"enum":["all","open","closed","members","organization","public"],"type":"string"},{"type":"null"}],"default":"open","description":"Which boards: all, open, closed, members, organization or public.","title":"Filter"},"fields":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"name,closed,idOrganization,dateLastActivity,url,shortUrl","description":"Comma-separated board fields to return.","title":"Fields"}},"required":["organization_id"],"title":"list_organization_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/list_organization_tags":{"post":{"operationId":"list_organization_tags","summary":"List the tags (collections of boards) defined in a Trello workspace. Use for \"Which board tags does Trello workspace acm","description":"List the tags (collections of boards) defined in a Trello workspace. Use for \"Which board tags does Trello workspace acmeinc use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"organization_id":{"description":"Trello workspace (organization) id, 24 hex characters, or its short name such as 'acmeinc'. List yours with the Trello connector's list_my_workspaces.","maxLength":200,"title":"Organization Id","type":"string"}},"required":["organization_id"],"title":"list_organization_tagsArguments","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_settings":{"post":{"operationId":"get_board_settings","summary":"Get a Trello board's preferences (visibility, voting, comments, invitations, self-join, card covers, card aging) and its","description":"Get a Trello board's preferences (visibility, voting, comments, invitations, self-join, card covers, card aging) and its label names. Use for \"Who can comment and vote 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"},"fields":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"name,closed,idOrganization,prefs,labelNames","description":"Comma-separated board fields to return.","title":"Fields"}},"required":["board_id"],"title":"get_board_settingsArguments","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_saved_searches":{"post":{"operationId":"list_saved_searches","summary":"List the saved searches of the member the token belongs to, with name and search query. Use for \"Which Trello searches h","description":"List the saved searches of the member the token belongs to, with name and search query. Use for \"Which Trello searches have I saved\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_saved_searchesArguments","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_enterprise":{"post":{"operationId":"get_enterprise","summary":"Get a Trello Enterprise: name, license and member totals, number of workspaces, SSO state and maximum members. Enterpris","description":"Get a Trello Enterprise: name, license and member totals, number of workspaces, SSO state and maximum members. Enterprise admin token needed. Use for \"How many licensed members does our Trello Enterprise have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"enterprise_id":{"description":"Trello Enterprise id (24 hex characters). Needs an Enterprise plan and an enterprise admin token.","maxLength":200,"title":"Enterprise Id","type":"string"}},"required":["enterprise_id"],"title":"get_enterpriseArguments","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_enterprise_organizations":{"post":{"operationId":"list_enterprise_organizations","summary":"List the workspaces that belong to a Trello Enterprise with name, plan offering and board ids. Enterprise admin token ne","description":"List the workspaces that belong to a Trello Enterprise with name, plan offering and board ids. Enterprise admin token needed. Use for \"Which workspaces belong to our Trello Enterprise\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"enterprise_id":{"description":"Trello Enterprise id (24 hex characters). Needs an Enterprise plan and an enterprise admin token.","maxLength":200,"title":"Enterprise Id","type":"string"},"count":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return (1 to 100).","title":"Count"},"start_index":{"anyOf":[{"maximum":9999,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Index of the first result, starting at 0 (up to 9999).","title":"Start Index"},"fields":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"name,displayName,dateLastActivity,offering,url,idBoards","description":"Comma-separated workspace fields to return.","title":"Fields"}},"required":["enterprise_id"],"title":"list_enterprise_organizationsArguments","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}}}}