> For the complete documentation index, see llms.txt.
Skip to main content

Check out Port for yourself ➜ 

Manage FireHydrant incidents

Implement with AI

Send this guide to your coding agent.

Prerequisite: Install Port MCP

Open in ClaudeOpen in CodexOpen in Cursor
Open plan mode if your tool supports it; otherwise present the plan below filled in and wait for my approval. Implement this Port guide in my org via MCP:

https://docs.port.io/guides/all/manage-firehydrant-incidents

Read the raw markdown version at https://docs.port.io/guides/all/manage-firehydrant-incidents.md - it contains every tab and code block without page markup.

Goal: get the guide's core flow working end-to-end in my org; adapting it to fit my existing setup takes priority over matching the guide 1:1.

Plan:
1. Confirm MCP is connected, in the right org, with sufficient permissions.
2. If the guide offers alternative implementation paths (tabs), pick the one matching my installed integrations and tools, confirm it with me, and implement only that path.
3. Diff the guide's data model (blueprints, properties, relations, workflows, actions, agents, automations, integrations, webhook data sources, secrets) against mine.
4. Propose adaptations for gaps, reusing existing blueprints/relations over guide-named duplicates.
5. Flag what needs a UI click, credential, or secret from me, testing MCP capability empirically before ruling anything out. If the guide has a "Set up via API" section, use it for anything MCP can't do before treating a step as UI-only.
6. Stop on any blocker and give me options. Approving this plan authorizes the writes it lists; pause only for writes beyond what's listed.

Build:
- Extend blueprint schema additively when upserting; don't remove or overwrite existing properties, and treat type conflicts as a blocker, not an auto-fix.
- Never print secret values into the chat or logs; ask me to set them in Port, or write them via the secrets API without echoing them back.
- List any mock data in the plan, minimal and labeled mock; once approved, seed it without re-asking, and tell me what you seeded.
- For anything the guide writes downstream (e.g. a webhook target), use a real entity, not a mock.
- For pages/widgets, use the real page identifier from the app URL, not a guessed slug.
- When you hit a UI step confirmed (not assumed) unsupported via MCP and not covered by the guide's API sections, pause, give exact clicks, then resume via MCP.
- Validate and give links after each meaningful step (only a tool-returned URL, no guessed paths); don't proceed if the last run wasn't a success.

Done:
- Run the guide's "Let's test it" steps where possible (e.g. execute a workflow test run) and confirm the expected output exists in Port.
- Summarize adaptations, seeded data, what was mocked or skipped, remaining UI steps, and how to verify.

This guide demonstrates how to implement self-service actions that create new FireHydrant incidents or trigger incidents on services directly from Port using synced webhooks or GitHub workflows.

Use cases​

  • Create FireHydrant incidents from Port with name, priority, and description.
  • Trigger incidents against FireHydrant services with a chosen condition (Unavailable, Degraded, Bug, Operational).
  • Keep your Port catalog in sync by automatically upserting the created incident or updating related service data after execution.

Prerequisites​

Set up data model​

If you haven't installed the FireHydrant integration, you will need to manually create blueprints for FireHydrant incidents and services. We highly recommend installing the integration to have these resources automatically set up for you.

