Skip to content

Incident Management · Beta

FireHydrant
API integration

Ship Incident Management features without building the integration. Full FireHydrant API access via Proxy and 430+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Built for specific customer use cases. Issues are resolved quickly.

Talk to us
FireHydrant

Use Cases

Why integrate with FireHydrant

Common scenarios for SaaS companies building FireHydrant integrations for their customers.

01

Give CI/CD users instant incident context

Deployment platforms and feature flag tools can push every release into FireHydrant as a change event, so when an incident fires minutes later, responders immediately see the suspect deploy on the timeline. This is the fastest way for your users to correlate your product's activity with production outages.

02

Turn observability alerts into orchestrated incidents

APM, error tracking, and security tools can forward anomaly signals into FireHydrant to automatically page on-call, declare incidents, and trigger runbooks. Your users stop juggling alert routing and get a single incident response surface tied to your detection data.

03

Bridge customer support with engineering outages

Helpdesks and CRMs can poll active incidents and surface 'Severity 1' banners to support agents, then attach customer reports back to the FireHydrant incident as notes or tickets. This eliminates the gap between what engineering is fighting and what customers are hearing.

04

Sync service catalogs and architecture metadata

Internal developer platforms and infrastructure tools can push services, environments, functionalities, and dependencies into FireHydrant's catalog so incidents are always tagged with accurate ownership and impact. Your users stop maintaining two sources of truth for their architecture.

05

Power engineering analytics with reliability data

Engineering management and BI tools can pull incident metrics, shift analytics, and user involvement data to quantify on-call fatigue, MTTX trends, and operational load. Your users get a complete picture of developer productivity alongside reliability outcomes.

What You Can Build

Ship these features with Truto + FireHydrant

Concrete product features your team can ship faster by leveraging Truto’s FireHydrant integration instead of building from scratch.

01

Deployment-to-incident change event stream

Automatically create FireHydrant change events for every deploy, config change, or feature flag flip in your product, complete with commit hashes, authors, and impacted services.

02

Automated incident declaration from alerts

Forward signals from your detection pipeline into FireHydrant, escalate critical ones into incidents, and dynamically attach impacted services as the blast radius evolves.

03

Active incident banners in your UI

List active FireHydrant incidents filtered by severity and surface them in your support agent or developer dashboards, with one-click linking to attach customer reports or tickets.

04

Two-way service catalog sync

Push services, functionalities, environments, and dependencies from your platform into FireHydrant's catalog and keep them updated as your users' architecture evolves.

05

Runbook execution triggers

Let your users kick off predefined FireHydrant runbooks from inside your product when specific events occur, automating Slack channel creation, paging, and stakeholder notifications.

06

Reliability metrics and on-call analytics

Pull incident metrics, milestone funnels, shift analytics, and user involvement data to build dashboards that quantify MTTR, on-call load, and reliability trends inside your product.

SuperAI

FireHydrant AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

create_a_fire_hydrant_change_event

Create a new change event in FireHydrant to record a system change such as a deployment or configuration update. Returns the created event including id, summary, starts_at, ends_at, environments, services, labels, and identities. Required: summary.

delete_a_fire_hydrant_change_event_by_id

Delete a FireHydrant change event by id. Returns an empty 204 response on success.

get_single_fire_hydrant_change_event_by_id

Get a single FireHydrant change event by id. Returns the full event object including id, summary, description, starts_at, ends_at, environments, services, labels, identities, authors, attachments, and related_changes. Required: id.

list_all_fire_hydrant_change_events

List change events for the FireHydrant organization. Returns: id, summary, starts_at, ends_at, environments, services, labels, identities. Note: attachments and related_changes are not included in list responses — fetch an individual event by id for complete detail.

update_a_fire_hydrant_change_event_by_id

Update an existing FireHydrant change event by id. Returns the updated event including id, summary, description, starts_at, ends_at, environments, services, labels, and identities. Required: id.

delete_a_fire_hydrant_incident_by_id

Archive a FireHydrant incident by id, hiding it from the UI and excluding it from analytics and metrics calculations. Returns an empty 204 response on success. Required: id.

create_a_fire_hydrant_incident

Create a new FireHydrant incident. Returns: id, name, current_milestone, number, priority, severity, active, created_at, services, environments, and other incident fields. Required: name. To create a retroactive resolved incident, include milestones with 'started' and 'resolved' types and their occurred_at timestamps.

update_a_fire_hydrant_incident_by_id

Update a FireHydrant incident by id. Returns: id, name, current_milestone, number, priority, severity, active, summary, description, customers_impacted, and other incident fields. Required: id.

get_single_fire_hydrant_incident_by_id

Get a single FireHydrant incident by id. Returns: id, name, current_milestone, number, priority, severity, active, created_at, services, environments, role_assignments, and other incident fields. Required: id.

list_all_fire_hydrant_incidents

List FireHydrant incidents. Returns per incident: id, name, current_milestone, number, priority, severity, active, created_at, services, environments, and other incident fields.

get_single_fire_hydrant_ai_preference_by_id

Get the current AI preferences for a FireHydrant account. Returns: ai, summaries, description, impact, updates, retros, followups, similar_incidents, similar_incidents_cooldown_minutes, similar_incidents_max_per_incident, and conference_bridge_summary_min_interval_minutes.

update_a_fire_hydrant_ai_preference_by_id

Update AI preferences for a FireHydrant account. Returns the updated preferences object including ai, summaries, description, impact, updates, retros, followups, similar_incidents, similar_incidents_cooldown_minutes, similar_incidents_max_per_incident, and conference_bridge_summary_min_interval_minutes. All body fields are optional.

get_single_fire_hydrant_bootstrap_by_id

Get the initial application configuration for FireHydrant. Returns: posthog_write_key.

list_all_fire_hydrant_entitlements

List entitlements for your FireHydrant organization. Returns: name, slug, tier, available, maximum, current_count, exists, and errors for each entitlement. Optionally filter by entitlement name or type.

get_single_fire_hydrant_connectivity_by_id

Check FireHydrant API connectivity to verify your connection is working. Returns: response (confirmation string), actor (id, name, email, type of the authenticated actor), and organization (id, name). Takes no required parameters.

get_single_fire_hydrant_ping_by_id

Check API connectivity in FireHydrant. Returns: response, actor (with id, name, email, and type), and organization (with id and name), confirming the connection is active and identifying the authenticated bot or user.

create_a_fire_hydrant_incident_alert

Attach one or more pre-ingested alerts to a FireHydrant incident by supplying an array of alert IDs. The alerts must have already been ingested by FireHydrant from a third-party system before they can be attached. Returns an empty 204 response on success. Required: incident_id.

delete_a_fire_hydrant_incident_alert_by_id

Remove an alert from a FireHydrant incident. Returns an empty 204 response on success. Required: incident_id, id.

list_all_fire_hydrant_incident_alerts

List all alerts attached to a FireHydrant incident. Returns each incident-alert record including id, primary (whether the alert is the primary for the incident), and a nested alert object containing summary, status, priority, integration_name, starts_at, ends_at, remote_id, labels, services, tags, and more. Required: incident_id.

update_a_fire_hydrant_incident_alert_by_id

Set an alert as the primary alert for a FireHydrant incident. This overwrites the incident's milestone times with those from the primary alert and automatically adds the alert's services to the incident. Returns: id, primary, and a nested alert object including summary, status, priority, integration_name, starts_at, and ends_at. Required: incident_id, id.

get_single_fire_hydrant_alert_by_id

Get a single FireHydrant alert by id. Returns the full alert object including id, summary, description, status, priority, starts_at, ends_at, integration_name, team_id, incidents, events, is_expired, and is_noise. Required: id.

list_all_fire_hydrant_alerts

List all FireHydrant alerts, including Signals alerts and third-party alerts. Returns alert objects with id, summary, description, status, priority, starts_at, ends_at, team_id, incidents, is_expired, and is_noise. Optionally filter by query text, teams, services, statuses, tags, tag_match_strategy, start_date, and end_date.

list_all_fire_hydrant_processing_log_entries

List processing log entries for a specific alert in FireHydrant. Returns: id, level, message, message_type, context, created_at. Required: alert_id. Optionally filter by integration_slug, connection_id, of_level, or exact_level.

update_a_fire_hydrant_signals_alert_by_id

Update a FireHydrant Signal alert by id. Returns: id, summary, is_noise. Required: id, noise.

delete_a_fire_hydrant_audience_by_id

Archive a FireHydrant audience by id, soft-deleting it from the organization. Returns an empty 204 response on success. Required: id.

create_a_fire_hydrant_audience

Create a new audience in FireHydrant. Returns the created audience including id, name, slug, description, default, created_at, updated_at, discarded_at, and details. Required: name, description.

get_single_fire_hydrant_audience_by_id

Get a FireHydrant audience by id. Returns the audience object including id, name, slug, description, default, created_at, updated_at, discarded_at, and details. Required: id.

list_all_fire_hydrant_audiences

List all audiences in FireHydrant. Returns per record: id, name, slug, description, default, created_at, updated_at, discarded_at, and details.

update_a_fire_hydrant_audience_by_id

Update an existing FireHydrant audience by id. Returns the updated audience including id, name, slug, description, default, created_at, updated_at, discarded_at, and details. Required: id.

create_a_fire_hydrant_audience_summary

Initiate asynchronous generation of a new audience-specific incident summary in FireHydrant. The operation can take up to 60 seconds to complete; poll the GET endpoint to retrieve the result. Returns an empty 202 response on success. Required: audience_id, incident_id.

get_single_fire_hydrant_audience_summary_by_id

Get the latest audience-specific incident summary in FireHydrant by id. Returns: id, content, source_hash, type, created_at, incident_updated_at. Required: id.

list_all_fire_hydrant_audience_summaries

List all audience summaries for an incident in FireHydrant. Returns: incident_id, audiences (a JSON-encoded map of audience summaries keyed by audience identifier). Required: incident_id.

get_single_fire_hydrant_audit_event_by_id

Get a single FireHydrant audit event by id. Returns: id, parent_id, event (including key, occurred_at, and actor details), and resource (kind, id, response). Required: id.

list_all_fire_hydrant_audit_events

List FireHydrant audit events with optional filtering. Returns: id, parent_id, event (key, occurred_at, actor), and resource (kind, id, response) per record. Use the filter parameter to narrow results by event key, actor kind/id, resource kind/id, occurrence time, response status, or parent_id.

create_a_fire_hydrant_team_call_route

Create a call route for a team in FireHydrant. Returns: id, name, phone_number, routing_mode, connect_mode, description, greeting_message, steps, and target. Required: team_id, name, phone_number, routing_mode.

delete_a_fire_hydrant_call_route_by_id

Delete a FireHydrant call route by id. Returns an empty 204 response on success.

get_single_fire_hydrant_call_route_by_id

Get a single FireHydrant call route by id. Returns the full call route object including id, name, phone_number, routing_mode, connect_mode, greeting_message, description, steps, and target.

list_all_fire_hydrant_call_routes

List all FireHydrant call routes for the organization. Returns each call route's id, name, phone_number, routing_mode, connect_mode, greeting_message, description, steps, and target.

update_a_fire_hydrant_call_route_by_id

Update a FireHydrant call route by id. Returns the updated call route including id, name, phone_number, routing_mode, connect_mode, greeting_message, description, steps, and target. Required: id.

create_a_fire_hydrant_environment

Create a new environment in FireHydrant for the organization. Returns: id, name, slug, description, created_at, updated_at, active_incidents, functionalities, and services. Required: name.

delete_a_fire_hydrant_environment_by_id

Archive a FireHydrant environment by id. Returns an empty 204 response on success.

get_single_fire_hydrant_environment_by_id

