{"openapi":"3.1.0","info":{"title":"Rollbar (BYOK) API","version":"0.1.0","description":"Rollbar (BYOK) lets an AI assistant read your own Rollbar data through the Rollbar API with a key you supply (read-scope access token). Read-only: 10 tools (list_projects, get_project, list_items, get_item, list_top_active_items, list_deploys, get_deploy, list_environments, list_users, list_teams). The BYOK key travels with each request, is used for that one call only and is never stored, logged...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-rollbar.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-rollbar/docs"},"termsOfService":"https://connectorbay.com/byok-rollbar/terms"},"servers":[{"url":"https://byok-rollbar.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-rollbar/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_projects":{"post":{"operationId":"list_projects","summary":"Needs an account access token with read scope. List the Rollbar projects of the account with id, name, status and creati","description":"Needs an account access token with read scope. List the Rollbar projects of the account with id, name, status and creation date. Use for \"Which Rollbar projects do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_projectsArguments","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_project":{"post":{"operationId":"get_project","summary":"Get one Rollbar project by id: name, status, time zone and creation date. Needs an account access token with read scope.","description":"Get one Rollbar project by id: name, status, time zone and creation date. Needs an account access token with read scope. Use for \"Show Rollbar project 12345\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Numeric Rollbar project id, from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"}},"required":["project_id"],"title":"get_projectArguments","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_items":{"post":{"operationId":"list_items","summary":"Works with a project access token or an account access token (read scope). List error items (grouped errors) with title,","description":"Works with a project access token or an account access token (read scope). List error items (grouped errors) with title, level, status, environment, occurrence counts and last-seen time. 100 items per page; filter to keep the answer small. Use for \"What active critical errors do I have in production on Rollbar\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"status":{"anyOf":[{"enum":["active","resolved","muted","archived"],"type":"string"},{"type":"null"}],"default":null,"description":"Only items with this status.","title":"Status"},"level":{"anyOf":[{"enum":["debug","info","warning","error","critical"],"type":"string"},{"type":"null"}],"default":null,"description":"Only items with this level.","title":"Level"},"environment":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only items in this environment, for example 'production'.","title":"Environment"},"query":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Search text in the same format as the search box on the Items page.","title":"Query"},"project_ids":{"anyOf":[{"maximum":1000000000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Account tokens only: one project id to search; leave out for all projects.","title":"Project Ids"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (100 items per page).","title":"Page"}},"title":"list_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/get_item":{"post":{"operationId":"get_item","summary":"Works with a project access token or an account access token (read scope). Get one error item by its id: title, level, s","description":"Works with a project access token or an account access token (read scope). Get one error item by its id: title, level, status, environment, framework, occurrence totals, first and last seen times and assignee. Use for \"Show Rollbar item 275123456\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item_id":{"description":"Numeric Rollbar item id (the id field of an item, not the counter).","maximum":1000000000000,"minimum":1,"title":"Item Id","type":"integer"}},"required":["item_id"],"title":"get_itemArguments","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_top_active_items":{"post":{"operationId":"list_top_active_items","summary":"Works with a project access token or an account access token (read scope). List the items with the most occurrences in t","description":"Works with a project access token or an account access token (read scope). List the items with the most occurrences in the last hours (1 to 168), with counts per bucket. Use for \"What are my noisiest Rollbar errors in the last 24 hours\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hours":{"anyOf":[{"maximum":168,"minimum":1,"type":"integer"},{"type":"null"}],"default":24,"description":"How many recent hours to consider (1 to 168).","title":"Hours"},"environments":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated environments to include, for example 'production,staging'; leave out for all.","title":"Environments"},"project_id":{"anyOf":[{"maximum":1000000000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Account tokens only: id of the project to read; project tokens leave this out.","title":"Project Id"},"sort":{"anyOf":[{"const":"occurrences","type":"string"},{"type":"null"}],"default":null,"description":"Use 'occurrences' to sort by occurrence count instead of level.","title":"Sort"}},"title":"list_top_active_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_deploys":{"post":{"operationId":"list_deploys","summary":"Works with a project access token or an account access token (read scope). List recent deploys of a project with environ","description":"Works with a project access token or an account access token (read scope). List recent deploys of a project with environment, revision, user, comment, status and start time. 20 per page. . Use for \"What were the latest deploys recorded in Rollbar\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"anyOf":[{"maximum":1000000000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Account tokens only: id of the project to read; project tokens leave this out.","title":"Project Id"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (20 deploys per page).","title":"Page"}},"title":"list_deploysArguments","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_deploy":{"post":{"operationId":"get_deploy","summary":"Works with a project access token or an account access token (read scope). Get one deploy by id: environment, revision, ","description":"Works with a project access token or an account access token (read scope). Get one deploy by id: environment, revision, user, comment, status, start and finish time. Use for \"Show Rollbar deploy 5\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"deploy_id":{"description":"Numeric deploy id, from list_deploys.","maximum":1000000000000,"minimum":1,"title":"Deploy Id","type":"integer"}},"required":["deploy_id"],"title":"get_deployArguments","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_environments":{"post":{"operationId":"list_environments","summary":"List the environments seen by a project (production, staging, ...) and whether each is visible. . Use for \"Which environ","description":"List the environments seen by a project (production, staging, ...) and whether each is visible. . Use for \"Which environments report errors to Rollbar\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"anyOf":[{"maximum":1000000000000,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Account tokens only: id of the project to read; project tokens leave this out.","title":"Project Id"}},"title":"list_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/list_users":{"post":{"operationId":"list_users","summary":"Needs an account access token with read scope. List the users who are members of the Rollbar account with id, username a","description":"Needs an account access token with read scope. List the users who are members of the Rollbar account with id, username and email, optionally by email. Use for \"Who has access to our Rollbar account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"email":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the user with this email address.","title":"Email"}},"title":"list_usersArguments","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_teams":{"post":{"operationId":"list_teams","summary":"List the teams of the Rollbar account with id, name and access level. Needs an account access token with read scope. Use","description":"List the teams of the Rollbar account with id, name and access level. Needs an account access token with read scope. Use for \"Which teams exist in our Rollbar account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_teamsArguments","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}}}}