Create the FireHydrant incident blueprint

  1. Go to your Builder page.

  2. Click on + Blueprint.

  3. Click on the {...} button in the top right corner, and choose "Edit JSON".

  4. Add this JSON schema:

    FireHydrant Incident Blueprint (Click to expand)
    {
      "identifier": "firehydrantIncident",
      "description": "This blueprint represents a firehydrant incident",
      "title": "FireHydrant Incident",
      "icon": "FireHydrant",
      "schema": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Incident URL",
            "format": "url",
            "description": "the link to the incident"
          },
          "priority": {
            "title": "Priority",
            "type": "string",
            "enum": ["P1", "P2", "P3", "P4"],
            "enumColors": {
              "P1": "red",
              "P2": "red",
              "P3": "orange",
              "P4": "orange"
            }
          },
          "severity": {
            "title": "Severity",
            "type": "string"
          },
          "tags": {
            "title": "Tags",
            "items": { "type": "string" },
            "type": "array"
          },
          "currentMilestone": {
            "type": "string",
            "title": "Current Milestone",
            "default": "started",
            "enum": [
              "started",
              "detected",
              "acknowledged",
              "investigating",
              "identified",
              "mitigated",
              "resolved",
              "postmortem_started",
              "postmortem_completed",
              "closed"
            ],
            "enumColors": {
              "started": "red",
              "detected": "red",
              "acknowledged": "orange",
              "investigating": "yellow",
              "identified": "yellow",
              "mitigated": "green",
              "resolved": "green",
              "postmortem_started": "purple",
              "postmortem_completed": "blue",
              "closed": "green"
            }
          },
          "functionalities": {
            "title": "Functionalities Impacted",
            "items": { "type": "string" },
            "type": "array"
          },
          "customerImpact": {
            "title": "Customers Impacted",
            "type": "string"
          },
          "createdBy": {
            "title": "Created By",
            "type": "string"
          },
          "createdAt": {
            "title": "Created At",
            "type": "string",
            "format": "date-time"
          },
          "description": {
            "title": "Description",
            "type": "string"
          }
        },
        "required": []
      },
      "mirrorProperties": {},
      "calculationProperties": {},
      "aggregationProperties": {},
      "relations": {}
    }

  5. Click "Save" to create the blueprint.

Create the FireHydrant service blueprint

  1. Go to your Builder page.

  2. Click on + Blueprint.

  3. Click on the {...} button in the top right corner, and choose "Edit JSON".

  4. Add this JSON schema:

    FireHydrant Service Blueprint (Click to expand)
    {
      "identifier": "firehydrantService",
      "description": "This blueprint represents a FireHydrant service in our context lake",
      "title": "FireHydrant Service",
      "icon": "FireHydrant",
      "schema": {
        "properties": {
          "name": {
            "title": "Name",
            "description": "The name of the service in FireHydrant",
            "type": "string"
          },
          "description": {
            "title": "Description",
            "description": "Description of the service",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "description": "Current status of the service",
            "type": "string"
          }
        }
      },
      "calculationProperties": {},
      "relations": {}
    }

  5. Click "Save" to create the blueprint.

Update the service blueprint

Add a relation to your service blueprint to link it with FireHydrant services:

  1. Go to your Builder page.

  2. Find your service blueprint and click on it.

  3. Click on the {...} button in the top right corner, and choose "Edit JSON".

  4. Add the following relation to the relations object:

    {
      "relations": {
        "fh_service": {
          "title": "FireHydrant Service",
          "target": "firehydrantService",
          "required": false,
          "many": false
        }
      }
    }

  5. Click "Save" to update the blueprint.

Get FireHydrant Condition IDs​

If you plan to trigger incidents on services, you will need the condition IDs that are specific to your FireHydrant organization. Retrieve them with the FireHydrant API:

curl -X GET "https://api.firehydrant.io/v1/severity_matrix/conditions" \
     -H "Authorization: YOUR_FIREHYDRANT_API_KEY" \
     -H "accept: application/json"

Example response:

{
  "data": [
    { "id": "b1fc9184-b3f3-4af1-a111-68abcad9bf34", "name": "Unavailable", "position": 0 },
    { "id": "465a5b4c-6f95-4707-a777-ab4bb8def27d", "name": "Degraded", "position": 1 },
    { "id": "c2bc11e8-7fcc-428d-9007-26f00700834a", "name": "Bug", "position": 2 },
    { "id": "9a2a8dbb-6b4e-4189-aca1-e2bb73b9c50b", "name": "Operational", "position": 3 }
  ]
}

Use your own IDs in the configurations below.

Implementation​

Configure two self-service actions using Port's synced webhooks and secrets to interact directly with FireHydrant's API.

Add Port secrets

Existing secrets

If you have already installed Port's FireHydrant integration, these secrets should already exist in Port. To view your existing secrets:

  1. Open the Credentials modal.
  2. Click on the Secrets tab.