Get a single FireHydrant environment by id. Returns: id, name, slug, description, created_at, updated_at, active_incidents, functionalities, and services. Required: id.

list_all_fire_hydrant_environments

List all environments added to the FireHydrant organization. Returns per record: id, name, slug, description, created_at, updated_at, active_incidents, functionalities, and services.

update_a_fire_hydrant_environment_by_id

Update an existing FireHydrant environment by id. Returns: id, name, slug, description, created_at, updated_at, active_incidents, functionalities, and services. Required: id.

create_a_fire_hydrant_functionality

Create a new functionality in FireHydrant for the organization. Returns the created functionality including id, name, slug, description, created_at, updated_at, service_tier, labels, active_incidents, owner, services, environments, external_resources, and teams. Required: name.

delete_a_fire_hydrant_functionality_by_id

Archive a FireHydrant functionality by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_functionality_by_id

Get a single FireHydrant functionality by id (UUID or slug). Returns: id, name, slug, description, created_at, updated_at, service_tier, labels, active_incidents, owner, services, environments, external_resources, and teams. Required: id.

list_all_fire_hydrant_functionalities

List all functionalities in the FireHydrant organization. Returns: id, name, slug, description, created_at, updated_at, service_tier, labels, active_incidents, owner, services, environments, external_resources, and teams.

update_a_fire_hydrant_functionality_by_id

Update an existing FireHydrant functionality by id using a partial update. Returns: id, name, slug, description, created_at, updated_at, service_tier, labels, active_incidents, owner, services, environments, external_resources, and teams. Required: id.

create_a_fire_hydrant_service_checklist_response

Record a response for a checklist item in FireHydrant for a given service and checklist. Required: service_id, checklist_id, check_id, and status. Returns an empty 201 response on success.

create_a_fire_hydrant_service_dependency

Create a service dependency relationship between two services in FireHydrant. Returns: id, notes, created_at, updated_at, service, connected_service. Required: service_id, connected_service_id.

delete_a_fire_hydrant_service_dependency_by_id

Delete a FireHydrant service dependency by id. Returns an empty 204 response on success. Required: id.

list_all_fire_hydrant_service_dependencies

List all dependencies for a FireHydrant service. Returns: id, notes, created_at, updated_at, service, connected_service per dependency record. Required: service_id.

get_single_fire_hydrant_service_dependency_by_id

Get a single FireHydrant service dependency by id. Returns: id, notes, created_at, updated_at, service, connected_service. Required: id.

update_a_fire_hydrant_service_dependency_by_id

Update a FireHydrant service dependency by id. Returns: id, notes, created_at, updated_at, service, connected_service. Required: id.

create_a_fire_hydrant_service_link

Create multiple FireHydrant services linked to external services by supplying one or more external service IDs. Returns an array of service link objects, each containing status_code and a full nested service object with id, name, slug, created_at, and additional service details. Required: external_service_ids, connection_id, integration.

delete_a_fire_hydrant_service_link_by_id

Delete a service link from FireHydrant by service and link ID. Returns an empty 204 response on success. Required: service_id, id.

create_a_fire_hydrant_service

Create a new service in FireHydrant for the organization, optionally creating or attaching functionalities and environments on creation. Returns: id, name, slug, service_tier, created_at, updated_at, active_incidents, functionalities, environments, teams, owner, labels, and links. Required: name.

delete_a_fire_hydrant_service_by_id

Delete a FireHydrant service by id, permanently removing it from the organization. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_service_by_id

Get a single FireHydrant service by id. Returns: id, name, slug, description, service_tier, labels, created_at, updated_at, active_incidents, checklists, functionalities, environments, external_resources, links, owner, teams, managed_by, and updated_by. Required: id.

list_all_fire_hydrant_services

List all FireHydrant services in the organization. Returns an array of service records, each with id, name, slug, description, service_tier, labels, created_at, updated_at, active_incidents, functionalities, environments, external_resources, links, teams, and owner.

update_a_fire_hydrant_service_by_id

Update an existing FireHydrant service by id using partial field updates. Returns the updated service object including id, name, slug, service_tier, description, labels, updated_at, active_incidents, functionalities, environments, teams, owner, links, and managed_by. Required: id.

create_a_fire_hydrant_catalog

Ingest service catalog data into a FireHydrant catalog by submitting content in JSON or YAML format; the data is processed asynchronously to incorporate changes into the service catalog. Returns: state, updated_at. Required: catalog_id, encoding, data.

update_a_fire_hydrant_catalog_by_id

Refresh a FireHydrant service catalog by scheduling an async task to re-import catalog info and update catalog data accordingly. Returns an empty response on success. Required: catalog_id.

list_all_fire_hydrant_environment_functionalities

List functionalities associated with a specific FireHydrant environment. Returns: id, name, slug, description, created_at, updated_at, service_tier, labels, active_incidents, owner, links, alert_on_add, auto_add_responding_team, and updated_by. Required: environment_id.

list_all_fire_hydrant_environment_services

List services associated with a FireHydrant environment. Returns: id, name, slug, service_tier, description, created_at, updated_at, labels, allowed_params, alert_on_add, and auto_add_responding_team for each service. Required: environment_id.

list_all_fire_hydrant_functionality_environments

List environments associated with a functionality in FireHydrant. Returns: id, name, slug, description, created_at, updated_at, active_incidents, external_resources, functionalities, and services for each environment record. Required: functionality_id.

list_all_fire_hydrant_functionality_services

List services associated with a FireHydrant functionality. Returns: id, name, slug, description, service_tier, created_at, updated_at, active_incidents, functionalities, environments, teams, owner, links, and external_resources for each service. Required: functionality_id.

list_all_fire_hydrant_infrastructures

List functionality, service, and environment objects in FireHydrant. Returns: type, infrastructure. Optionally filter results by name (query), restrict to a given infrastructure type (type), or omit infrastructures already attached to a specific incident (omit_for).

list_all_fire_hydrant_service_environments

List environments associated with a specific service in FireHydrant. Returns: id, name, slug, description, created_at, updated_at, active_incidents, functionalities, external_resources, and services for each environment. Required: service_id.

create_a_fire_hydrant_change_identity

Create an identity for a FireHydrant change entry. Returns: id, type, value, change_id, created_at, updated_at. Required: change_id, type, value.

delete_a_fire_hydrant_change_identity_by_id

Delete an identity from a FireHydrant change entry by id. Returns an empty 204 response on success. Required: change_id, id.

list_all_fire_hydrant_change_identities

List all identities for a FireHydrant change entry. Returns: id, type, value, change_id, created_at, updated_at. Required: change_id.

update_a_fire_hydrant_change_identity_by_id

Update an identity for a FireHydrant change entry by id. Returns: id, type, value, change_id, created_at, updated_at. Required: change_id, id, type, value.

create_a_fire_hydrant_change

Create a new change entry in FireHydrant. Returns the created change object including its id, summary, description, labels, created_at, and updated_at. All body fields are optional.

delete_a_fire_hydrant_change_by_id

Archive a FireHydrant change entry by id. Returns an empty 204 response on success. Required: id.

list_all_fire_hydrant_changes

List change entries for the FireHydrant organization. Returns a collection of change records each including id, summary, description, labels, created_at, and updated_at. Optionally filter by summary text using the query parameter.

update_a_fire_hydrant_change_by_id

Update an existing FireHydrant change entry by id. Returns the updated change object including its id, summary, description, labels, created_at, and updated_at. Required: id.

list_all_fire_hydrant_change_types

List change types for the FireHydrant organization. Returns: id, name.

create_a_fire_hydrant_status_update_template

Create a status update template in FireHydrant for your organization. Returns: id, name, body, created_at, updated_at, discarded_at. Required: name, body.

delete_a_fire_hydrant_status_update_template_by_id

Delete a single FireHydrant status update template by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_status_update_template_by_id

Get a single FireHydrant status update template by id. Returns: id, name, body, created_at, updated_at, discarded_at. Required: id.

list_all_fire_hydrant_status_update_templates

List all FireHydrant status update templates for your organization. Returns: id, name, body, created_at, updated_at, discarded_at.

update_a_fire_hydrant_status_update_template_by_id

Update a single FireHydrant status update template by id. Returns: id, name, body, created_at, updated_at, discarded_at. Required: id.

create_a_fire_hydrant_comment_reaction

Create a reaction on a FireHydrant conversation comment. Returns: id, reaction. Required: conversation_id, comment_id, reaction.

delete_a_fire_hydrant_comment_reaction_by_id

Delete a reaction from a FireHydrant conversation comment by id. Returns an empty 204 response on success. Required: conversation_id, comment_id, id.

list_all_fire_hydrant_comment_reactions

List all reactions added to a FireHydrant conversation comment. Returns: id, reaction. Required: conversation_id, comment_id.

create_a_fire_hydrant_conversation_comment

Create a comment on a FireHydrant conversation. Returns the created comment including id, body, and created_at. Required: conversation_id, body.

delete_a_fire_hydrant_conversation_comment_by_id

Archive a FireHydrant conversation comment by id. Returns an empty 204 response on success. Required: conversation_id, id.

get_single_fire_hydrant_conversation_comment_by_id

Get a single FireHydrant conversation comment by id. Returns the comment object including id, body, and created_at. Required: conversation_id, id.

list_all_fire_hydrant_conversation_comments

List all comments for a FireHydrant conversation. Returns comment records each with id, body, and created_at. Required: conversation_id.

update_a_fire_hydrant_conversation_comment_by_id

Update the body of a FireHydrant conversation comment. Returns the updated comment object including id, body, and created_at. Required: conversation_id, id.

get_single_fire_hydrant_event_vote_by_id

Get the current vote counts for a FireHydrant conversation event by id. Returns: voted, liked, disliked, likes, dislikes. Required: id.

update_a_fire_hydrant_event_vote_by_id

Upvote, downvote, or "dig" a FireHydrant conversation event by id. Returns: voted, liked, disliked, likes, dislikes. Required: id, direction.

get_single_fire_hydrant_form_configuration_by_id

Get a FireHydrant form configuration by id. Returns the form configuration object including its id, slug, and template. Required: id.

create_a_fire_hydrant_custom_field_definition

Create a new custom field definition in FireHydrant. Returns: field_id, display_name, field_type, slug, description, required, required_at_milestone_id, and permissible_values. Required: display_name, field_type.

delete_a_fire_hydrant_custom_field_definition_by_id

Delete a custom field definition in FireHydrant by id. Returns an empty 204 response on success. Required: id.

list_all_fire_hydrant_custom_field_definitions

List all custom field definitions in FireHydrant. Returns: field_id, display_name, field_type, slug, description, required, required_at_milestone_id, and permissible_values.

update_a_fire_hydrant_custom_field_definition_by_id

Update a single custom field definition in FireHydrant by id. Returns: field_id, display_name, field_type, slug, description, required, required_at_milestone_id, and permissible_values. Required: id.

create_a_fire_hydrant_incident_role

Create a new incident role in FireHydrant. Returns: id, name, summary, description, created_at, updated_at, discarded_at. Required: name, summary.

delete_a_fire_hydrant_incident_role_by_id

Archive a FireHydrant incident role by id, hiding it from lists and metrics. Returns an empty 204 response on success.

get_single_fire_hydrant_incident_role_by_id

Get a single FireHydrant incident role by id. Returns: id, name, summary, description, created_at, updated_at, discarded_at.

list_all_fire_hydrant_incident_roles

List all incident roles in the FireHydrant organization. Returns: id, name, summary, description, created_at, updated_at, discarded_at for each role.

update_a_fire_hydrant_incident_role_by_id

Update a FireHydrant incident role by id. Returns: id, name, summary, description, created_at, updated_at, discarded_at.

create_a_fire_hydrant_incident_type

