---
title: FireHydrant API Integration on Truto
slug: firehydrant
category: Incident Management
canonical: "https://truto.one/integrations/detail/firehydrant/"
---

# FireHydrant API Integration on Truto



**Category:** Incident Management  
**Status:** Beta

## MCP-ready AI tools

Truto exposes 438 tools for FireHydrant that AI agents can call directly.

- **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.

## How it works

1. **Link your customer's FireHydrant account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach FireHydrant.** The Proxy API is a 1-to-1 mapping of the FireHydrant API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **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.
- **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.
- **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.
- **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.
- **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

- **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.
- **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.
- **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.
- **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.
- **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.
- **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.

## FAQs

### 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.

## Related reading

- [Connect FireHydrant to Claude: Automate On-Call and Service Tasks](https://truto.one/blog/connect-firehydrant-to-claude-automate-on-call-and-service-tasks/) — Learn how to connect FireHydrant to Claude using a managed MCP server. Automate incident response, runbooks, and on-call workflows without building custom integrations.
- [Connect FireHydrant to ChatGPT: Manage Incidents and Health Metrics](https://truto.one/blog/connect-firehydrant-to-chatgpt-manage-incidents-and-health-metrics/) — Learn how to build a managed MCP server to connect FireHydrant to ChatGPT. Automate incident response, page on-call teams, and manage retrospectives via AI.
- [Connect FireHydrant to AI Agents: Orchestrate Signals and Changes](https://truto.one/blog/connect-firehydrant-to-ai-agents-orchestrate-signals-and-changes/) — Learn how to connect FireHydrant to AI agents using Truto. Give your LLMs the tools to orchestrate incidents, manage on-call signals, and track changes.