To add these secrets to Port:

  1. Open the Credentials modal.

  2. Click on the Secrets tab.

  3. Click on + Secret and add the following secrets:

Set up self-service actions

Create a FireHydrant incident

  1. Head to the self-service page.

  2. Click on the + New Action button.

  3. Click on the {...} Edit JSON button.

  4. Copy and paste the following JSON configuration into the editor.

    Create FireHydrant Incident (Webhook) (Click to expand)
    {
      "identifier": "create_firehydrant_incident_webhook",
      "title": "Create FireHydrant Incident (Webhook)",
      "icon": "FireHydrant",
      "description": "Create a new FireHydrant incident",
      "trigger": {
        "type": "self-service",
        "operation": "CREATE",
        "userInputs": {
          "properties": {
            "name": {
              "type": "string",
              "title": "Name",
              "description": "The name or title of the incident"
            },
            "priority": {
              "icon": "DefaultProperty",
              "title": "Priority",
              "type": "string",
              "enum": ["P1", "P2", "P3", "P4"],
              "enumColors": {
                "P1": "red",
                "P2": "orange",
                "P3": "blue",
                "P4": "darkGray"
              }
            },
            "description": {
              "type": "string",
              "title": "Description",
              "description": "Detailed description about the incident"
            }
          },
          "required": [],
          "order": ["name", "description", "priority"]
        }
      },
      "invocationMethod": {
        "type": "WEBHOOK",
        "url": "https://api.firehydrant.io/v1/incidents",
        "agent": false,
        "synchronized": true,
        "method": "POST",
        "headers": {
          "Authorization": "{{.secrets.FIREHYDRANT_API_KEY}}",
          "Content-Type": "application/json"
        },
        "body": {
          "name": "{{.inputs.name}}",
          "priority": "{{.inputs.priority}}",
          "description": "{{.inputs.description}}"
        }
      },
      "requiredApproval": false
    }

  5. Click Save.

Trigger a FireHydrant incident

  1. Head to the self-service page.

  2. Click on the + New Action button.

  3. Click on the {...} Edit JSON button.

  4. Copy and paste the following JSON configuration into the editor.

    Trigger FireHydrant Incident (Webhook) (Click to expand)
    {
      "identifier": "trigger_an_incident",
      "title": "Trigger an incident",
      "icon": "FireHydrant",
      "description": "Trigger an incident to a FireHydrant service",
      "trigger": {
        "type": "self-service",
        "operation": "DAY-2",
        "userInputs": {
          "properties": {
            "name": {
              "icon": "DefaultProperty",
              "type": "string",
              "title": "Incident name"
            },
            "condition": {
              "icon": "DefaultProperty",
              "title": "Service status",
              "type": "string",
              "enum": ["Unavailable", "Degraded", "Bug", "Operational"],
              "enumColors": {
                "Unavailable": "lightGray",
                "Degraded": "lightGray",
                "Bug": "lightGray",
                "Operational": "lightGray"
              }
            },
            "incident_description": {
              "type": "string",
              "title": "Incident description"
            }
          },
          "required": ["name", "condition"],
          "order": ["name", "condition", "incident_description"]
        },
        "blueprintIdentifier": "service"
      },
      "invocationMethod": {
        "type": "WEBHOOK",
        "url": "https://api.firehydrant.io/v1/incidents",
        "agent": false,
        "synchronized": true,
        "method": "POST",
        "headers": {
          "RUN_ID": "{{ .run.id }}",
          "Authorization": "{{ .secrets.FIREHYDRANT_API_KEY }}",
          "content-type": "application/json",
          "accept": "application/json"
        },
        "body": {
          "impacts": [
            {
              "type": "service",
              "id": "{{ .entity.relations.fh_service }}",
              "condition_id": "{{ if .inputs.condition == \"Unavailable\" then \"b1fc9184-b3f3-4af1-a111-68abcad9bf34\" elif .inputs.condition == \"Degraded\" then \"465a5b4c-6f95-4707-a777-ab4bb8def27d\" elif .inputs.condition == \"Bug\" then \"c2bc11e8-7fcc-428d-9007-26f00700834a\" elif .inputs.condition == \"Operational\" then \"9a2a8dbb-6b4e-4189-aca1-e2bb73b9c50b\" else null end }}"
            }
          ],
          "name": "{{ .inputs.name }}",
          "description": "{{ .inputs.incident_description }}"
        }
      },
      "requiredApproval": false
    }

  5. Click Save.