Create a new incident type in FireHydrant. Returns: id, name, description, template, allowed_role_ids, required_fields, created_at, updated_at. Required: name, template.

delete_a_fire_hydrant_incident_type_by_id

Archive a FireHydrant incident type by id, hiding it from lists and metrics. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_incident_type_by_id

Get a single FireHydrant incident type by id. Returns: id, name, description, template, allowed_role_ids, required_fields, created_at, updated_at. Required: id.

list_all_fire_hydrant_incident_types

List all incident types in the FireHydrant organization. Returns per record: id, name, description, template, allowed_role_ids, required_fields, created_at, updated_at.

update_a_fire_hydrant_incident_type_by_id

Update an existing FireHydrant incident type by id. Returns: id, name, description, template, allowed_role_ids, required_fields, created_at, updated_at. Required: id.

create_a_fire_hydrant_lifecycle_measurement_definition

Create a new measurement definition in FireHydrant. Returns: id, name, slug, description, starts_at_milestone_id, ends_at_milestone_id, created_at. Required: name, starts_at_milestone_id, ends_at_milestone_id.

delete_a_fire_hydrant_lifecycle_measurement_definition_by_id

Archive a measurement definition in FireHydrant by id, hiding it from lists and metrics. Returns an empty 204 response on success. Required: id.

list_all_fire_hydrant_lifecycle_measurement_definitions

List all measurement definitions in the FireHydrant organization. Returns: id, name, slug, description, starts_at_milestone_id, ends_at_milestone_id, created_at.

update_a_fire_hydrant_lifecycle_measurement_definition_by_id

Update a measurement definition in FireHydrant by id. Returns: id, name, slug, description, starts_at_milestone_id, ends_at_milestone_id, created_at. Required: id.

create_a_fire_hydrant_lifecycle_milestone

Create a new lifecycle milestone in FireHydrant under a specified phase. Returns: id, name, description, slug, position, auto_assign_timestamp_on_create, created_at, and updated_at. Required: phase_id, name, description.

delete_a_fire_hydrant_lifecycle_milestone_by_id

Delete a FireHydrant lifecycle milestone by id. Returns an empty 204 response on success. Required: id.

update_a_fire_hydrant_lifecycle_milestone_by_id

Update an existing FireHydrant lifecycle milestone by id. Returns: id, name, description, slug, position, auto_assign_timestamp_on_create, created_at, and updated_at. Required: id.

create_a_fire_hydrant_priority

Create a new priority in FireHydrant. Returns: slug, description, position, default, created_at, updated_at. Required: slug.

delete_a_fire_hydrant_priority_by_id

Delete a specific FireHydrant priority by id. Returns an empty 204 response on success.

get_single_fire_hydrant_priority_by_id

Get a specific FireHydrant priority by id. Returns: slug, description, position, default, created_at, updated_at. Required: id.

list_all_fire_hydrant_priorities

List all priorities in FireHydrant. Returns: slug, description, position, default, created_at, updated_at per record.

update_a_fire_hydrant_priority_by_id

Update a specific FireHydrant priority by id. Returns: slug, description, position, default, created_at, updated_at. Required: id.

create_a_fire_hydrant_severity_matrix_condition

Create a new severity matrix condition in FireHydrant. Returns: id, name, position. Required: name.

delete_a_fire_hydrant_severity_matrix_condition_by_id

Delete a specific severity matrix condition in FireHydrant by id. Returns an empty 204 response on success.

get_single_fire_hydrant_severity_matrix_condition_by_id

Get a specific severity matrix condition in FireHydrant by id. Returns: id, name, position.

list_all_fire_hydrant_severity_matrix_conditions

List all severity matrix conditions in FireHydrant. Returns: id, name, position for each condition.

update_a_fire_hydrant_severity_matrix_condition_by_id

Update a severity matrix condition in FireHydrant by id. Returns: id, name, position.

create_a_fire_hydrant_severity_matrix_impact

Create a new severity matrix impact in FireHydrant. Returns: id, name, type, affects_id, position. Required: affects_type, affects_id.

delete_a_fire_hydrant_severity_matrix_impact_by_id

Delete a FireHydrant severity matrix impact by id. Returns an empty 204 response on success. Required: id.

list_all_fire_hydrant_severity_matrix_impacts

List all severity matrix impacts in FireHydrant. Returns: id, name, type, affects_id, position.

update_a_fire_hydrant_severity_matrix_impact_by_id

Update a FireHydrant severity matrix impact by id. Returns: id, name, type, affects_id, position. Required: id.

create_a_fire_hydrant_severity

Create a new severity in FireHydrant. Returns the created severity object including slug, description, type, position, color, system_record, created_at, updated_at, and allowed_role_ids. Required: slug.

delete_a_fire_hydrant_severity_by_id

Delete a specific FireHydrant severity by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_severity_by_id

Get a specific FireHydrant severity by id. Returns the severity object including slug, description, type, position, color, system_record, created_at, updated_at, and allowed_role_ids. Required: id.

list_all_fire_hydrant_severities

List all severities configured in FireHydrant. Returns each severity's slug, description, type, position, color, system_record, created_at, updated_at, and allowed_role_ids.

update_a_fire_hydrant_severity_by_id

Update a specific FireHydrant severity by id. Returns the updated severity object including slug, description, type, position, color, system_record, created_at, updated_at, and allowed_role_ids. Required: id.

get_single_fire_hydrant_measurement_definition_by_id

Get a single measurement definition in FireHydrant by id. Returns: id. Required: id.

get_single_fire_hydrant_severity_matrix_by_id

Get the severity matrix for your FireHydrant organization, including all configured severities, impacts, and conditions. Returns: matrix (array of severity-to-condition-impact mappings, each with severity, condition_id, impact_id, impact_type), impacts (array with id, name, type, affects_id, position), and conditions (array with id, name, position).

list_all_fire_hydrant_custom_field_select_options

List the permissible select option values for a currently active custom select or multi-select field in FireHydrant. Returns: display_name, field_type, slug, description, required, required_at_milestone_id, and permissible_values (array of allowed string values). Required: field_id.

list_all_fire_hydrant_incident_tags

List all incident tags in the FireHydrant organization. Returns: name. Optionally filter results by a tag name prefix.

create_a_fire_hydrant_incident_tag

Validate the format of a list of incident tags in FireHydrant. Returns: name. Required: a JSON array of tag strings as the request body.

list_all_fire_hydrant_lifecycle_phases

List all lifecycle phases and milestones in a FireHydrant organization. Returns: id, name, description, type, position, and milestones (each milestone includes id, name, slug, position, created_at, and updated_at).

update_a_fire_hydrant_severity_matrix_by_id

Update available severities and impacts in your FireHydrant organization's severity matrix by mapping condition/impact pairs to severities. Returns: matrix (array of condition/impact/severity mappings), impacts (array of impact entities with id, name, type, position), and conditions (array of condition entities with id, name, position). Required: data.

fire_hydrant_incident_milestones_bulk_update

Update milestone times in bulk for a FireHydrant incident. Returns: data (array of updated milestone records), pagination. Required: incident_id, milestones. Returns 422 if the resulting milestone order would be non-chronological relative to any milestone on the incident.

list_all_fire_hydrant_incident_milestones

List milestone times and durations for a FireHydrant incident. Returns: id, type, duration, occurred_at, created_at, updated_at for each milestone. Required: incident_id.

create_a_fire_hydrant_incident_attachment

Add an image attachment to a FireHydrant incident timeline. Returns: file_name, file_content_type, signed_url, status, file_size, media_type, description, external_id, and versions. Required: incident_id, file.

list_all_fire_hydrant_incident_attachments

List attachments for a FireHydrant incident. Returns: id, type, attached_to_id, attached_to_type, created_at, and attributes per attachment record. Required: incident_id.

create_a_fire_hydrant_incident_change_event

Add a related change event to a FireHydrant incident, classifying it as a cause, fix, suspect, or dismissed entry. Returns: id, type, why, incident_id, change_event, created_at, created_by. Required: incident_id, change_event_id, type.

list_all_fire_hydrant_incident_change_events

List related change events attached to a FireHydrant incident. Returns: id, type, why, incident_id, change_event, created_at, created_by per item. Required: incident_id.

update_a_fire_hydrant_incident_change_event_by_id

Update a related change event on a FireHydrant incident, for example to change its relation type or reason. Returns: id, type, why, incident_id, change_event, created_at, created_by. Required: incident_id, id.

create_a_fire_hydrant_incident_chat_message

Add a generic chat message to a FireHydrant incident timeline, independent of any specific chat provider. Returns: id, body, created_at. Required: incident_id, body.

delete_a_fire_hydrant_incident_chat_message_by_id

Delete an existing generic chat message from a FireHydrant incident. Returns an empty 204 response on success. Required: incident_id, id.

update_a_fire_hydrant_incident_chat_message_by_id

Update an existing generic chat message on a FireHydrant incident. Returns: id, body, created_at. Required: incident_id, id, body.

create_a_fire_hydrant_incident_impact

Add impacted infrastructure to a FireHydrant incident. Returns: id, type, infrastructure. Required: incident_id, id.

list_all_fire_hydrant_incident_impacts

List all impacted infrastructure for a FireHydrant incident. Returns: id, type, infrastructure per impact record. Required: incident_id.

update_a_fire_hydrant_incident_impact_by_id

Update impacted infrastructure for a FireHydrant incident via PATCH (adds or updates impacts without removing existing ones), with options to transition the current milestone or add a note to the incident timeline and status pages. Returns the full incident object including id, name, current_milestone, severity, priority, active, impacts, services, environments, functionalities, and more. Required: incident_id.

create_a_fire_hydrant_incident_link

Add an adhoc link to a FireHydrant incident as an attachment. Returns: id, type, href_url, display_text, icon_url, editable, deletable. Required: incident_id, href.

delete_a_fire_hydrant_incident_link_by_id

Remove a link from a FireHydrant incident by id. Returns an empty 204 response on success. Required: incident_id, id.

list_all_fire_hydrant_incident_links

List all editable, external links attached to a FireHydrant incident. Returns: id, type, href_url, display_text, icon_url, editable, deletable. Required: incident_id.

update_a_fire_hydrant_incident_link_by_id

Update the attributes of an external link on a FireHydrant incident. Returns: id, type, href_url, display_text, icon_url, editable, deletable. Required: incident_id, id.

create_a_fire_hydrant_incident_note

Create a new note on a FireHydrant incident. Returns: id, body, created_at, status_pages, and conversations. Required: incident_id, body. The visibility field determines where the note is posted; defaults to private_to_org.

update_a_fire_hydrant_incident_note_by_id

Update the body of an existing note on a FireHydrant incident. Returns: id, body, created_at, status_pages, and conversations. Required: incident_id, id, body.

create_a_fire_hydrant_incident_role_assignment

Assign a role to a user for a FireHydrant incident. Returns: id, status, created_at, updated_at, incident_role, user. Required: incident_id, user_id, incident_role_id.

delete_a_fire_hydrant_incident_role_assignment_by_id

Unassign a role from a user for a FireHydrant incident. Returns an empty 204 response on success. Required: incident_id, id.

list_all_fire_hydrant_incident_role_assignments

List all current role assignments for a FireHydrant incident. Returns: id, status, created_at, updated_at, incident_role, user. Required: incident_id.

create_a_fire_hydrant_incident_status_page

Add a status page to a FireHydrant incident. Returns: id, name, url, external_id, display_name, and integration details. Required: incident_id, integration_slug, integration_id.

list_all_fire_hydrant_incident_status_pages

List all status pages attached to a FireHydrant incident. Returns: id, name, url, external_id, display_name, and integration details per record. Required: incident_id.

delete_a_fire_hydrant_incident_status_page_by_id

