Honeybadger

Stop monitoring an uptime site and delete it. Deleting takes two calls: the first deletes nothing and returns a preview with a confirmation token. Show the preview to the user, and only if they approve, call again with the same arguments and confirm set to that token.

Get a single Insights alarm by ID. To interpret alarm configuration, fetch reference topic: alarms (via get_reference).

Get the trigger history for an Insights alarm. To interpret trigger records and alarm states, fetch reference topic: alarms (via get_reference).

Get a single check-in by ID. To interpret check-in state and schedule fields, fetch reference topic: checkins (via get_reference).

Get a single Insights dashboard by ID

Get a deploy by ID. A deployed event and a fault's last_notice_deploy name deploys by ID.

Get detailed information for a specific fault in a project. last_notice_deploy is the newest deploy in the fault's environment before its last notice: a guess from timing, not the deploy that introduced or resolved the error.

Get a single comment on a fault by ID.

Get fault count statistics for a project, with optional filtering. Requires reference topic: errors (fetch via get_reference; skip if still visible in your context) for the q search syntax.

Get a single notification integration by ID. To interpret integration fields, fetch reference topic: integrations (via get_reference).

Get a single Honeybadger project by ID. Its Ingestion Keys aren't included; list them with list_ingestion_keys.

List notification integrations for a Honeybadger project. To interpret integration types and config fields, fetch reference topic: integrations (via get_reference).

Get occurrence counts over time, for one project or across every project the credential can reach.

Returns Honeybadger reference documentation by topic. Topics: badgerql (query language), queries (Insights query fundamentals: streams, time ranges, field grounding), charts (visualization views, chart_config), dashboards (widgets, layout), alarms (trigger_config, states, patterns), errors (fault/notice model, error search syntax), checkins (cron/scheduled-task monitoring: schedule types, plan gating, timezone format, report payloads, lifecycle states), integrations (notification integrations: types, config fields, events, scoping). Fetch all topics you need in one call, e.g. topics: ["badgerq…

Get an uptime site: its URL, check settings and current state. Up, down and cert_will_expire events name the site by ID.

List all Insights alarms for a Honeybadger project. To interpret alarm configuration, fetch reference topic: alarms (via get_reference).

List a check-in's history, newest first: each time it reported, went missing or was paused. Use it to explain a check_in_missing or check_in_reporting event. To page back, pass the previous response's next_created_before as created_before.

List check-ins (cron/scheduled task monitoring) for a Honeybadger project. Returns every check-in, following pagination. To interpret check-in state and schedule fields, fetch reference topic: checkins (via get_reference).

List all Insights dashboards for a Honeybadger project

List a project's deploys, newest first: revision, repository, environment and who deployed. Filter by environment or deployer. To page back, pass before from the previous response's time_series.oldest_cursor.

Get a list of users who were affected by a specific fault with occurrence counts. At most 500 users are returned, with or without q.

List every comment on a fault, newest first.

Get a list of notices (individual error events) for a specific fault

Get a list of faults for a project with optional filtering and ordering. Requires reference topic: errors (fetch via get_reference; skip if still visible in your context) for the fault/notice model and the q search syntax.

List a project's Ingestion Keys: the hbp_ keys an app uses to send errors and events to Honeybadger, set as ingestion_key in the client's config (api_key in older clients). An Ingestion Key isn't a secret, since it ships in apps, and it can't call the Data API; that takes an API Token.

List all Honeybadger projects (returns summary info; use get_project for full details). A project can have several Ingestion Keys; list them with list_ingestion_keys.

List an uptime site's outages, newest first: when it went down and came back up, with the status and reason from the failing check. Use it to explain a down or up event. To page back, pass the previous response's next_created_before as created_before.

List a project's uptime sites: the URLs Honeybadger checks, with their current state (up, down, paused).

List Insights data streams for a Honeybadger project. Streams partition Insights event data (e.g. default vs internal).

List an uptime site's individual checks, newest first: each check's location, response status and duration. A busy site has many; keep limit small. To page back, pass the previous response's next_created_before as created_before.

Execute a BadgerQL query against Insights data. Requires reference topics: queries, badgerql (fetch via get_reference; skip topics still visible in your context). To visualize or share results, also fetch the charts topic.

Update an existing Insights alarm. IMPORTANT: Requires reference topics: alarms, queries, badgerql — fetch via get_reference first (skip topics still visible in your context) for the trigger_config schema and query guidelines.

Update an existing check-in. Only the provided fields are changed; fields cannot be cleared once set. The schedule type cannot be changed after creation. IMPORTANT: Requires reference topic: checkins — fetch via get_reference first (skip if still visible in your context) for schedule fields, plan gating, and the timezone format.

Update an existing Insights dashboard. Only the parameters given are changed, so a rename needs only title. IMPORTANT: Requires reference topics: dashboards, charts, queries, badgerql — fetch via get_reference first (skip topics still visible in your context).

Resolve, unresolve, ignore, or unignore a fault, assign it to a project member, or set it to resolve on the next deploy. Only the provided fields are changed. Each field is a separate request, so a later one can fail after an earlier one has already taken effect; the result names what was applied.

Replace the body of an existing fault comment. Returns the comment as stored. Only the comment's author can edit it, so an account-scoped API Token, which has no author, is refused with access_denied.

Update an Ingestion Key's label.

Update an existing Honeybadger project