The Honeybadger connector lets your AI agent act in each user's Honeybadger account. Each user connects their own Honeybadger access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.
- Tools
- 60
- What they doRead · write · destructive
- 36 · 19 · 536 read19 write5 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Honeybadger connection
In AgentKit > Connections, create a Honeybadger connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'honeybadger'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Honeybadger:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'honeybadger_account_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "honeybadger"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Honeybadger:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="honeybadger_account_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Honeybadger credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolhoneybadger_account_getGet the Honeybadger account the token belongs to.Read-onlyGet Account
Get the Honeybadger account the token belongs to. Returns the account id, name, plan and settings. Use honeybadger_account_usage_get for usage numbers.
Inputs
This tool takes no inputs.
honeybadger_account_usage_getGet usage statistics for the account, such as error, Insights and uptime volume against the plan.Read-onlyGet Account Usage
Get usage statistics for the account, such as error, Insights and uptime volume against the plan. Returns usage counts and plan limits for the current period. Use honeybadger_account_get for the account's name and plan.
Inputs
This tool takes no inputs.
honeybadger_alarm_getGet one Insights alarm.Read-onlyGet Insights Alarm
Get one Insights alarm. Returns its query, evaluation schedule, trigger_config and current state. Use honeybadger_alarms_list to find the ID.
Inputs
alarm_idstringrequired- ID of the Insights alarm. Get it from honeybadger_alarms_list. Example: Al3hJk.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_alarm_history_listList an Insights alarm's trigger history, newest first, 25 per page.Read-onlyList Alarm History
List an Insights alarm's trigger history, newest first, 25 per page. Returns each trigger's state, result and timestamp. Use honeybadger_alarm_get for the alarm's settings.
Inputs
alarm_idstringrequired- ID of the Insights alarm. Get it from honeybadger_alarms_list. Example: Al3hJk.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
honeybadger_alarms_listList every Insights alarm on a project.Read-onlyList Insights Alarms
List every Insights alarm on a project. Returns each alarm's id, name, query, trigger configuration and state. Use honeybadger_alarm_history_list for when an alarm fired.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_check_in_events_listList a check-in's state-change events (reporting, missing, paused), newest first.Read-onlyList Check-In Events
List a check-in's state-change events (reporting, missing, paused), newest first. Returns each event's state, created_at and reported payload, plus an older cursor link. Use this to see when a job missed its schedule.
Inputs
check_in_idstringrequired- ID of the check-in monitor. Get it from honeybadger_check_ins_list. Example: Ci5xWq.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
created_beforenumber- Only items created before this Unix timestamp (seconds, not ISO 8601). Take it from links.older; fractional seconds count. Example: 1731024000.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
honeybadger_check_in_getGet one check-in monitor.Read-onlyGet Check-In
Get one check-in monitor. Returns its schedule, state, report_url, reported_at and expected_at. Use honeybadger_check_ins_list to find the ID.
Inputs
check_in_idstringrequired- ID of the check-in monitor. Get it from honeybadger_check_ins_list. Example: Ci5xWq.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_check_ins_listList a project's check-in monitors for scheduled jobs.Read-onlyList Check-Ins
List a project's check-in monitors for scheduled jobs. Returns each check-in's id, name, slug, schedule, state (pending, reporting, missing or paused), last report and next expected time. Use honeybadger_check_in_events_list for a check-in's history.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_dashboard_getGet one Insights dashboard with its widgets.Read-onlyGet Insights Dashboard
Get one Insights dashboard with its widgets. Returns the title, widget configs with their BadgerQL queries, and layout. Run a widget's query with honeybadger_insights_query_run.
Inputs
dashboard_idstringrequired- ID of the Insights dashboard. Get it from honeybadger_dashboards_list. Example: Db8nQw.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_dashboards_listList a project's Insights dashboards.Read-onlyList Insights Dashboards
List a project's Insights dashboards. Returns each dashboard's id, title and widgets. Use honeybadger_dashboard_get for one dashboard.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_deploys_listList a project's recorded deploys, newest first, optionally by environment or deploy username.Read-onlyList Deploys
List a project's recorded deploys, newest first, optionally by environment or deploy username. Returns each deploy's id, environment, revision, repository, local_username and created_at, plus cursor links. Use the environment filter to see one environment's deploys.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
afterstring- Cursor for newer items, taken from the links.newer URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
beforestring- Cursor for older items, taken from the links.older URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
environmentstring- Exact environment name to match. Ignored when blank. Example: production.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
local_usernamestring- Exact deploy username to match. Ignored when blank; combines with environment when both are provided. Example: deploybot.
honeybadger_environments_listList a project's environments, such as production and staging.Read-onlyList Environments
List a project's environments, such as production and staging. Returns each environment's id, name and notification settings. Use the names as the environment filter on the occurrence and deploy tools.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_fault_affected_users_listList the up to 500 users a fault affected most, ranked by notice count.Read-onlyList Fault Affected Users
List the up to 500 users a fault affected most, ranked by notice count. Returns each user identifier and its count. Use q to count only matching notices.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_fault_comments_listList the comments on a fault.Read-onlyList Fault Comments
List the comments on a fault. Returns each comment's id, body, author and timestamps, plus cursor links. Use honeybadger_fault_comment_create to add one.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
afterstring- Cursor for newer items, taken from the links.newer URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
beforestring- Cursor for older items, taken from the links.older URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
honeybadger_fault_getGet one fault (error group) by ID.Read-onlyGet Fault
Get one fault (error group) by ID. Returns the fault's class, message, component, action, environment, counts, state, assignee, tags and URL. Use honeybadger_fault_notices_list for backtraces and request context.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_notices_listList a fault's notices (individual error occurrences), newest first.Read-onlyList Fault Notices
List a fault's notices (individual error occurrences), newest first. Returns each notice's id, message, backtrace, request, context, environment and created_at, plus older and newer cursor links. Use this to read backtraces. Use honeybadger_notice_get for one notice by ID.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
afterstring- Cursor for newer items, taken from the links.newer URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
beforestring- Cursor for older items, taken from the links.older URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
unmappedboolean- Return the backtrace as the client reported it instead of source-mapped. Accepts true/false, 1/0, yes/no, on/off. Defaults to false. Example: true.
honeybadger_fault_occurrences_getGet a fault's occurrence counts over a time window (the last hour by default), bucketed by interval.Read-onlyGet Fault Occurrence Counts
Get a fault's occurrence counts over a time window (the last hour by default), bucketed by interval. Returns [timestamp, count] buckets and meta.window and meta.interval_seconds. Use honeybadger_project_occurrences_get for the whole project.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
occurred_afternumber- Only occurrences after this Unix timestamp (seconds, not ISO 8601). A value before the project's retention window is moved up to it. On the fault list, occurrence counts cover this window. Example: 1730419200.
occurred_beforenumber- Only occurrences before this Unix timestamp (seconds, not ISO 8601). Example: 1731024000.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_faults_listList a project's faults (grouped errors), filtered with error search and time windows and sorted by recency or frequency.Read-onlyList Faults
List a project's faults (grouped errors), filtered with error search and time windows and sorted by recency or frequency. Returns each fault's id, klass, message, environment, notices_count, resolved and ignored state, assignee, tags and timestamps, plus pagination links. Use this to find errors. Use honeybadger_fault_get for one fault and honeybadger_fault_notices_list for its occurrences.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
created_afternumber- Only faults first seen after this Unix timestamp (seconds, not ISO 8601). Example: 1730419200.
occurred_afternumber- Only occurrences after this Unix timestamp (seconds, not ISO 8601). A value before the project's retention window is moved up to it. On the fault list, occurrence counts cover this window. Example: 1730419200.
occurred_beforenumber- Only occurrences before this Unix timestamp (seconds, not ISO 8601). Example: 1731024000.
orderstring- recent sorts by last occurrence, frequent by occurrence count. Left out, by creation time. Example: recent.one of
recentfrequent pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
sortstring- Direction for order. Defaults to desc for recent and frequent, asc for creation time. Example: asc.one of
ascdesc
honeybadger_faults_summary_getGet a project's fault counts grouped by environment and by resolved or ignored state, with the same filters as the fault list.Read-onlyGet Fault Counts
Get a project's fault counts grouped by environment and by resolved or ignored state, with the same filters as the fault list. Returns total, environment and status counts. Use this for an overview. Use honeybadger_faults_list for the faults themselves.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
created_afternumber- Only faults first seen after this Unix timestamp (seconds, not ISO 8601). Example: 1730419200.
occurred_afternumber- Only count faults that occurred after this Unix timestamp. Example: 1730419200.
occurred_beforenumber- Only count faults that occurred before this Unix timestamp. Example: 1731024000.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_insights_query_runRun a BadgerQL query against a project's Insights event streams.Read-onlyRun Insights Query
Run a BadgerQL query against a project's Insights event streams. It changes nothing. Returns the result rows, field metadata and query statistics. Use this to analyse logs and events. Use honeybadger_streams_list to pick stream_ids.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
querystringrequired- BadgerQL query. Example: fields @ts, message | filter event_type::str == "error" | sort @ts desc | limit 20.
stream_idsarray- Streams to search. Omit it, or pass an empty array, to search every stream on the project. Every ID must belong to this project; repeated IDs are deduplicated. Example: ["St1aBc"]
timezonestring- Timezone for time bucketing and display. Example: America/New_York.
tsstring- Time range for the query. Example: PT3H.
honeybadger_notice_getGet one error notice by its ID, without needing its project or fault.Read-onlyGet Notice
Get one error notice by its ID, without needing its project or fault. Returns the notice's message, backtrace, request, context, environment and fault and project IDs. Use honeybadger_fault_notices_list to browse a fault's notices.
Inputs
uuidstringrequired- ID (UUID) of the notice, from honeybadger_fault_notices_list or a notice link. Example: 0b5a0c9e-6d2f-4f5e-9a3b-1c2d3e4f5a6b.
unmappedboolean- Return the backtrace as the client reported it instead of source-mapped. Accepts true/false, 1/0, yes/no, on/off. Defaults to false. Example: true.
honeybadger_project_getGet one project by ID.Read-onlyGet Project
Get one project by ID. Returns the project's name, language, settings, environments and counts. Use honeybadger_projects_list to find the ID.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_project_occurrences_getGet a project's error notice counts over an hour, day, week or month, one count per interval.Read-onlyGet Project Occurrence Counts
Get a project's error notice counts over an hour, day, week or month, one count per interval. Returns a list of [timestamp, count] buckets, with 0 for quiet intervals. Use honeybadger_projects_occurrences_get for every project at once.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
environmentstring- Only count notices from faults in this environment. Example: production.
periodstring- Window to report over. Both ends are inclusive: hour gives 61 one-minute buckets, day 25 hourly, week 8 daily, month 31 daily. Defaults to hour. Example: hour.one of
hourdayweekmonth
honeybadger_project_stats_getGet statistics for a project.Read-onlyGet Project Stats
Get statistics for a project. Returns the project's notice counts by time bucket and environment. Use honeybadger_project_occurrences_get for counts over a set period.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_projects_listList the projects the token can access, optionally matching an exact name.Read-onlyList Projects
List the projects the token can access, optionally matching an exact name. Returns each project's id, name, language, environments and settings, plus pagination links. Use this to find a project_id, which almost every other tool needs.
Inputs
namestring- Exact project name to match. Omit or leave blank to list all accessible projects. Example: Billing API.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_projects_occurrences_getGet error notice counts over a period for every project the token can read, ordered by project name.Read-onlyGet Occurrence Counts for All Projects
Get error notice counts over a period for every project the token can read, ordered by project name. Returns per-project lists of [timestamp, count] buckets. Use honeybadger_project_occurrences_get for one project.
Inputs
environmentstring- Only count notices from faults in this environment. Example: production.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
periodstring- Window to report over. Both ends are inclusive: hour gives 61 one-minute buckets, day 25 hourly, week 8 daily, month 31 daily. Defaults to hour. Example: hour.one of
hourdayweekmonth
honeybadger_site_checks_listList a site's uptime check results, newest first, optionally in a time window.Read-onlyList Uptime Checks
List a site's uptime check results, newest first, optionally in a time window. Returns each check's location, up state, status code, duration and timestamp, plus cursor links. Use honeybadger_site_outages_list for outages only.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
site_idstringrequired- UUID of the uptime monitoring site. Get it from honeybadger_sites_list. Example: 9f8b6d2e-4c1a-4b7f-9e35-2a6c8d0f1b47.
created_afternumber- With created_before, limits the list to a window. Alone, returns the items just after it, newest first. A Unix timestamp (seconds, not ISO 8601). Take it from links.newer; fractional seconds count. Example: 1730419200.
created_beforenumber- Only items created before this Unix timestamp (seconds, not ISO 8601). Take it from links.older; fractional seconds count. Example: 1731024000.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
honeybadger_site_getGet one uptime monitoring site.Read-onlyGet Uptime Site
Get one uptime monitoring site. Returns the site's url, state, last check time and all check settings. Use honeybadger_sites_list to find the site ID.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
site_idstringrequired- UUID of the uptime monitoring site. Get it from honeybadger_sites_list. Example: 9f8b6d2e-4c1a-4b7f-9e35-2a6c8d0f1b47.
honeybadger_site_outages_listList a site's outages, newest first, optionally in a time window.Read-onlyList Uptime Outages
List a site's outages, newest first, optionally in a time window. Returns each outage's down_at, up_at, status and reason. Use honeybadger_site_checks_list for every individual check.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
site_idstringrequired- UUID of the uptime monitoring site. Get it from honeybadger_sites_list. Example: 9f8b6d2e-4c1a-4b7f-9e35-2a6c8d0f1b47.
created_afternumber- With created_before, limits the list to a window. Alone, returns the items just after it, newest first. A Unix timestamp (seconds, not ISO 8601). Take it from links.newer; fractional seconds count. Example: 1730419200.
created_beforenumber- Only items created before this Unix timestamp (seconds, not ISO 8601). Take it from links.older; fractional seconds count. Example: 1731024000.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
honeybadger_sites_listList a project's uptime monitoring sites.Read-onlyList Uptime Sites
List a project's uptime monitoring sites. Returns each site's id, name, url, state (up, down or pending), frequency, locations and match settings. Use honeybadger_site_outages_list or honeybadger_site_checks_list for a site's history.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_status_page_incident_getGet one status page incident with its updates.Read-onlyGet Status Page Incident
Get one status page incident with its updates. Returns the title, build_type, current status and severity, and every update. Use honeybadger_status_page_incident_update_create to post a new update.
Inputs
incident_idstringrequired- ID of the status page incident. Get it from honeybadger_status_page_incidents_list. Example: In3pKr.
status_page_idstringrequired- ID of the status page. Get it from honeybadger_status_pages_list. Example: Sp7bMq.
honeybadger_status_page_incidents_listList a status page's incidents, newest first.Read-onlyList Status Page Incidents
List a status page's incidents, newest first. Returns each incident's id, title, build_type, current status and severity, and its updates. Use honeybadger_status_page_incident_create to open one.
Inputs
status_page_idstringrequired- ID of the status page. Get it from honeybadger_status_pages_list. Example: Sp7bMq.
afterstring- Cursor for newer items, taken from the links.newer URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
beforestring- Cursor for older items, taken from the links.older URL of the previous response. Example: eyJpZCI6IjEyMyJ9.
limitinteger- Maximum items to return, up to 100. Defaults to 25. Example: 25.
honeybadger_status_pages_listList the account's status pages.Read-onlyList Status Pages
List the account's status pages. Returns each status page's id, name, URL and the sites and check-ins it shows. Use honeybadger_status_page_incidents_list for a page's incidents.
Inputs
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_streams_listList a project's Insights event streams: default (events your apps send) and internal (errors, deploys, uptime and check-ins).Read-onlyList Event Streams
List a project's Insights event streams: default (events your apps send) and internal (errors, deploys, uptime and check-ins). Returns each stream's id, name and slug. Use the IDs as stream_ids in honeybadger_insights_query_run.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_teams_listList the account's teams, optionally matching an exact name.Read-onlyList Teams
List the account's teams, optionally matching an exact name. Returns each team's id, name and project_ids. Use a team_id when creating a project.
Inputs
namestring- Exact team name to match. Omit or leave blank to list all accessible teams. Example: Billing API.
pageinteger- Page number, starting at 1. Defaults to 1. Example: 1.
per_pageinteger- Items per page. Defaults to 25. Example: 25.
honeybadger_token_getGet the API token making the request and what it can reach.Read-onlyGet Current Token
Get the API token making the request and what it can reach. Returns the token kind, its account_id, its scopes and the project_ids it can access. Use this first to check which projects and scopes the connected token has.
Inputs
This tool takes no inputs.
honeybadger_check_in_createCreate a check-in monitor that alerts when a scheduled job stops reporting, on a simple period or a cron schedule.WriteCreate Check-In
Create a check-in monitor that alerts when a scheduled job stops reporting, on a simple period or a cron schedule. Returns the check-in with its id and report_url for the job to request. Set report_period for simple schedules, or cron_schedule and cron_timezone for cron.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
cron_schedulestring- Cron expression, required when schedule_type is cron. Example: 0 2 * * *.
cron_timezonestring- Timezone the cron schedule is evaluated in. A time zone name as the web app lists them, not an IANA identifier — Central Time (US & Canada), not America/Chicago, which is rejected. Required when schedule_type is cron. Null resets it to UTC. Example: UTC.
grace_periodstring- How long after the expected time before the check-in is considered missing. Same format as report_period; zero is 00:00:00. Null resets it to zero. Example: 15 minutes.
namestring- Display name. Null clears it; an unnamed check-in shows its ID. Example: Billing API.
report_periodstring- How often a report is expected, for simple schedules. Required unless schedule_type is cron, and may not be zero. A duration such as 5 minutes, 1 hour 30 minutes or 01:30:00. Returned in long form: 1 week comes back as 7 days. Example: 1 day.
schedule_typestring- simple expects a report every report_period; cron expects reports on cron_schedule. Switching to simple clears cron_schedule; switching to cron clears report_period. Defaults to simple. Example: simple.one of
simplecron slugstring- Short identifier used in the check-in's reporting URL. Null clears it. Renaming it breaks jobs reporting to …/check_in/<ingestion key>/<slug> and changes how PUT /check_ins matches this check-in. Example: nightly-billing.
honeybadger_check_in_updateUpdate a check-in's name, slug or schedule; send only the fields to change.WriteUpdate Check-In
Update a check-in's name, slug or schedule; send only the fields to change. Returns the updated check-in. Changing the slug breaks jobs that report to the old slug URL.
Inputs
check_in_idstringrequired- ID of the check-in monitor. Get it from honeybadger_check_ins_list. Example: Ci5xWq.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
cron_schedulestring- Cron expression, required when schedule_type is cron. Example: 0 2 * * *.
cron_timezonestring- Timezone the cron schedule is evaluated in. A time zone name as the web app lists them, not an IANA identifier — Central Time (US & Canada), not America/Chicago, which is rejected. Required when schedule_type is cron. Null resets it to UTC. Example: UTC.
grace_periodstring- How long after the expected time before the check-in is considered missing. Same format as report_period; zero is 00:00:00. Null resets it to zero. Example: 15 minutes.
namestring- Display name. Null clears it; an unnamed check-in shows its ID. Example: Billing API.
report_periodstring- How often a report is expected, for simple schedules. Required unless schedule_type is cron, and may not be zero. A duration such as 5 minutes, 1 hour 30 minutes or 01:30:00. Returned in long form: 1 week comes back as 7 days. Example: 1 day.
schedule_typestring- simple expects a report every report_period; cron expects reports on cron_schedule. Switching to simple clears cron_schedule; switching to cron clears report_period. Defaults to simple. Example: simple.one of
simplecron slugstring- Short identifier used in the check-in's reporting URL. Null clears it. Renaming it breaks jobs reporting to …/check_in/<ingestion key>/<slug> and changes how PUT /check_ins matches this check-in. Example: nightly-billing.
honeybadger_fault_assignAssign a fault to a user on the project.WriteAssign Fault
Assign a fault to a user on the project. Returns the fault with its new assignee. Use honeybadger_fault_unassign to clear the assignee.
Inputs
assignee_idstringrequired- ID of a user on the project. To unassign, DELETE the same path. Example: Us9tPq.
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_comment_createAdd a comment to a fault.WriteCreate Fault Comment
Add a comment to a fault. @mentions notify the named project members. Returns the created comment. Use honeybadger_fault_comment_update to edit it later.
Inputs
bodystringrequired- The comment text. @mentions notify the named project members. Example: Fixed in #482, deploying now. @alice can you verify?.
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_comment_updateReplace the text of a comment on a fault.WriteUpdate Fault Comment
Replace the text of a comment on a fault. Returns the updated comment. Use honeybadger_fault_comments_list to find the comment ID.
Inputs
bodystringrequired- The comment text. @mentions notify the named project members. Example: Fixed in #482, deploying now. @alice can you verify?.
comment_idstringrequired- ID of the comment on the fault. Get it from honeybadger_fault_comments_list. Example: Cm4vRt.
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_snoozeSnooze a fault's notifications for an hour, day or week, or for 10, 100 or 1000 more occurrences.WriteSnooze Fault
Snooze a fault's notifications for an hour, day or week, or for 10, 100 or 1000 more occurrences. Returns the fault with its snooze settings. Send time or count, not both. Use honeybadger_fault_unsnooze to remove the snooze.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
countinteger- Snooze until this many additional occurrences have been received. Example: 10.one of
101001000 timestring- A duration of an hour, a day or a week. Example: hour.one of
hourdayweek
honeybadger_fault_unassignRemove a fault's assignee.WriteUnassign Fault
Remove a fault's assignee. Returns the fault or no content on success. Use honeybadger_fault_assign to assign someone.
- Idempotent
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_unsnoozeRemove a fault's snooze so its notifications resume.WriteUnsnooze Fault
Remove a fault's snooze so its notifications resume. Returns the fault or no content on success. Use honeybadger_fault_snooze to snooze.
- Idempotent
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_updateUpdate a fault's resolved or ignored state, assignee or tags, or set it to resolve on the next deploy.WriteUpdate Fault
Update a fault's resolved or ignored state, assignee or tags, or set it to resolve on the next deploy. Returns the updated fault. Use honeybadger_faults_resolve to change many faults at once.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
assignee_idstring- ID of a user on the project. Null unassigns. Example: Us9tPq.
ignoredboolean- true ignores the fault (stops data collection), false stops ignoring it. Example: true.
resolve_on_deployboolean- Set to true to resolve this fault when the project's next deploy is recorded, in any environment. After that deploy, it reads false again. It has no effect if the fault is resolved or ignored once the rest of this update is applied. If the fault is resolved or ignored before the next deploy, the pending resolution is cancelled. Set it to false to cancel it yourself. Example: true.
resolvedboolean- true marks the fault resolved, false reopens it. Example: true.
tagsarray- Tags for the fault. Replaces the existing tags; an empty list removes them all. Example: ["billing", "p1"]
honeybadger_faults_ignoreMark faults as ignored, which stops data collection for them, by fault_ids, query and time filters, or all.WriteIgnore Faults
Mark faults as ignored, which stops data collection for them, by fault_ids, query and time filters, or all. Returns the number of faults changed; dry_run true only reports. Use honeybadger_faults_unignore to start collecting again.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
allboolean- Apply to every fault the other filters match, which with no other filters is every fault in the project. Required to make an unbounded change explicit; ignored when fault_ids names specific faults. Example: false.
created_afternumber- Only faults created after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
dry_runboolean- Report what the request would change without changing it — no state change, no comments, no timeline entries. The response has the same shape either way, with dry_run echoed back. Example: false.
fault_idsarray- IDs of the faults to change. If any ID isn't a fault in this project, nothing changes. Omit to act on everything the query and time filters match; with no filters, that requires "all": true. Example: ["103547218", "103547219"]
occurred_afternumber- Only faults that occurred after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
occurred_beforenumber- Only faults that occurred before this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1731024000.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_faults_resolveMark faults as resolved, by fault_ids or by an error search query and time filters, or every fault with all true.WriteResolve Faults
Mark faults as resolved, by fault_ids or by an error search query and time filters, or every fault with all true. Returns the number of faults changed; with dry_run true it reports what would change without changing it. Use honeybadger_fault_update for a single fault. Use honeybadger_faults_unresolve to reopen.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
allboolean- Apply to every fault the other filters match, which with no other filters is every fault in the project. Required to make an unbounded change explicit; ignored when fault_ids names specific faults. Example: false.
created_afternumber- Only faults created after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
dry_runboolean- Report what the request would change without changing it — no state change, no comments, no timeline entries. The response has the same shape either way, with dry_run echoed back. Example: false.
fault_idsarray- IDs of the faults to change. If any ID isn't a fault in this project, nothing changes. Omit to act on everything the query and time filters match; with no filters, that requires "all": true. Example: ["103547218", "103547219"]
occurred_afternumber- Only faults that occurred after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
occurred_beforenumber- Only faults that occurred before this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1731024000.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_faults_unignoreStop ignoring faults so Honeybadger records them again, by fault_ids, query and time filters, or all.WriteUnignore Faults
Stop ignoring faults so Honeybadger records them again, by fault_ids, query and time filters, or all. Returns the number of faults changed; dry_run true only reports. Use honeybadger_faults_ignore to ignore.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
allboolean- Apply to every fault the other filters match, which with no other filters is every fault in the project. Required to make an unbounded change explicit; ignored when fault_ids names specific faults. Example: false.
created_afternumber- Only faults created after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
dry_runboolean- Report what the request would change without changing it — no state change, no comments, no timeline entries. The response has the same shape either way, with dry_run echoed back. Example: false.
fault_idsarray- IDs of the faults to change. If any ID isn't a fault in this project, nothing changes. Omit to act on everything the query and time filters match; with no filters, that requires "all": true. Example: ["103547218", "103547219"]
occurred_afternumber- Only faults that occurred after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
occurred_beforenumber- Only faults that occurred before this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1731024000.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_faults_unresolveMark faults as unresolved, by fault_ids or by an error search query and time filters, or every fault with all true.WriteUnresolve Faults
Mark faults as unresolved, by fault_ids or by an error search query and time filters, or every fault with all true. Returns the number of faults changed; dry_run true only reports. Use honeybadger_faults_resolve to resolve.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
allboolean- Apply to every fault the other filters match, which with no other filters is every fault in the project. Required to make an unbounded change explicit; ignored when fault_ids names specific faults. Example: false.
created_afternumber- Only faults created after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
dry_runboolean- Report what the request would change without changing it — no state change, no comments, no timeline entries. The response has the same shape either way, with dry_run echoed back. Example: false.
fault_idsarray- IDs of the faults to change. If any ID isn't a fault in this project, nothing changes. Omit to act on everything the query and time filters match; with no filters, that requires "all": true. Example: ["103547218", "103547219"]
occurred_afternumber- Only faults that occurred after this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1730419200.
occurred_beforenumber- Only faults that occurred before this Unix timestamp. Applied when fault_ids is omitted, alongside q. Example: 1731024000.
qstring- Error search query in the syntax of Honeybadger's web UI, such as environment:production, is:resolved or class:ArgumentError. Prefix a filter with - to negate it. Example: environment:production -is:resolved.
honeybadger_project_createCreate a new Honeybadger project in the account.WriteCreate Project
Create a new Honeybadger project in the account. Returns the created project with its id and API key details. Requires a token with projects:write.
Inputs
namestringrequired- Project name. Example: Billing API.
asana_workspace_idstring- Asana workspace used by the project's Asana integration. Null clears it. Example: 1203456789012345.
customer_throttleinteger- Notices accepted per minute before throttling kicks in. Null clears it. Example: 100.
disable_email_notificationsboolean- Create-only. Members added with the project get email notifications switched off. Not stored or returned. Example: true.
disable_public_linksboolean- Disallow shareable public fault links. Null resets it to false. Example: true.
languagestring- Primary language, used to format backtraces. Null clears it. Example: ruby.
purge_daysinteger- Days to retain notices. Changing it requires custom retention on the account; without it, only the current value (on create, the default) is accepted. Null clears it. Example: 90.
resolve_errors_on_deployboolean- Resolve every open fault when a deploy is recorded. Null resets it to true. Example: true.
source_urlstring- Template for linking a backtrace line to your source host. [file] and [line] are substituted. Null clears it. Example: https://github.com/acme/billing/blob/main/[file]#L[line]
team_idstring- Puts the new project in this team. Create-only: afterwards the team's project_ids owns membership. Including it requires team:write in addition to the operation's project scope, and the user must be allowed to manage the team. Without team:write the entire request is rejected with 403 insufficient_scope; no other fields are saved. Example: Tm4rWx.
user_search_fieldstring- Context key identifying the affected user, for when it is not in the default context.user_email or context.user_id. Null clears it. Example: context.account_email.
user_urlstring- Template for linking a fault's affected user into your own system. [user_id] and [user_email] are substituted. Null clears it. Example: https://admin.example.com/users/[user_id]
honeybadger_project_updateUpdate a project's settings; send only the fields to change.WriteUpdate Project
Update a project's settings; send only the fields to change. Returns the updated project. Null clears or resets a nullable setting.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
asana_workspace_idstring- Asana workspace used by the project's Asana integration. Null clears it. Example: 1203456789012345.
customer_throttleinteger- Notices accepted per minute before throttling kicks in. Null clears it. Example: 100.
disable_public_linksboolean- Disallow shareable public fault links. Null resets it to false. Example: true.
languagestring- Primary language, used to format backtraces. Null clears it. Example: ruby.
namestring- Project name. Example: Billing API.
purge_daysinteger- Days to retain notices. Changing it requires custom retention on the account; without it, only the current value (on create, the default) is accepted. Null clears it. Example: 90.
resolve_errors_on_deployboolean- Resolve every open fault when a deploy is recorded. Null resets it to true. Example: true.
source_urlstring- Template for linking a backtrace line to your source host. [file] and [line] are substituted. Null clears it. Example: https://github.com/acme/billing/blob/main/[file]#L[line]
user_search_fieldstring- Context key identifying the affected user, for when it is not in the default context.user_email or context.user_id. Null clears it. Example: context.account_email.
user_urlstring- Template for linking a fault's affected user into your own system. [user_id] and [user_email] are substituted. Null clears it. Example: https://admin.example.com/users/[user_id]
honeybadger_site_createCreate an uptime monitoring site that checks a URL from several locations on a schedule.WriteCreate Uptime Site
Create an uptime monitoring site that checks a URL from several locations on a schedule. Returns the created site with its id. Requires uptime monitoring on the Honeybadger plan.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
urlstringrequired- Must start with http:// or https://, with no surrounding whitespace. Example: https://www.example.com/health.
activeboolean- Whether monitoring is active. After 740 consecutive failed checks the server sets it to false. Null resets it to true. Example: true.
frequencyinteger- Minutes between checks. The plan sets the most frequent allowed. Null resets it to 5. Example: 1.one of
12515 locationsarray- A set of location names to check from. Null or empty means every location. A set; order is ignored and duplicates are dropped. Example: ["Virginia", "Frankfurt"]
matchstring- What match_type compares against. Required unless match_type is success, and must be left out with success. Example: ok.
match_typestring- How a check decides the site is up: success (any 2xx; leave match out), exact (status code equals match), include or exclude (body does or doesn't contain match), or jmespath (match is a JMESPath expression on the JSON body). Defaults to success. Example: success.one of
successexactincludeexcludejmespath namestring- Name shown for the site in Honeybadger and on status pages. Example: Billing API.
outage_thresholdinteger- Consecutive failures before an outage is declared. null means down once failures reach 50% of locations. Example: 10.
request_bodystring- Body to send with the request, up to 32 KB. Null clears it. Example: {"ping": true}
request_headersobject- Headers to send with the request, as header name to value. Replaces the stored headers; null or {} clears them. Example: {"X-Health-Check": "honeybadger"}
request_methodstring- HTTP method each check sends. Null resets it to GET. Example: GET.one of
GETPOSTPUTPATCHDELETE timeoutinteger- Request timeout in seconds, 1 to 120, default 30, and less than the frequency in seconds. Changing it requires the uptime timeout feature on the account; without it, only the current value (on create, the default) is accepted. Null resets it to the default. Example: 10.
validate_sslboolean- Fail the check when the TLS certificate does not validate. Null resets it to true. Example: true.
honeybadger_site_updateUpdate an uptime monitoring site; send only the fields to change, such as active false to pause it.WriteUpdate Uptime Site
Update an uptime monitoring site; send only the fields to change, such as active false to pause it. Returns the updated site. Use honeybadger_site_get to read the current settings.
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
site_idstringrequired- UUID of the uptime monitoring site. Get it from honeybadger_sites_list. Example: 9f8b6d2e-4c1a-4b7f-9e35-2a6c8d0f1b47.
activeboolean- Whether monitoring is active. After 740 consecutive failed checks the server sets it to false. Null resets it to true. Example: true.
frequencyinteger- Minutes between checks. The plan sets the most frequent allowed. Null resets it to 5. Example: 1.one of
12515 locationsarray- A set of location names to check from. Null or empty means every location. A set; order is ignored and duplicates are dropped. Example: ["Virginia", "Frankfurt"]
matchstring- What match_type compares against. Required unless match_type is success, and must be left out with success. Example: ok.
match_typestring- How a check decides the site is up: success (any 2xx; leave match out), exact (status code equals match), include or exclude (body does or doesn't contain match), or jmespath (match is a JMESPath expression on the JSON body). Defaults to success. Example: success.one of
successexactincludeexcludejmespath namestring- Name shown for the site in Honeybadger and on status pages. Example: Billing API.
outage_thresholdinteger- Consecutive failures before an outage is declared. null means down once failures reach 50% of locations. Example: 10.
request_bodystring- Body to send with the request, up to 32 KB. Null clears it. Example: {"ping": true}
request_headersobject- Headers to send with the request, as header name to value. Replaces the stored headers; null or {} clears them. Example: {"X-Health-Check": "honeybadger"}
request_methodstring- HTTP method each check sends. Null resets it to GET. Example: GET.one of
GETPOSTPUTPATCHDELETE timeoutinteger- Request timeout in seconds, 1 to 120, default 30, and less than the frequency in seconds. Changing it requires the uptime timeout feature on the account; without it, only the current value (on create, the default) is accepted. Null resets it to the default. Example: 10.
urlstring- Must start with http:// or https://, with no surrounding whitespace. Example: https://www.example.com/health.
validate_sslboolean- Fail the check when the TLS certificate does not validate. Null resets it to true. Example: true.
honeybadger_status_page_incident_createOpen an incident on a status page with at least one update carrying its message, status and severity.WriteCreate Status Page Incident
Open an incident on a status page with at least one update carrying its message, status and severity. Returns the created incident with its updates. Updates with should_notify true email the page's subscribers. Use build_type scheduled_maintenance for planned work.
Inputs
status_page_idstringrequired- ID of the status page. Get it from honeybadger_status_pages_list. Example: Sp7bMq.
titlestringrequired- Incident title shown on the status page. Example: Elevated error rates.
updatesarrayrequired- Updates to open the incident with; at least one. Each update has a message, a status (such as investigating, identified, monitoring or resolved, or maintenance_scheduled for planned work), a severity (problem_detected, degraded_performance, partial_outage, outage or operational), and optional start_at, start_now and should_notify (true emails the page's subscribers). Example: [{"status": "investigating", "severity": "partial_outage", "message": "Some requests to the API are failing. We're looking into it."}]
build_typestring- How the incident was opened. current is happening now, retroactive records something already over, scheduled_maintenance is planned. Only a scheduled_maintenance incident may have updates starting in the future. Example: current.one of
currentretroactivescheduled_maintenance retro_notify_messagestring- Message accompanying that announcement. Example: We had a brief API outage earlier today; it is resolved.
retro_should_notifyboolean- Announce a retroactive incident when it is created. Example: true.
honeybadger_status_page_incident_update_createPost a new update to a status page incident, such as moving it to identified, monitoring or resolved.WritePost Incident Update
Post a new update to a status page incident, such as moving it to identified, monitoring or resolved. Returns the created update. Set status resolved and severity operational to close the incident.
Inputs
incident_idstringrequired- ID of the status page incident. Get it from honeybadger_status_page_incidents_list. Example: In3pKr.
status_page_idstringrequired- ID of the status page. Get it from honeybadger_status_pages_list. Example: Sp7bMq.
messagestring- The update's prose. Example: We have identified the cause and are rolling back.
severitystring- Incident severity after this update. Example: problem_detected.one of
problem_detecteddegraded_performancepartial_outageoutageoperational should_notifyboolean- Announce the update on the status page's connected accounts and email the status page's subscribers. Example: true.
start_atstring- When the update takes effect. Only a scheduled_maintenance incident may set this in the future. Example: 2026-11-20T02:00:00Z.
start_nowboolean- Start the update immediately, ignoring start_at. An update that has already started is left as it is, so sending it again changes nothing. Example: true.
statusstring- Incident status after this update. Example: maintenance_scheduled.one of
maintenance_scheduledin_maintenancemaintenance_completeinvestigatingidentifiedresolvingmonitoringresolved
honeybadger_check_in_deleteDelete a check-in monitor.DestructiveDelete Check-In
Delete a check-in monitor. Returns no content on success. Jobs reporting to it will get errors afterwards.
- Idempotent
Inputs
check_in_idstringrequired- ID of the check-in monitor. Get it from honeybadger_check_ins_list. Example: Ci5xWq.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_comment_deleteDelete a comment from a fault.DestructiveDelete Fault Comment
Delete a comment from a fault. Returns no content on success. Use honeybadger_fault_comments_list to find the comment ID.
- Idempotent
Inputs
comment_idstringrequired- ID of the comment on the fault. Get it from honeybadger_fault_comments_list. Example: Cm4vRt.
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_deletePermanently delete a fault.DestructiveDelete Fault
Permanently delete a fault. Its notices stay retrievable by ID until retention removes them. Returns no content on success. Use honeybadger_fault_update with ignored true to stop tracking without deleting.
- Idempotent
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
honeybadger_fault_mergeMerge the fault in the path into target_fault_id, moving its notices, comments and history; its tags, assignee and state are dropped.DestructiveMerge Fault
Merge the fault in the path into target_fault_id, moving its notices, comments and history; its tags, assignee and state are dropped. Returns 202 Accepted; the merge runs in the background, then the old fault ID redirects to the target. Use this for duplicate faults. It cannot be undone.
Inputs
fault_idstringrequired- ID of the fault (error group), a number sent as a string. Get it from honeybadger_faults_list. Example: 103547218.
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
target_fault_idstringrequired- ID of the fault to keep. The fault in the path is merged into it. Example: 103547219.
honeybadger_site_deleteDelete an uptime monitoring site and its check history.DestructiveDelete Uptime Site
Delete an uptime monitoring site and its check history. Returns no content on success. Use honeybadger_site_update with active false to pause instead.
- Idempotent
Inputs
project_idstringrequired- ID of the Honeybadger project, such as Xk9mZp. Get it from honeybadger_projects_list. Example: Xk9mZp.
site_idstringrequired- UUID of the uptime monitoring site. Get it from honeybadger_sites_list. Example: 9f8b6d2e-4c1a-4b7f-9e35-2a6c8d0f1b47.
No tools match.