Remove a status page from a FireHydrant incident. Returns an empty 204 response on success. Required: incident_id, id.

create_a_fire_hydrant_incident_team_assignment

Assign a team to a FireHydrant incident. Returns an empty 201 response on success. Required: incident_id, team_id.

delete_a_fire_hydrant_incident_team_assignment_by_id

Unassign a team from a FireHydrant incident by team assignment id. Optionally removes specific role assignments associated with the team. Returns an empty 204 response on success. Required: incident_id, id.

create_a_fire_hydrant_scheduled_maintenance

Create a new scheduled maintenance event in FireHydrant. Returns the created event including id, name, starts_at, ends_at, description, services, and created_at. Required: name, starts_at, ends_at.

delete_a_fire_hydrant_scheduled_maintenance_by_id

Delete a scheduled maintenance event in FireHydrant by id. Returns an empty 204 response on success.

get_single_fire_hydrant_scheduled_maintenance_by_id

Get a single scheduled maintenance event by id in FireHydrant. Returns the event including id, name, starts_at, ends_at, description, services, status_pages, and created_at. Required: id.

list_all_fire_hydrant_scheduled_maintenances

List all scheduled maintenance events in FireHydrant. Returns a collection of events each including id, name, starts_at, ends_at, description, services, and created_at.

update_a_fire_hydrant_scheduled_maintenance_by_id

Update an existing scheduled maintenance event in FireHydrant by id. Returns the updated event including id, name, starts_at, ends_at, description, services, and updated_at. Required: id.

delete_a_fire_hydrant_incident_event_by_id

Delete a FireHydrant incident event by id. Returns an empty 204 response on success. Required: incident_id, id.

get_single_fire_hydrant_incident_event_by_id

Get a single FireHydrant incident event by id. Returns the full event object including id, incident_id, type, occurred_at, visibility, author, data, context, votes, and conversations. Required: incident_id, id.

list_all_fire_hydrant_incident_events

List all timeline events for a FireHydrant incident, optionally filtered by event type. Returns per-event: id, incident_id, type, occurred_at, visibility, author, data, context, votes, and conversations. Required: incident_id.

update_a_fire_hydrant_incident_event_by_id

Update a single FireHydrant incident event by id. Returns the updated event including id, incident_id, type, occurred_at, visibility, author, data, context, votes, and conversations. Required: incident_id, id.

delete_a_fire_hydrant_incident_transcript_by_id

Delete a transcript entry from a FireHydrant incident. Returns an empty 204 response on success. Required: incident_id, id.

get_single_fire_hydrant_incident_summary_by_id

Get similar FireHydrant incidents for a given incident. Returns a list of similar incident records including id, name, description, and created_at. Required: incident_id.

get_single_fire_hydrant_conference_bridge_translation_by_id

Retrieve translations for a specific conference bridge in FireHydrant. Returns: id, has_translated_transcripts, language_codes, transcription_status, transcription_sub_code, attachments, and previous_host_assignment. Required: incident_id, conference_bridge_id.

get_single_fire_hydrant_incident_channel_by_id

Get chat channel information for a FireHydrant incident. Returns: id, name, source, source_name, source_id, url, icon_url, and status of the associated chat channel. Required: incident_id.

get_single_fire_hydrant_incident_relationship_by_id

