{"openapi":"3.1.0","info":{"title":"Boomi (BYOK) API","version":"0.1.0","description":"Boomi (BYOK) lets an AI assistant read your own Boomi data through the Boomi API with a key you supply (Boomi username in the form BOOMI_TOKEN.<your user name>). Read-only: 9 tools (get_account, query_runtimes, get_runtime, query_processes, query_environments, query_folders, query_components, query_deployments, query_executions). 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-boomi.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-boomi/docs"},"termsOfService":"https://connectorbay.com/byok-boomi/terms"},"servers":[{"url":"https://byok-boomi.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-boomi/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_account":{"post":{"operationId":"get_account","summary":"Get a Boomi account record: name, status, creation and expiration dates and support level. Use for \"What is the status a","description":"Get a Boomi account record: name, status, creation and expiration dates and support level. Use for \"What is the status and expiry of my Boomi account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"}},"required":["account_id"],"title":"get_accountArguments","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/query_runtimes":{"post":{"operationId":"query_runtimes","summary":"Find Boomi runtimes (Atoms, Molecules, cloud attachments) by name: status, type, host, version and install date. At most","description":"Find Boomi runtimes (Atoms, Molecules, cloud attachments) by name: status, type, host, version and install date. At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"Which Boomi runtimes have 'prod' in the name and are they online\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Text the runtime name must contain.","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_runtimesArguments","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_runtime":{"post":{"operationId":"get_runtime","summary":"Get one Boomi runtime (Atom) by id: name, status, type, host, version and purge settings. Use for \"Show details of Boomi","description":"Get one Boomi runtime (Atom) by id: name, status, type, host, version and purge settings. Use for \"Show details of Boomi runtime atom-1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"runtime_id":{"description":"Runtime (Atom) id from query_runtimes.","maxLength":200,"title":"Runtime Id","type":"string"}},"required":["account_id","runtime_id"],"title":"get_runtimeArguments","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/query_processes":{"post":{"operationId":"query_processes","summary":"Find Boomi processes by name; returns id, name and description. At most 100 matches are returned per call (the API pages","description":"Find Boomi processes by name; returns id, name and description. At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"Which Boomi processes have 'order' in the name\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Text the process name must contain.","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_processesArguments","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/query_environments":{"post":{"operationId":"query_environments","summary":"Find Boomi environments by name; returns id, name and classification (production or test). At most 100 matches are retur","description":"Find Boomi environments by name; returns id, name and classification (production or test). At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"Which Boomi environments are production\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Text the environment name must contain.","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_environmentsArguments","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/query_folders":{"post":{"operationId":"query_folders","summary":"Find Boomi folders by name; returns id, name, full path, parent and deleted flag. At most 100 matches are returned per c","description":"Find Boomi folders by name; returns id, name, full path, parent and deleted flag. At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"Which Boomi folders contain 'sales'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Text the folder name must contain.","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_foldersArguments","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/query_components":{"post":{"operationId":"query_components","summary":"Find Boomi components (processes, maps, connectors) by name: type, version, folder and last change. At most 100 matches ","description":"Find Boomi components (processes, maps, connectors) by name: type, version, folder and last change. At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"Which Boomi components were changed recently with 'order' in the name\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Text the component name must contain.","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_componentsArguments","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/query_deployments":{"post":{"operationId":"query_deployments","summary":"List component deployments in one Boomi environment: component, type, version, deployer and time. At most 100 matches ar","description":"List component deployments in one Boomi environment: component, type, version, deployer and time. At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"What is deployed in Boomi environment env-1234\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Environment id whose deployments to list (from query_environments).","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_deploymentsArguments","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/query_executions":{"post":{"operationId":"query_executions","summary":"Find Boomi process execution records by process name: status, runtime, time, duration and document counts. At most 100 m","description":"Find Boomi process execution records by process name: status, runtime, time, duration and document counts. At most 100 matches are returned per call (the API pages beyond that with a token this tool does not follow); narrow the text to see more. Use for \"Did my Boomi order processes run successfully recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Your Boomi account id (shown in Manage > Account Information).","maxLength":200,"title":"Account Id","type":"string"},"text":{"description":"Text the process name must contain.","maxLength":200,"title":"Text","type":"string"}},"required":["account_id","text"],"title":"query_executionsArguments","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}}}}