incident.io Incident Management for Openclaw

A technical skill for managing the entire incident lifecycle on the incident.io platform through a REST API.

jensastrup
v1.0.0
Feb 25, 2026
0
0
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install incidentio

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install incidentio using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is incident.io Incident Management?

This skill provides a robust interface for interacting with the incident.io REST API, enabling AI agents to automate the declaration, tracking, and resolution of incidents. It bridges the gap between infrastructure monitoring and response coordination by allowing for programmatic control over severities, statuses, and incident updates.

By integrating this Openclaw Skills component, teams can ensure that incident data is handled consistently, reducing manual overhead during high-pressure situations. The skill supports both v1 and v2 API versions, ensuring access to organization-specific metadata as well as core incident management features.

incident.io Incident Management Use Cases

  • Declaring new incidents automatically from monitoring alerts or CLI triggers.
  • Fetching organizational severities and statuses to ensure data integrity during incident creation.
  • Escalating existing incidents by programmatically updating severity levels or roles.
  • Posting real-time investigation updates to maintain stakeholder visibility.
  • Closing resolved incidents by transitioning them to a closed status category.

How incident.io Incident Management Works

  1. The skill authenticates using a Bearer token via the INCIDENTIO_API_KEY environment variable.
  2. It retrieves dynamic metadata (severities, statuses, types) from the v1 API to validate organizational requirements.
  3. A new incident is initialized via the v2 API using a unique idempotency key to prevent duplicates.
  4. During the incident lifecycle, the skill facilitates status transitions and field updates through the dedicated edit action endpoint.
  5. Updates are posted to the incident timeline to track progress and investigation notes.
  6. The workflow concludes by shifting the incident status to a category defined as closed within the organization settings.

incident.io Incident Management Setup

  1. Create an API key at Settings > API keys in your incident.io dashboard.
  2. Ensure the key has permissions for managing incidents and viewing organization data.
  3. Install curl and jq on your system for request handling and response parsing.
  4. Set the required environment variable:
export INCIDENTIO_API_KEY="your-api-key"

incident.io Incident Management Data Schema & Taxonomy

The skill organizes data around the incident.io resource model. Key entities include:

Entity Key Attributes API Version
Incident id, reference, name, summary, status, severity v2
Severity id, name, rank v1
Status id, name, category (triage, live, closed, etc.) v1
Update id, message, created_at v2
Type id, name, is_default v1

incident.io Incident Management Advanced Features

  • Idempotency key support to prevent accidental duplicate incident creation during network retries.
  • Mode selection allowing for standard, retrospective, or test incidents to bypass alerts.
  • Granular filtering for incident lists by status category, severity rank, and date ranges.
  • Support for custom field entries and specific incident role assignments (e.g., Lead, Comms).
  • High-frequency rate limit handling at 1200 requests per minute.
  • Built-in pagination support using cursor-based navigation for large incident histories.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*