Set up automations

Sync FireHydrant incident after creation

  1. Head to the Automations page.

  2. Click on the + New Automation button.

  3. Click on the {...} Edit JSON button.

  4. Copy and paste the following JSON configuration into the editor.

    Sync FireHydrant incident after creation (Click to expand)
    {
      "identifier": "firehydrant_incident_sync_status",
      "title": "Sync FireHydrant Incident Status",
      "description": "Update FireHydrant incident data in Port after creation",
      "trigger": {
        "type": "automation",
        "event": { "type": "RUN_UPDATED", "actionIdentifier": "create_firehydrant_incident_webhook" },
        "condition": {
          "type": "JQ",
          "expressions": [
            ".diff.after.status == \"SUCCESS\""
          ],
          "combinator": "and"
        }
      },
      "invocationMethod": {
        "type": "UPSERT_ENTITY",
        "blueprintIdentifier": "firehydrantIncident",
        "mapping": {
          "identifier": "{{.event.diff.after.response.id}}",
          "title": "{{.event.diff.after.response.name}}",
          "properties": {
            "url": "{{.event.diff.after.response.incident_url}}",
            "priority": "{{.event.diff.after.response.priority}}",
            "severity": "{{.event.diff.after.response.severity}}",
            "tags": "{{.event.diff.after.response.tag_list}}",
            "currentMilestone": "{{.event.diff.after.response.current_milestone}}",
            "description": "{{.event.diff.after.response.description}}",
            "customerImpact": "{{.event.diff.after.response.customers_impacted}}",
            "createdBy": "{{.event.diff.after.response.created_by.name}}",
            "createdAt": "{{.event.diff.after.response.created_at}}"
          },
          "relations": {}
        }
      },
      "publish": true
    }

  5. Click Save.

Sync FireHydrant service after trigger

  1. Head to the Automations page.

  2. Click on the + New Automation button.

  3. Click on the {...} Edit JSON button.

  4. Copy and paste the following JSON configuration into the editor.

    Sync FireHydrant service after trigger (Click to expand)
    {
      "identifier": "firehydrantIncident_sync_after_trigger",
      "title": "Sync FireHydrant Incident After Trigger",
      "description": "Update FireHydrant service data in Port after triggering an incident",
      "trigger": {
        "type": "automation",
        "event": { "type": "RUN_UPDATED", "actionIdentifier": "trigger_an_incident" },
        "condition": {
          "type": "JQ",
          "expressions": [
            ".diff.after.status == \"SUCCESS\""
          ],
          "combinator": "and"
        }
      },
      "invocationMethod": {
        "type": "UPSERT_ENTITY",
        "blueprintIdentifier": "firehydrantService",
        "mapping": {
          "identifier": "{{.event.diff.after.response.id}}",
          "title": "{{.event.diff.after.response.name}}",
          "properties": {
            "name": "{{.event.diff.after.response.name}}",
            "description": "{{.event.diff.after.response.description}}",
            "status": "{{.event.diff.after.response.status}}"
          }
        }
      },
      "publish": true
    }

  5. Click Save.

Let's test it!​

  1. Head to the self-service page in Port.
  2. Choose either implementation method and action:
    • GitHub workflow: Create FireHydrant Incident or Trigger FireHydrant Incident.
    • Synced webhook: Create FireHydrant Incident (Webhook) or Trigger an incident.
  3. For the trigger flow, select a service that has a fh_service relation to a FireHydrant service.
  4. Fill in the incident details as prompted.
  5. Click Execute and wait for FireHydrant to create or trigger the incident.