List parent/child relationships for a FireHydrant incident. Returns: parent (the incident's parent, with id, name, and number), children (array of child incidents, each with id, name, and number), and siblings (incidents sharing the same parent, each with id, name, and number). Required: incident_id.

get_single_fire_hydrant_incident_user_by_id

Get the current user's role assignment for a FireHydrant incident. Returns: id, status, created_at, updated_at, incident_role (with id, name, summary, description), and user (with id, name, email, role). Required: incident_id.

list_all_fire_hydrant_incident_conference_bridges

List all conference bridges for a FireHydrant incident. Returns: id, attachments, has_translated_transcripts, language_codes, transcription_status, transcription_sub_code, and previous_host_assignment for each bridge. Required: incident_id.

list_all_fire_hydrant_transcript_entries

List all transcript entries for a FireHydrant incident. Returns: id, speaker, words, start, until, created_at, updated_at, and author (id, name, source, email). Required: incident_id. Optionally filter by cursor position using after or before, and control order with sort.

update_a_fire_hydrant_transcript_attribution_by_id

Update the attribution of a transcript entry in a FireHydrant incident, reassigning who said what in the transcript to a different user. Returns an empty 200 response on success. Required: incident_id, id, to_user_id.

update_a_fire_hydrant_ai_incident_summary_by_id

Vote on an AI-generated incident summary in FireHydrant for the current user. Returns the updated summary including id, content, source_hash, type, created_at, and incident_updated_at. Required: incident_id, generated_summary_id, and direction ('up' or 'down').

create_a_fire_hydrant_integration_connection

Create a new integration connection in FireHydrant. Returns the created connection including id, integration_slug, display_name, configuration_url, authorized_by, created_at, updated_at, and integration-specific details.

list_all_fire_hydrant_integration_connections

List available integration connections in FireHydrant. Returns per connection: id, integration_slug, display_name, authorized_by, created_at, updated_at, and integration-specific details. Optionally filter by integration_slug.

create_a_fire_hydrant_slack_emoji_action

Create a new Slack emoji action in FireHydrant. Returns: id, emoji_name, incident_type_id. Required: emoji_name.

delete_a_fire_hydrant_slack_emoji_action_by_id

Delete a Slack emoji action in FireHydrant by id. Returns an empty 204 response on success.

get_single_fire_hydrant_slack_emoji_action_by_id

Get a single Slack emoji action in FireHydrant by id. Returns: id, emoji_name, incident_type_id. Required: id.

list_all_fire_hydrant_slack_emoji_actions

List Slack emoji actions in FireHydrant. Returns: id, emoji_name, incident_type_id per record.

update_a_fire_hydrant_slack_emoji_action_by_id

Update a Slack emoji action in FireHydrant by id. Returns: id, emoji_name, incident_type_id. Required: id.

delete_a_fire_hydrant_statuspage_connection_by_id

Delete a Statuspage integration connection in FireHydrant by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_statuspage_connection_by_id

Get a single Statuspage integration connection in FireHydrant by id. Returns: id, page_name, page_id, conditions, severities, and milestone_mappings for the connection. Required: id.

list_all_fire_hydrant_statuspage_connections

List all configured Statuspage integration connections in FireHydrant. Returns: id, page_name, page_id, conditions, severities, and milestone_mappings for each connection.

update_a_fire_hydrant_statuspage_connection_by_id

Update a Statuspage integration connection in FireHydrant by id. Returns: id, page_name, page_id, conditions, severities, and milestone_mappings for the updated connection. Required: id.

get_single_fire_hydrant_aws_cloudtrail_batch_by_id

Get a single FireHydrant AWS CloudTrail batch by id. Returns: id, status, events_created, starts_at, ends_at, connection, created_at. Required: id.

list_all_fire_hydrant_aws_cloudtrail_batches

List AWS CloudTrail batches in FireHydrant for the authenticated organization. Returns: id, status, events_created, starts_at, ends_at, connection, created_at. Optionally filter by connection_id.

update_a_fire_hydrant_aws_cloudtrail_batch_by_id

Update a FireHydrant AWS CloudTrail batch with new information. Returns: id, status, events_created, starts_at, ends_at, connection, created_at. Required: id.

get_single_fire_hydrant_aws_connection_by_id

Get a FireHydrant AWS connection by id. Returns: id, aws_account_id, target_arn, external_id, connection_status, status_text, status_description, environment_id, environment_name, and regions. Required: id.

list_all_fire_hydrant_aws_connections

List all configured AWS integration connections in FireHydrant. Returns per connection: id, aws_account_id, target_arn, external_id, connection_status, status_text, status_description, environment_id, environment_name, and regions. Optionally filter by aws_account_id, target_arn, or external_id.

update_a_fire_hydrant_aws_connection_by_id

Update a FireHydrant AWS connection by id. Returns the updated connection object including id, aws_account_id, target_arn, external_id, connection_status, status_text, status_description, environment_id, environment_name, and regions. Required: id.

get_single_fire_hydrant_integration_by_id

Get a single FireHydrant integration by id. Returns: id, slug, name, description, setup_url, created_at, connections, enabled, installed, deprecated, logo, and nat_ip. Required: id.

list_all_fire_hydrant_integrations

List all available and configured integrations in FireHydrant. Returns one record per integration including: id, slug, name, description, setup_url, created_at, connections, enabled, installed, deprecated, logo, and nat_ip.

update_a_fire_hydrant_integration_by_id

Update a FireHydrant integration by id. Returns the updated integration object including: id, slug, name, description, setup_url, created_at, connections, enabled, installed, deprecated, logo, and nat_ip. Required: id.

fire_hydrant_zendesk_tickets_search

Search for Zendesk tickets in FireHydrant by ticket ID. Returns matching ticket records including id and attributes (ticket fields are Zendesk-configuration-specific). Required: ticket_id.

list_all_fire_hydrant_authed_providers

List available and configured authed providers in FireHydrant. Returns: id, authorized_email, integration_default, is_expired, user, created_at, updated_at.

update_a_fire_hydrant_authed_provider_by_id

Update an authed provider in FireHydrant, such as setting it as the account integration default. Returns: id, authorized_email, integration_default, is_expired, user, created_at, updated_at. Required: provider_slug.

list_all_fire_hydrant_cloudtrail_batch_events

List events for an AWS CloudTrail batch in FireHydrant. Returns: id, summary, description, external_id, created_at, starts_at, ends_at, duration_ms, duration_iso8601, environments, services, authors, identities, related_changes, attachments, and labels for each event. Required: batch_id.

get_single_fire_hydrant_integration_connection_status_by_id

Get a single FireHydrant integration connection status by slug and id. Returns: status, checked_at, message, check_type, error_type, integration_slug, connection_id, data, and performed_by. Required: slug, id.

list_all_fire_hydrant_integration_connection_statuses

List all FireHydrant integration connection statuses across connections. Returns: status, checked_at, message, check_type, error_type, integration_slug, connection_id, data, and performed_by for each status record.

list_all_fire_hydrant_field_maps

List available fields for field mapping in FireHydrant. Returns each mappable field's value, label, type, allowed_values, required status, and help_text.

update_a_fire_hydrant_field_map_by_id

Update a field mapping in FireHydrant. Returns the updated field map object including id, connection_id, connection_type, entity_id, entity_type, body, available_fields_url, and data_bag_url.

list_all_fire_hydrant_slack_usergroups

List all Slack user groups configured in FireHydrant. Returns: id, name, handle, is_disabled.

list_all_fire_hydrant_slack_workspaces

List all Slack workspaces connected to FireHydrant. Returns: id, team_id, name for each workspace in the collection.

list_all_fire_hydrant_statuspage_connection_pages

List available StatusPage pages for a FireHydrant Statuspage integration connection. Returns: id, name for each page. Required: connection_id.

update_a_fire_hydrant_integrations_connection_by_id

Refresh a FireHydrant integration connection's incident role schedules. Returns: id, integration_slug, display_name, authorized_by, created_at, updated_at, details, and default_authorized_actor. Required: connection_id.

fire_hydrant_confluence_spaces_search

Search available Confluence spaces in FireHydrant by name or key. Returns: id, name. Optionally filter by query (space name) or keyword (space key, deprecated).

list_all_fire_hydrant_slack_channels

List or search for Slack channels that the FireHydrant bot can access. Returns: id, name, slack_channel_id. Optionally filter by slack_channel_id, name, or a free-text query.

update_a_fire_hydrant_slack_channel_by_id

Update a Slack channel record in FireHydrant by id. Returns: id, name, slack_channel_id. Required: id.

update_a_fire_hydrant_connection_by_id

Update an integration connection in FireHydrant by connection_id. Returns: id, integration_slug, display_name, authorized_by, created_at, updated_at, details, and default_authorized_actor. Required: connection_id.

create_a_fire_hydrant_saved_search

Create a new saved search for a specific resource type in FireHydrant. Returns: id, name, resource_type, user_id, is_private, created_at, updated_at, filter_values. Required: resource_type, name, filter_values.

delete_a_fire_hydrant_saved_search_by_id

Delete a specific saved search in FireHydrant. Returns an empty 204 response on success. Required: resource_type, id.

get_single_fire_hydrant_saved_search_by_id

Get a specific saved search in FireHydrant by id. Returns: id, name, resource_type, user_id, is_private, created_at, updated_at, filter_values. Required: resource_type, id.

list_all_fire_hydrant_saved_searches

List saved searches for a specific resource type in FireHydrant. Returns: id, name, resource_type, user_id, is_private, created_at, updated_at, filter_values per record. Required: resource_type.

update_a_fire_hydrant_saved_search_by_id

Update a specific saved search in FireHydrant. Returns: id, name, resource_type, user_id, is_private, created_at, updated_at, filter_values. Required: resource_type, id.

list_all_fire_hydrant_shift_analytics

Export an on-call hours report from FireHydrant for specified users or teams over a given time window. The response structure is not enumerated in the source documentation (the upstream API returns an opaque export payload). Required: period_start, period_end.

get_single_fire_hydrant_report_by_id

Get mean time metrics for incidents in FireHydrant. Returns time-bucketed analytics data including: data (array of time buckets, each with a bucket label and key/value data points), start_date, end_date, and bucket_period. All filter parameters are optional.

list_all_fire_hydrant_signals_grouped_metrics

Generate a grouped metrics report for FireHydrant Signals alerts. Returns: grouped_id, grouped_name, total_opened_alerts, total_acked_alerts, total_incidents, total_billable_alerts, total_resolved_alerts, acked_percentage, and incidents_percentage. Optionally filter by signal_rules, teams, environments, services, or tags, and control grouping and ordering via group_by, sort_by, and sort_direction.

list_all_fire_hydrant_signals

List signals in FireHydrant. Returns: id, summary, body, level, organization_id, tags, annotations, images, and links per signal record.

get_single_fire_hydrant_signal_by_id

Get a single FireHydrant signal by id. Returns: id, summary, body, level, organization_id, tags, annotations, images, and links. Required: id.

create_a_fire_hydrant_signal

Create a new signal in FireHydrant. Returns: id, summary, body, level, organization_id, tags, annotations, images, and links.

list_all_fire_hydrant_signals_analytics

Generate a timeseries-based report of Signals alert metrics in FireHydrant. Returns: bucket, total_opened_alerts, total_acked_alerts, total_incidents, total_billable_alerts, total_resolved_alerts, acked_percentage, and incidents_percentage per time bucket. All parameters are optional; use start_date, end_date, bucket, group_by, and sort_by to control the report scope and shape.

list_all_fire_hydrant_incident_metrics

List incident metrics and analytics from FireHydrant. Returns a time-bucketed analytics report including: type, by, bucket_size, keys, buckets, and sort. All filter and grouping parameters are optional; use start_date, end_date, bucket_size, and by to shape the report.

get_single_fire_hydrant_infrastructure_metric_by_id

Get incident metrics for a specific FireHydrant infrastructure component (environment, functionality, service, or customer). Returns: id, name, mttd (Mean Time To Detection), mtta (Mean Time To Acknowledgement), mttm (Mean Time To Mitigation), mttr (Mean Time To Resolution), count (number of incidents), and total_time (total seconds impacted) for the specified time period. Required: type, id.

list_all_fire_hydrant_infrastructure_type_metrics

List FireHydrant infrastructure metrics for all components of a given type. Returns: id, name, mttd (Mean Time To Detection), mtta (Mean Time To Acknowledgement), mttm (Mean Time To Mitigation), mttr (Mean Time To Resolution), count, and total_time for each component in the specified time window. Required: type.

list_all_fire_hydrant_milestone_funnel_metrics

List milestone funnel metrics from FireHydrant, returning a time-bucketed report of incident milestone progression. Returns: time_bucket (bucket start datetime), filter_params (bucket start/end dates), and milestone_counts (per-milestone frequency counts for the period). All parameters are optional filters.

list_all_fire_hydrant_metrics

List FireHydrant infrastructure MTTX metrics based on a custom query over a date range. Returns metric groups each containing count, mttd, mtta, mttm, mttr, healthiness, group_attributes, and period-over-period diff and percent-diff values. Required: start_date, end_date.

list_all_fire_hydrant_retrospectives

List retrospective analytics metrics in FireHydrant. Returns a collection of data points where each item contains x (time-period label) and y (metric value). Optionally filter by start_date and end_date.

list_all_fire_hydrant_ticket_funnel_metrics

List ticket task and follow-up creation and completion metrics in FireHydrant. Returns data buckets with time_bucket, tasks_created, tasks_done, follow_ups_created, follow_ups_done, and filter_params. All filter parameters are optional; use start_date and end_date to scope by incident start time.

list_all_fire_hydrant_user_involvement_metrics

List user involvement metrics in FireHydrant, returning a time-bucketed analytics report. Returns: by, bucket_size, keys, buckets, and sort (with field, direction, and limit). Optionally scope results with start_date, end_date, bucket_size, by, and sort_field/sort_direction/sort_limit.

create_a_fire_hydrant_page

Create a page in FireHydrant Signals to notify an on-call target. Returns the resulting alert object including its id, summary, status, priority, starts_at, ends_at, signal_id, team_id, notification_priority, and associated incidents. Required: summary, target_type, target_id.

list_all_fire_hydrant_permissions

List all permissions for the current user in FireHydrant. Returns: slug, display_name, description, category_display_name, category_slug, parent_slug, required, available, and dependency_slugs for each permission entry.

list_all_fire_hydrant_team_permissions

List all permissions for a team in FireHydrant. Returns: slug, display_name, description, category_display_name, category_slug, parent_slug, required, available, and dependency_slugs for each permission. Required: team_id.

create_a_fire_hydrant_incident_retrospective_dynamic_input

Add a new dynamic input field to a FireHydrant retrospective's dynamic input group field. Returns: id, label, type, value, is_required, help_text, permissible_values, retrospective_field_id, required_at_milestone_id. Required: incident_id, retrospective_id, field_id.

delete_a_fire_hydrant_incident_retrospective_dynamic_input_by_id

Remove a dynamic input from a FireHydrant retrospective's dynamic input group field by id. Returns an empty 204 response on success. Required: incident_id, retrospective_id, field_id, id.

create_a_fire_hydrant_incident_retrospective_field

Append a new field to a FireHydrant incident retrospective. Returns the created field including id, label, type, value, is_required, and retrospective_field_id. Required: incident_id, retrospective_id, label, type.

update_a_fire_hydrant_incident_retrospective_field_by_id

Update the value of a field on a FireHydrant incident retrospective. Returns the updated field including id, label, type, value, is_required, and retrospective_field_id. Required: incident_id, retrospective_id, id, value.

create_a_fire_hydrant_incident_retrospective

Create a new retrospective for a FireHydrant incident using a retrospective template. Returns: id, name, description, sections, is_hidden, fields, exports, retrospective_template_id. Required: incident_id, retrospective_template_id.

list_all_fire_hydrant_incident_retrospectives

List all retrospectives attached to a FireHydrant incident. Returns: id, name, description, sections, is_hidden, fields, exports, retrospective_template_id. Required: incident_id.

update_a_fire_hydrant_incident_retrospective_by_id

Update a retrospective attached to a FireHydrant incident, such as toggling its hidden status. Returns: id, name, description, sections, is_hidden, fields, exports, retrospective_template_id. Required: incident_id, id.

create_a_fire_hydrant_post_mortem_reason

Create a contributing factor for a FireHydrant retrospective report. Returns: id, summary, position, created_by, conversations. Required: report_id, summary.

delete_a_fire_hydrant_post_mortem_reason_by_id

Delete a contributing factor from a FireHydrant retrospective report by id. Returns an empty 204 response on success. Required: report_id, id.

list_all_fire_hydrant_post_mortem_reasons

List all contributing factors for a FireHydrant retrospective report. Returns: id, summary, position, created_by, conversations. Required: report_id.

update_a_fire_hydrant_post_mortem_reason_by_id

Reorder a contributing factor in a FireHydrant retrospective report by updating its position. Returns: id, summary, position, created_by, conversations. Required: report_id, id, old_position, new_position.

create_a_fire_hydrant_post_mortem_report

Create a retrospective (post mortem) report in FireHydrant linked to an incident. Returns: id, name, incident, created_at, updated_at. Required: incident_id.

get_single_fire_hydrant_post_mortem_report_by_id

Get a single FireHydrant retrospective report by id. Returns: id, name, incident, created_at, updated_at.

list_all_fire_hydrant_post_mortem_reports

List retrospective reports in FireHydrant. Returns a collection of report records, each including id, name, incident, created_at, and updated_at.

update_a_fire_hydrant_post_mortem_report_by_id

Update a FireHydrant retrospective report by id. Returns the updated report including id, name, incident, created_at, and updated_at.

create_a_fire_hydrant_retrospective_template

Create a new retrospective template in FireHydrant. Returns: id, name, description, is_default, created_at, updated_at, sections, and fields. Required: name, description, sections[slug], sections[elements], fields[label], fields[type].

delete_a_fire_hydrant_retrospective_template_by_id

Delete a single FireHydrant retrospective template by id. Returns an empty 204 response on success.

get_single_fire_hydrant_retrospective_template_by_id

Get a single FireHydrant retrospective template by id. Returns: id, name, description, is_default, created_at, updated_at, sections, and fields. Required: id.

list_all_fire_hydrant_retrospective_templates

List all FireHydrant retrospective templates. Returns: id, name, description, is_default, created_at, updated_at, and report_elements per template. Optionally filter by incident using for_incident.

update_a_fire_hydrant_retrospective_template_by_id

Update a single FireHydrant retrospective template by id. Returns: id, name, description, is_default, created_at, updated_at, sections, and fields. Required: id.

get_single_fire_hydrant_retrospective_field_by_id

Get a specific retrospective field for a FireHydrant incident. Returns: id, label, type, help_text, is_required, value, permissible_values, retrospective_field_id, and required_at_milestone_id. Required: incident_id, retrospective_id, id.

get_single_fire_hydrant_post_mortem_question_by_id

Get a single FireHydrant retrospective question by id. Returns: id, title, tooltip, kind, is_required, and available_options. Required: id.

update_a_fire_hydrant_post_mortem_question_by_id

Update the retrospective questions configured for future FireHydrant retrospective reports. Returns: id, title, tooltip, kind, is_required, and available_options for the updated question.

list_all_fire_hydrant_retrospective_questions

List the retrospective questions configured in FireHydrant to be provided and filled out on each retrospective report. Returns: id, title, tooltip, kind, is_required, and available_options for each question.

update_a_fire_hydrant_post_mortem_by_id

Publish a FireHydrant post mortem report by its report ID, marking it as published and available for stakeholder review. Returns the updated report object including id, name, and published_at. Required: report_id.

create_a_fire_hydrant_role

Create a new role in FireHydrant. Returns: id, name, slug, description, created_at, updated_at, built_in, read_only, and permissions. Required: name.

delete_a_fire_hydrant_role_by_id

Delete a FireHydrant role by id. Returns an empty 204 response on success.

get_single_fire_hydrant_role_by_id

Get a single FireHydrant role by id. Returns: id, name, slug, description, created_at, updated_at, built_in, read_only, and permissions.

list_all_fire_hydrant_roles

List all roles in the FireHydrant organization, optionally filtering by name or slug. Returns per-record: id, name, slug, description, created_at, updated_at, built_in, read_only, and permissions.

update_a_fire_hydrant_role_by_id

Update an existing FireHydrant role by id. Returns: id, name, slug, description, created_at, updated_at, built_in, read_only, and permissions. Required: id.

create_a_fire_hydrant_runbook_execution

Create a runbook execution in FireHydrant by attaching a runbook to an incident and running it. Returns: id, status, created_at, runbook, steps, and executed_for. Required: runbook_id, execute_for (format: `incident/${incidentId}`).

delete_a_fire_hydrant_runbook_execution_by_id

Terminate a FireHydrant runbook execution by id, preventing any further steps from being executed. Returns an empty 204 response on success. Required: id, reason.

get_single_fire_hydrant_runbook_execution_by_id

Get a FireHydrant runbook execution by id. Returns: id, status, status_reason, created_at, updated_at, runbook, steps, executed_for, and has_been_rerun. Required: id.

list_all_fire_hydrant_runbook_executions

List FireHydrant runbook executions. Returns: id, status, created_at, runbook, steps, executed_for, and has_been_rerun for each execution record.

create_a_fire_hydrant_runbook

Create a new FireHydrant runbook for use with incidents. Returns: id, name, type, description, steps, owner, created_at, updated_at, attachment_rule, is_editable, last_executed_at. Required: name, type. Note: type is deprecated but still required; always use 'incident'.

delete_a_fire_hydrant_runbook_by_id

Delete a FireHydrant runbook by id, making it unavailable for any future incidents. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_runbook_by_id

Get a FireHydrant runbook and all its configuration by id. Returns: id, name, type, description, steps, owner, created_at, updated_at, attachment_rule, is_editable, last_executed_at, categories. Required: id.

list_all_fire_hydrant_runbooks

List FireHydrant runbooks. Returns one record per runbook including id, name, type, description, steps, owner, created_at, updated_at, attachment_rule, is_editable, categories, and last_executed_at.

update_a_fire_hydrant_runbook_by_id

Update an existing FireHydrant runbook by id. Returns: id, name, type, description, steps, owner, created_at, updated_at, attachment_rule, is_editable, categories, last_executed_at. Required: id.

list_all_fire_hydrant_runbook_action_field_options

List select options for a FireHydrant runbook integration action field. Returns option items including label and value for populating select inputs in runbook step configurations. Required: action_id, field_id. Optionally narrow results with query or scope.

get_single_fire_hydrant_runbook_execution_step_script_by_id

Get the bash script from a "script" step in a FireHydrant runbook execution. Returns: id, status, created_at, updated_at, has_been_rerun, runbook, steps, and executed_for. Required: execution_id, step_id.

list_all_fire_hydrant_runbook_actions

List all runbook actions available through connected integrations in FireHydrant. Returns: id, name, slug, description, category, supported_runbook_types, automatable, rerunnable, repeatable, integration, config, created_at, and updated_at. Optionally filter by runbook type using the type parameter, or request a slimified integration object with lite.

list_all_fire_hydrant_runbook_audits

List audit records for a specific FireHydrant runbook (deprecated endpoint). Returns: id, created_at, auditable_type. Required: runbook_id. Optionally filter by auditable_type (Runbooks::Step or Runbooks::Runbook) or sort by created_at ascending or descending.

update_a_fire_hydrant_runbook_execution_step_by_id

Update a runbook execution step's status in FireHydrant. Returns the updated execution object including id, status, status_reason, has_been_rerun, created_at, runbook, steps, and executed_for. Required: execution_id, id.

create_a_fire_hydrant_scim_group

Create a new SCIM group (Team) in FireHydrant and assign members. Returns: id, displayName, members. Required: displayName, members.

delete_a_fire_hydrant_scim_group_by_id

Delete a FireHydrant SCIM group (Team) by id. Returns an empty 204 response on success.

get_single_fire_hydrant_scim_group_by_id

Get a single FireHydrant SCIM group (Team) by id. Returns: id, displayName, members.

list_all_fire_hydrant_scim_groups

List all FireHydrant SCIM groups (Teams). Returns: id, displayName, members. Optionally filter by displayName using the filter parameter; only the eq operator is supported.

update_a_fire_hydrant_scim_group_by_id

Update a FireHydrant SCIM group (Team) by id using SCIM operations to add, remove, or replace members. Returns: id, displayName, members. Required: Operations.

create_a_fire_hydrant_user

Create and provision a new user in FireHydrant. Returns: id, name, email, role, created_at, slack_user_id. Required: userName, name (with givenName and familyName), emails.

update_a_fire_hydrant_user_by_id

Update an existing FireHydrant user by id, replacing their attributes such as name, emails, roles, and active status. Returns: id, name, email, role, updated_at, slack_user_id. Required: id.

get_single_fire_hydrant_user_by_id

Get a FireHydrant user by id. Returns: id, name, email, role, teams, organization_id, organization_name, and region. Required: id.

list_all_fire_hydrant_users

List all users in a FireHydrant organization. Returns: id, name, email, slack_user_id, role, created_at per user. Optionally filter results by query (name or email) or name.

delete_a_fire_hydrant_scim_user_by_id

Delete a FireHydrant SCIM user by id, deactivating the confirmed user record in the system. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_scim_user_by_id

Get a single FireHydrant SCIM user by id. Returns the SCIM user object including id, userName, name, emails, active, and schemas. Required: id.

list_all_fire_hydrant_scim_users

List FireHydrant SCIM users currently in the system. Returns user objects including id, userName, name, emails, active, and schemas. Optionally filter by userName or email using the filter parameter with eq operator syntax (e.g. userName eq "john").

update_a_fire_hydrant_scim_user_by_id

Update a FireHydrant SCIM user's attributes by id using SCIM patch operations (add, remove, replace). Returns the updated user object including id, userName, name, emails, active, and schemas. Required: id, Operations.

create_a_fire_hydrant_on_call_schedule_rotation

Create a new on-call schedule rotation in FireHydrant for a given team and schedule. Returns: id, name, description, time_zone, color, members, shifts, strategy, restrictions, created_at, updated_at. Required: team_id, schedule_id.

delete_a_fire_hydrant_on_call_schedule_rotation_by_id

Delete a FireHydrant on-call schedule rotation by id. Returns an empty 204 response on success. Required: team_id, schedule_id, id.

update_a_fire_hydrant_on_call_schedule_rotation_by_id

Update a FireHydrant on-call schedule rotation by id. Returns: id, name, description, time_zone, color, members, shifts, strategy, restrictions, created_at, updated_at. Required: team_id, schedule_id, id.

create_a_fire_hydrant_notification_policy

Create a FireHydrant Signals notification policy. Returns: id, notification_group_method, max_delay, priority, created_at, updated_at. Required: notification_group_method, max_delay, priority.

delete_a_fire_hydrant_notification_policy_by_id

Delete a FireHydrant Signals notification policy by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_notification_policy_by_id

Get a single FireHydrant Signals notification policy by id. Returns: id, notification_group_method, max_delay, priority, created_at, updated_at. Required: id.

list_all_fire_hydrant_notification_policies

List all FireHydrant Signals notification policies. Returns: id, notification_group_method, max_delay, priority, created_at, updated_at per policy.

update_a_fire_hydrant_notification_policy_by_id

Update a FireHydrant Signals notification policy by id. Returns: id, notification_group_method, max_delay, priority, created_at, updated_at. Required: id.

create_a_fire_hydrant_on_call_shift

Create a Signals on-call shift in a FireHydrant on-call schedule. Returns: id, start_time, end_time, user, on_call_schedule, on_call_rotation, team, color, time_zone, and coverage_request. Required: team_id, schedule_id, start_time, end_time.

delete_a_fire_hydrant_on_call_shift_by_id

Delete a FireHydrant Signals on-call shift by id. Returns an empty 204 response on success. Required: id, team_id, schedule_id.

get_single_fire_hydrant_on_call_shift_by_id

Get a FireHydrant Signals on-call shift by id. Returns: id, start_time, end_time, user, on_call_schedule, on_call_rotation, team, color, time_zone, and coverage_request. Required: id, team_id, schedule_id.

update_a_fire_hydrant_on_call_shift_by_id

Update a FireHydrant Signals on-call shift by id. Returns: id, start_time, end_time, user, coverage_request, on_call_schedule, on_call_rotation, team, color, and time_zone. Required: id, team_id, schedule_id.

create_a_fire_hydrant_signals_alert_grouping_configuration

Create a Signals alert grouping configuration in FireHydrant for the organization. Returns: id, strategy, action, reference_alert_time_period. Required: strategy, reference_alert_time_period.

delete_a_fire_hydrant_signals_alert_grouping_configuration_by_id

Delete a FireHydrant Signals alert grouping configuration by id. Returns an empty 204 response on success. Required: id.

get_signals_alert_grouping_configuration_by_id

Get a single FireHydrant Signals alert grouping configuration by id. Returns: id, strategy, action, reference_alert_time_period. Required: id.

list_all_fire_hydrant_signals_alert_grouping_configurations

List all FireHydrant Signals alert grouping configurations for the organization. Returns: id, strategy, action, reference_alert_time_period per record.

update_a_fire_hydrant_signals_alert_grouping_configuration_by_id

Update a FireHydrant Signals alert grouping configuration by id. Returns: id, strategy, action, reference_alert_time_period. Required: id.

create_a_fire_hydrant_signals_event_source

Create a new Signals event source in FireHydrant. Returns: name, slug, ingest_url, expression, editable, tags, created_by, updated_by. Required: name, slug, example_payload, javascript.

delete_a_fire_hydrant_signals_event_source_by_id

Delete a FireHydrant Signals event source by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_signals_event_source_by_id

Get a single FireHydrant Signals event source by id. Returns: name, slug, ingest_url, expression, description, editable, tags, created_by, updated_by. Required: id.

list_all_fire_hydrant_signals_event_sources

List all FireHydrant Signals event sources for the authenticated user. Returns: name, slug, ingest_url, description, editable, tags, created_by per item. Optionally filter by team_id, escalation_policy_id, on_call_schedule_id, or user_id.

create_a_fire_hydrant_signals_heartbeat_endpoint_configuration

Create a new heartbeat endpoint configuration in FireHydrant. Returns the created configuration including its id, slug, enabled status, kind, expect_interval, and template_signal. Required: slug, enabled, expect_interval, kind, and template_signal.

create_a_fire_hydrant_signals_webhook_target

Create a Signals webhook target in FireHydrant. Returns: id, name, url, description, created_by, created_at, updated_at. Required: name, url.

delete_a_fire_hydrant_signals_webhook_target_by_id

Delete a FireHydrant Signals webhook target by id. Returns an empty 204 response on success.

get_single_fire_hydrant_signals_webhook_target_by_id

Get a FireHydrant Signals webhook target by id. Returns: id, name, url, description, created_by, created_at, updated_at.

list_all_fire_hydrant_signals_webhook_targets

List all Signals webhook targets in FireHydrant. Returns per item: id, name, url, description, created_by, created_at, updated_at. Optionally filter by a search string.

update_a_fire_hydrant_signals_webhook_target_by_id

Update a FireHydrant Signals webhook target by id. Returns: id, name, url, description, created_by, created_at, updated_at.

create_a_fire_hydrant_team_escalation_policy

Create a Signals escalation policy for a team in FireHydrant. Returns: id, name, description, default, repetitions, steps, handoff_step, created_at, updated_at, step_strategy, notification_priority_policies. Required: team_id, name, steps.

delete_a_fire_hydrant_team_escalation_policy_by_id

Delete a Signals escalation policy by ID for a team in FireHydrant. Returns an empty 204 response on success. Required: team_id, id.

create_a_fire_hydrant_on_call_schedule

Create a Signals on-call schedule for a FireHydrant team with an initial rotation. Returns: id, name, description, time_zone, rotations, members, shifts, strategy, restrictions, signals_ical_url, created_at, updated_at. Required: team_id, name.

get_single_fire_hydrant_on_call_schedule_by_id

Get a Signals on-call schedule by ID for a FireHydrant team. Returns: id, name, description, time_zone, rotations, members, shifts, strategy, restrictions, signals_ical_url, team, created_by, created_at, updated_at. Required: team_id, id. Optionally filter returned shifts using shift_time_window_start and shift_time_window_end.

list_all_fire_hydrant_on_call_schedules

List all Signals on-call schedules for a FireHydrant team. Returns each schedule's id, name, description, time_zone, rotations, members, shifts, strategy, restrictions, signals_ical_url, created_at, updated_at. Required: team_id.

update_a_fire_hydrant_on_call_schedule_by_id

Update a Signals on-call schedule for a FireHydrant team by ID. Returns: id, name, description, time_zone, rotations, members, shifts, strategy, restrictions, signals_ical_url, team, created_at, updated_at. Required: team_id, id.

create_a_fire_hydrant_signal_rule

Create a Signals rule for a FireHydrant team. Returns: id, name, expression, team_id, target, created_at, notification_priority_override, deduplication_expiry. Required: team_id, name, expression, target_type, target_id. Max 2000 rules per organization.

delete_a_fire_hydrant_signal_rule_by_id

Delete a FireHydrant Signals rule by id. Returns an empty 204 response on success. Required: team_id, id.

get_single_fire_hydrant_signal_rule_by_id

Get a FireHydrant Signals rule by id. Returns: id, name, expression, team_id, target, created_by, created_at, updated_at, notification_priority_override, deduplication_expiry. Required: team_id, id.

list_all_fire_hydrant_signal_rules

List all Signals rules for a FireHydrant team. Returns: id, name, expression, team_id, target, created_at, notification_priority_override, deduplication_expiry per rule. Required: team_id.

update_a_fire_hydrant_signal_rule_by_id

Update a FireHydrant Signals rule by id. Returns: id, name, expression, team_id, target, created_at, updated_at, notification_priority_override, deduplication_expiry. Required: team_id, id.

delete_a_fire_hydrant_signals_heartbeat_endpoint_by_id

Delete a FireHydrant heartbeat endpoint configuration by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_signals_heartbeat_endpoint_by_id

Get the status of a FireHydrant heartbeat endpoint by id. Returns: id. Required: id.

delete_a_fire_hydrant_support_hours_schedule_by_id

Delete a specific support hours schedule in FireHydrant by id. Returns an empty 204 response on success. Required: team_id, id.

get_single_fire_hydrant_support_hours_schedule_by_id

Get a specific support hours schedule in FireHydrant for a team by id. Returns: team_id, time_zone, signals_maximum_notification_priority, bypass_priority_threshold, in_support_hours, shifts, and updated_by. Required: team_id, id.

update_a_fire_hydrant_support_hours_schedule_by_id

Update a FireHydrant team's support hours schedule by id. Returns the updated schedule including team_id, time_zone, signals_maximum_notification_priority, bypass_priority_threshold, in_support_hours, shifts, and updated_by. Required: team_id, id.

delete_a_fire_hydrant_team_on_call_schedule_by_id

Delete a FireHydrant Signals on-call schedule for a team by id. Returns an empty 204 response on success. Required: team_id, id.

create_a_fire_hydrant_team_on_call_schedule

Preview a new FireHydrant on-call schedule for a team based on provided rotations, so you can verify the schedule shape before saving it. Returns: name and rotations (each with name, color, and shifts containing start_time, end_time, and assigned user). Required: team_id, name, rotations.

get_single_fire_hydrant_on_call_rotation_by_id

Get an on-call rotation by ID in FireHydrant. Returns the full rotation object including id, name, description, time_zone, color, members, shifts, strategy, restrictions, created_by, created_at, and updated_at. Required: id, team_id, schedule_id.

get_single_fire_hydrant_heartbeat_endpoint_by_id

Get a single FireHydrant heartbeat endpoint configuration by id. Returns: id, enabled, description, expect_interval, kind, allowed_http_methods, allowed_email_senders, and template_signal. Required: id.

update_a_fire_hydrant_heartbeat_endpoint_by_id

Update an existing FireHydrant heartbeat endpoint configuration by id. Returns: id, enabled, description, expect_interval, kind, allowed_http_methods, allowed_email_senders, and template_signal. Required: id.

get_single_fire_hydrant_escalation_policy_by_id

Get a FireHydrant Signals escalation policy by ID for a specific team. Returns: id, name, description, default, repetitions, steps, handoff_step, created_by, created_at, updated_at, step_strategy, notification_priority_policies. Required: team_id, id.

list_all_fire_hydrant_escalation_policies

List all FireHydrant Signals escalation policies for a team. Returns: id, name, description, default, repetitions, steps, handoff_step, created_by, created_at, updated_at, step_strategy, notification_priority_policies. Required: team_id.

update_a_fire_hydrant_escalation_policy_by_id

Update a FireHydrant Signals escalation policy by ID for a specific team. Returns: id, name, description, default, repetitions, steps, handoff_step, created_by, created_at, updated_at, step_strategy, notification_priority_policies. Required: team_id, id.

list_all_fire_hydrant_heartbeat_endpoint_configurations

List all heartbeat endpoint configurations in FireHydrant for your organization. Returns a paginated collection of configurations including id, name, description, and created_at for each entry.

list_all_fire_hydrant_signal_transposers

List all signal transposers for your FireHydrant organization. Returns: name, slug, description, expression, expected, ingest_url, editable, tags, website, created_by, and updated_by for each transposer.

list_all_fire_hydrant_user_notification_settings

List all Signals notification settings for a specific FireHydrant user. Returns: id, notification_type, notification_priority, delay, and destination (including id, type, label, and value). Required: user_id. Optionally filter by notification_priority (HIGH, MEDIUM, or LOW).

create_a_fire_hydrant_on_call_rotation_override

Create an override covering a specific time period in a FireHydrant on-call rotation, re-assigning that period to a specific user. Returns: id, start_time, end_time, user, on_call_schedule, on_call_rotation, team, color, time_zone, coverage_request. Required: team_id, schedule_id, rotation_id, start_time, end_time.

create_a_fire_hydrant_status_page_subscriber

Add one or more email subscribers to a FireHydrant status page. Returns: id, email, created_at. Required: connection_id, emails.

delete_a_fire_hydrant_status_page_subscriber_by_id

Remove a subscriber from a FireHydrant status page by subscriber id. Returns an empty 204 response on success. Required: connection_id, id.

list_all_fire_hydrant_status_page_subscribers

List all email subscribers for a FireHydrant status page connection. Returns: id, email, created_at. Required: connection_id.

create_a_fire_hydrant_nunc_component_group

Create a component group on a FireHydrant status page. Returns the updated status page connection object including id, domain, company_name, component_groups, publish_state, auto_publish, enable_histogram, and is_dns_verified. Required: connection_id, name.

delete_a_fire_hydrant_nunc_component_group_by_id

Delete a component group from a FireHydrant status page. Returns an empty 204 response on success. Required: connection_id, id.

create_a_fire_hydrant_nunc_connection

Create a new FireHydrant hosted status page for customer-facing statuses. Returns: id, domain, company_name, cname, publish_state, conditions, components, is_dns_verified, and auto_publish. Required: domain, conditions[nunc_condition], conditions[condition_id], components[infrastructure_type], components[infrastructure_id].

get_single_fire_hydrant_nunc_connection_by_id

Get a FireHydrant hosted status page by id. Returns: id, domain, company_name, cname, publish_state, conditions, components, is_dns_verified, and last_verified_at. Required: id.

list_all_fire_hydrant_nunc_connections

List all FireHydrant hosted status pages. Returns: id, domain, company_name, cname, publish_state, conditions, components, is_dns_verified, and last_verified_at per status page.

update_a_fire_hydrant_nunc_connection_by_id

Update an existing FireHydrant hosted status page by id. Returns: id, domain, company_name, cname, publish_state, conditions, components, is_dns_verified, and auto_publish. Required: id.

create_a_fire_hydrant_nunc_link

Add a link to be displayed on a FireHydrant status page. Returns the full NuncConnectionEntity including id, domain, company_name, title, links, publish_state, enable_histogram, and last_verified_at. Required: connection_id.

delete_a_fire_hydrant_nunc_link_by_id

Delete a link displayed on a FireHydrant status page by id. Returns an empty 204 response on success. Required: connection_id, id.

create_a_fire_hydrant_nunc_subscription

Subscribe an email address to status page updates for a FireHydrant nunc connection. Returns: response. Required: connection_id, email.

delete_a_fire_hydrant_nunc_subscription_by_id

Unsubscribe from FireHydrant status page notifications for a nunc connection. Returns an empty 204 response on success. Required: connection_id, id.

delete_a_fire_hydrant_status_page_by_id

Unpublish a FireHydrant hosted status page by id, stopping incident updates from being sent to it. Returns an empty 204 response on success. Required: id.

delete_a_fire_hydrant_status_page_image_by_id

Delete an image from a FireHydrant status page by image type. Returns an empty 204 response on success. Required: connection_id, id.

update_a_fire_hydrant_status_page_image_by_id

Upload or replace an image on a FireHydrant status page connection. Returns the updated status page object including id, domain, company_name, title, publish_state, logo, cover_image, favicon, dark_logo, open_graph_image, and additional branding and configuration fields. Required: connection_id, id.

update_a_fire_hydrant_status_page_component_group_by_id

Update a component group displayed on a FireHydrant status page. Returns the updated component group including its id, name, component_group_id, and position. Required: connection_id, id.

update_a_fire_hydrant_status_page_link_by_id

Update a link displayed on a FireHydrant status page. Returns the updated link including id, display_text, icon_url, and href_url. Required: connection_id, id.

update_a_fire_hydrant_incident_task_by_id

Update a FireHydrant incident task by id. Returns: id, title, state, description, assignee, created_by, created_at, updated_at, due_at. Required: incident_id, id.

create_a_fire_hydrant_incident_task

Create a new task for a FireHydrant incident. Returns: id, title, state, description, assignee, created_by, created_at, updated_at, due_at. Required: incident_id, title.

delete_a_fire_hydrant_incident_task_by_id

Delete a FireHydrant incident task by id. Returns an empty 204 response on success. Required: incident_id, id.

get_single_fire_hydrant_incident_task_by_id

Get a single FireHydrant incident task by id. Returns: id, title, state, description, assignee, created_by, created_at, updated_at, due_at. Required: incident_id, id.

list_all_fire_hydrant_incident_tasks

List all tasks for a FireHydrant incident. Returns: id, title, state, description, assignee, created_by, created_at, updated_at, due_at. Required: incident_id.

create_a_fire_hydrant_checklist_template

Create a checklist template in FireHydrant for the organization. Returns: id, name, description, created_at, checks, owner, connected_services. Required: name, checks.

delete_a_fire_hydrant_checklist_template_by_id

Archive a FireHydrant checklist template by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_checklist_template_by_id

Get a single FireHydrant checklist template by id. Returns: id, name, description, created_at, updated_at, checks, owner, connected_services. Required: id.

list_all_fire_hydrant_checklist_templates

List all checklist templates in the FireHydrant organization, optionally filtered by name. Returns: id, name, description, created_at, updated_at, checks, owner, connected_services per template.

update_a_fire_hydrant_checklist_template_by_id

Update an existing FireHydrant checklist template by id. Returns: id, name, description, updated_at, checks, owner, connected_services. Required: id.

create_a_fire_hydrant_incident_task_list

Add all tasks from a FireHydrant task list to an incident. Returns the created task entity including id, title, description, state, assignee, created_by, created_at, updated_at, and due_at. Required: incident_id, task_list_id.

create_a_fire_hydrant_task_list

Create a new task list in FireHydrant. Returns the created task list including id, name, description, created_at, updated_at, created_by, and task_list_items. Required: name, task_list_items.

delete_a_fire_hydrant_task_list_by_id

Delete a FireHydrant task list by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_task_list_by_id

Get a single FireHydrant task list by id. Returns: id, name, description, created_at, updated_at, created_by, and task_list_items. Required: id.

list_all_fire_hydrant_task_lists

List all FireHydrant task lists for your organization. Returns per item: id, name, description, created_at, updated_at, created_by, and task_list_items.

update_a_fire_hydrant_task_list_by_id

Update a FireHydrant task list's attributes and task list items by id. Returns: id, name, description, created_at, updated_at, created_by, and task_list_items. Required: id.

create_a_fire_hydrant_team

Create a new team in FireHydrant. Returns: id, name, slug, description, created_at, updated_at, memberships, slack_channel, ms_teams_channel, in_support_hours, signals_ical_url. Required: name.

delete_a_fire_hydrant_team_by_id

Delete a FireHydrant team by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_team_by_id

Get a single FireHydrant team by id. Returns: id, name, slug, description, created_at, updated_at, memberships, slack_channel, ms_teams_channel, owned_services, in_support_hours, signals_ical_url. Required: id.

list_all_fire_hydrant_teams

List all FireHydrant teams. Returns one record per team including: id, name, slug, description, created_at, updated_at, memberships, slack_channel, ms_teams_channel, in_support_hours, signals_ical_url.

update_a_fire_hydrant_team_by_id

Update an existing FireHydrant team by id using partial PATCH semantics. Returns: id, name, slug, description, updated_at, memberships, slack_channel, ms_teams_channel, owned_services, in_support_hours, signals_ical_url. Required: id.

list_all_fire_hydrant_schedules

List all known schedules in FireHydrant as pulled from external sources. Returns: id, name, integration, discarded. Optionally filter by name using the query parameter.

create_a_fire_hydrant_ticketing_project_inbound_field_map

Create an inbound field map for a FireHydrant ticketing project. Returns: id, connection_id, connection_type, ticketing_project_id, external_field_name, internal_field_name, ticket_type. Required: project_id.

update_a_fire_hydrant_ticketing_project_inbound_field_map_by_id

Update an existing inbound field map for a FireHydrant ticketing project. Returns: id, connection_id, connection_type, ticketing_project_id, external_field_name, internal_field_name, ticket_type. Required: project_id, id.

create_a_fire_hydrant_ticket

Create a ticket in FireHydrant for a project. Returns the created ticket including id, summary, description, state, type, connection_type, assignees, priority, created_at, updated_at, tag_list, incident_id, due_at, and link. Required: summary.

delete_a_fire_hydrant_ticket_by_id

Archive a FireHydrant ticket by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_ticket_by_id

Get a single FireHydrant ticket by id. Returns: id, summary, description, state, type, connection_type, assignees, priority, created_at, updated_at, tag_list, incident_id, due_at, and link. Required: id.

list_all_fire_hydrant_tickets

List all tickets in the FireHydrant organization. Returns each ticket with id, summary, description, state, type, connection_type, assignees, priority, created_at, updated_at, tag_list, and incident_id.

update_a_fire_hydrant_ticket_by_id

Update an existing FireHydrant ticket by id. Returns the updated ticket including id, summary, description, state, type, connection_type, assignees, priority, created_at, updated_at, tag_list, incident_id, due_at, and link. Required: id.

create_a_fire_hydrant_ticketing_field_map

Create a field mapping for a FireHydrant ticketing project. Returns the created field map including id, connection_id, connection_type, ticketing_project_id, and body (array of field mapping rules).

delete_a_fire_hydrant_ticketing_field_map_by_id

Archive a field map for a FireHydrant ticketing project by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_ticketing_field_map_by_id

Get a field map for a FireHydrant ticketing project by id. Returns: id, connection_id, connection_type, ticketing_project_id, and body (array of field mapping rules). Required: id.

list_all_fire_hydrant_ticketing_field_maps

List available fields for ticket field mapping in FireHydrant. Returns metadata for each mappable field including value (field ID), label, type, allowed_values, and supported status.

update_a_fire_hydrant_ticketing_field_map_by_id

Update a field map for a FireHydrant ticketing project by id. Returns the updated field map including id, connection_id, connection_type, ticketing_project_id, and body (array of field mapping rules). Required: id.

create_a_fire_hydrant_ticketing_priority

Create a new ticketing priority in FireHydrant. Returns: id, name, position, created_at, updated_at. Required: name.

delete_a_fire_hydrant_ticketing_priority_by_id

Delete a FireHydrant ticketing priority by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_ticketing_priority_by_id

Get a single FireHydrant ticketing priority by id. Returns: id, name, position, created_at, updated_at. Required: id.

list_all_fire_hydrant_ticketing_priorities

List all ticketing priorities available to the organization in FireHydrant. Returns: id, name, position, created_at, updated_at per priority record.

update_a_fire_hydrant_ticketing_priority_by_id

Update a FireHydrant ticketing priority's name or position by id. Returns: id, name, position, created_at, updated_at. Required: id.

create_a_fire_hydrant_ticketing_project_configuration

Create a configuration for a FireHydrant ticketing project. Returns: id, connection_id, connection_type, ticketing_project_id, ticketing_project_name, and details (provider-specific config object). Required: project_id.

delete_a_fire_hydrant_ticketing_project_configuration_by_id

Archive a FireHydrant ticketing project configuration by id. Returns an empty 204 response on success. Required: project_id, id.

get_single_fire_hydrant_ticketing_project_configuration_by_id

Get configuration for a FireHydrant ticketing project by id. Returns: id, connection_id, connection_type, ticketing_project_id, ticketing_project_name, and details (provider-specific config object). Required: project_id, id.

update_a_fire_hydrant_ticketing_project_configuration_by_id

Update configuration for a FireHydrant ticketing project by id. Returns: id, connection_id, connection_type, ticketing_project_id, ticketing_project_name, and details (provider-specific config object). Required: project_id, id.

delete_a_fire_hydrant_inbound_field_map_by_id

Archive an inbound field map in FireHydrant by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_inbound_field_map_by_id

Get a single FireHydrant inbound field map by id. Returns: id, connection_id, connection_type, ticketing_project_id, external_field_name, internal_field_name, and ticket_type. Required: id.

list_all_fire_hydrant_inbound_field_maps

List all FireHydrant inbound field maps. Returns a collection of field map records each including id, connection_id, connection_type, ticketing_project_id, external_field_name, internal_field_name, and ticket_type.

list_all_fire_hydrant_ticketing_project_configuration_options

List all configuration options for a ticketing project in FireHydrant. Returns: id, attributes (configuration-specific fields whose shape varies by ticketing project). Required: project_id, configuration_id.

get_single_fire_hydrant_ticketing_project_by_id

Get a single FireHydrant ticketing project by id. Returns: id, name, connection_slug, updated_at, config (connection details and provider-specific settings), and field_map (field mapping rules). Required: id.

list_all_fire_hydrant_ticketing_projects

List all FireHydrant ticketing projects available to the organization. Returns: id, name, connection_slug, updated_at, config, and field_map per project. Optionally filter by providers, connection_ids, configured_projects, or a search query.

list_all_fire_hydrant_ticket_tags

List all ticket tags in the FireHydrant organization. Returns: name. Optionally filter results by supplying a prefix string.

create_a_fire_hydrant_ticketing_custom_field_definition

Create a ticketing custom field definition in FireHydrant for the organization. Returns: field_id, display_name, field_type, slug, description, required, and permissible_values. Required: display_name, field_type.

update_a_fire_hydrant_ticketing_custom_field_definition_by_id

Update an existing ticketing custom field definition in FireHydrant by id. Returns: field_id, display_name, field_type, slug, description, required, and permissible_values. Required: id.

delete_a_fire_hydrant_ticketing_custom_field_by_id

Delete a FireHydrant ticketing custom field by id. Returns an empty 204 response on success. Required: id.

list_all_fire_hydrant_ticketing_custom_fields

List all FireHydrant ticketing custom fields available to the organization. Returns: field_id, display_name, field_type, slug, description, required, and permissible_values.

get_single_fire_hydrant_ticketing_form_configuration_by_id

Get a ticketing form configuration by id in FireHydrant. Returns the form configuration object including the fields property. Required: id.

create_a_fire_hydrant_webhook

Create a new webhook in FireHydrant. Returns the created webhook object including id, url, state, created_by, created_at, and updated_at. Required: url.

delete_a_fire_hydrant_webhook_by_id

Delete a FireHydrant webhook by id. Returns an empty 204 response on success. Required: id.

get_single_fire_hydrant_webhook_by_id

Get a specific FireHydrant webhook by id. Returns: id, url, state, created_by, created_at, updated_at, and subscriptions. Required: id.

list_all_fire_hydrant_webhooks

List all webhooks in FireHydrant. Returns each webhook's id, url, state, created_by, created_at, and updated_at.

update_a_fire_hydrant_webhook_by_id

Update a specific FireHydrant webhook by id. Returns the updated webhook object including id, url, state, created_by, created_at, and updated_at. Required: id.

list_all_fire_hydrant_webhook_deliveries

List delivery records for a specific FireHydrant webhook. Returns: id, created_at, status_code, attempts, duration, expires_after, headers, and error for each delivery attempt. Required: webhook_id.

Why Truto

Why use Truto’s MCP server for FireHydrant

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 500+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Go live with FireHydrant in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s FireHydrant account

Use Truto’s frontend SDK to connect your customer’s FireHydrant account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call FireHydrant

Truto’s Proxy API is a 1-to-1 mapping of the FireHydrant API. You call us, we call FireHydrant, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate FireHydrant’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about FireHydrant on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How does authentication work for FireHydrant via Truto?

FireHydrant uses bot token authentication. Truto handles the credential exchange and storage, so your end users connect their FireHydrant account once and you call the API through Truto without managing tokens or refresh logic.

Can I create and update incidents programmatically?

Yes. The full incident lifecycle is supported, including creating incidents, updating fields, assigning roles and teams, adding notes, attachments, links, chat messages, and change events, and managing milestones in bulk.

Does the integration support FireHydrant Signals for alerting?

Yes. You can create signals, manage signal rules, configure event sources, webhook targets, alert grouping configurations, and heartbeat endpoints, and create pages — covering the full Signals on-call workflow.

Can I sync custom fields and field maps?

Yes. Custom field definitions for both incidents and ticketing are supported, along with field maps and inbound field maps for ticketing project configurations, so you can mirror your users' custom data model.

What data can I pull for analytics and reporting?

You can list incident metrics, milestone funnel metrics, ticket funnel metrics, infrastructure and infrastructure-type metrics, user involvement metrics, shift analytics, signals analytics, retrospectives, and individual reports.

Is the service catalog fully manageable through the API?

Yes. Services, functionalities, environments, service dependencies, service links, infrastructures, catalogs, change identities, and change types can all be created, listed, updated, and deleted to keep FireHydrant's catalog in sync with your platform.

Can I subscribe to FireHydrant events via webhooks?

Yes. You can create, list, update, and delete FireHydrant webhooks and inspect webhook deliveries, so your product can react to incident, signal, and catalog events in near real time rather than polling.

FireHydrant

Get FireHydrant integrated into your app

Our team understands what it takes to make a FireHydrant integration successful. A short, crisp 30 minute call with folks who understand the problem.