{"openapi":"3.1.0","info":{"title":"Honeybadger (BYOK) API","version":"0.1.0","description":"Honeybadger (BYOK) lets an AI assistant read your own Honeybadger data through the Honeybadger API with a key you supply (personal auth token). Read-only: 10 tools (list_accounts, list_projects, get_project, list_faults, get_fault, list_fault_notices, list_deploys, list_check_ins, list_uptime_sites, list_site_outages). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-honeybadger.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-honeybadger/docs"},"termsOfService":"https://connectorbay.com/byok-honeybadger/terms"},"servers":[{"url":"https://byok-honeybadger.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-honeybadger/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_accounts":{"post":{"operationId":"list_accounts","summary":"List the Honeybadger accounts the token's user belongs to, with id, name and active flag. Use for \"Which Honeybadger acc","description":"List the Honeybadger accounts the token's user belongs to, with id, name and active flag. Use for \"Which Honeybadger accounts do I belong to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_accountsArguments","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_projects":{"post":{"operationId":"list_projects","summary":"List Honeybadger projects across the user's accounts (or one account) with fault counts, environments and last error tim","description":"List Honeybadger projects across the user's accounts (or one account) with fault counts, environments and last error time. Use for \"Which Honeybadger projects do I have and how many unresolved errors does each have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"anyOf":[{"maxLength":50,"type":"string"},{"type":"null"}],"default":null,"description":"Only projects of this account id, from list_accounts.","title":"Account Id"}},"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 Honeybadger project: name, environments, error counts, last error time and uptime sites. Use for \"Show Honeybadg","description":"Get one Honeybadger project: name, environments, error counts, last error time and uptime sites. Use for \"Show Honeybadger project 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), 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_faults":{"post":{"operationId":"list_faults","summary":"List a project's faults (errors) with class, message, environment, resolved and ignored flags, occurrence count and last","description":"List a project's faults (errors) with class, message, environment, resolved and ignored flags, occurrence count and last occurrence time. Use for \"What unresolved errors does my Honeybadger project have in production\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"},"q":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Honeybadger search string, for example 'environment:production -is:resolved -is:ignored'.","title":"Q"},"order":{"anyOf":[{"enum":["recent","frequent"],"type":"string"},{"type":"null"}],"default":null,"description":"recent for most recently occurred first, frequent for most occurrences first; default is creation time.","title":"Order"},"occurred_after":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only faults that occurred after this time.","title":"Occurred After"},"occurred_before":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only faults that occurred before this time.","title":"Occurred Before"},"created_after":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only faults created after this time.","title":"Created After"},"limit":{"anyOf":[{"maximum":25,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 25, the default).","title":"Limit"}},"required":["project_id"],"title":"list_faultsArguments","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_fault":{"post":{"operationId":"get_fault","summary":"Get one fault (error) of a project: class, message, environment, status flags, occurrence count, assignee and tags. Use ","description":"Get one fault (error) of a project: class, message, environment, status flags, occurrence count, assignee and tags. Use for \"Show Honeybadger error 2 in project 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"},"fault_id":{"description":"Fault (error) id (a number), from list_faults.","maximum":1000000000000,"minimum":1,"title":"Fault Id","type":"integer"}},"required":["project_id","fault_id"],"title":"get_faultArguments","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_fault_notices":{"post":{"operationId":"list_fault_notices","summary":"List individual occurrences (notices) of a fault, newest first, with time, message and link. Request details, cookies an","description":"List individual occurrences (notices) of a fault, newest first, with time, message and link. Request details, cookies and session data are left out. Use for \"Show the latest occurrences of Honeybadger error 2\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"},"fault_id":{"description":"Fault (error) id (a number), from list_faults.","maximum":1000000000000,"minimum":1,"title":"Fault Id","type":"integer"},"created_after":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only occurrences after this time.","title":"Created After"},"created_before":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only occurrences before this time.","title":"Created Before"},"limit":{"anyOf":[{"maximum":25,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 25, the default).","title":"Limit"}},"required":["project_id","fault_id"],"title":"list_fault_noticesArguments","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":"List a project's deploys, newest first, with environment, revision, repository, deploying user and time. Use for \"What w","description":"List a project's deploys, newest first, with environment, revision, repository, deploying user and time. Use for \"What were the latest deploys recorded in Honeybadger\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"},"environment":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only deploys to this environment, for example 'production'.","title":"Environment"},"local_username":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only deploys made by this username.","title":"Local Username"},"created_after":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only deploys after this time.","title":"Created After"},"created_before":{"anyOf":[{"maximum":4102444800,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Unix timestamp in seconds. Only deploys before this time.","title":"Created Before"},"limit":{"anyOf":[{"maximum":25,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many results to return (1 to 25, the default).","title":"Limit"}},"required":["project_id"],"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/list_check_ins":{"post":{"operationId":"list_check_ins","summary":"List a project's check-ins (cron and scheduled-job monitors) with state, schedule, last report time and missed count. Us","description":"List a project's check-ins (cron and scheduled-job monitors) with state, schedule, last report time and missed count. Use for \"Are my scheduled jobs checking in on Honeybadger\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"}},"required":["project_id"],"title":"list_check_insArguments","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_uptime_sites":{"post":{"operationId":"list_uptime_sites","summary":"List a project's uptime-monitored sites with URL, current state (up or down), check frequency and last check time. Use f","description":"List a project's uptime-monitored sites with URL, current state (up or down), check frequency and last check time. Use for \"Are my websites up according to Honeybadger\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"}},"required":["project_id"],"title":"list_uptime_sitesArguments","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_site_outages":{"post":{"operationId":"list_site_outages","summary":"List past outages of one uptime site with start, end, HTTP status and reason. Use for \"When was my site last down accord","description":"List past outages of one uptime site with start, end, HTTP status and reason. Use for \"When was my site last down according to Honeybadger\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Honeybadger project id (a number), from list_projects.","maximum":1000000000000,"minimum":1,"title":"Project Id","type":"integer"},"site_id":{"description":"Uptime site id (a UUID), from list_uptime_sites.","maxLength":64,"title":"Site Id","type":"string"}},"required":["project_id","site_id"],"title":"list_site_outagesArguments","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}}}}