Skip to main content

​
✅ Prerequisites

Ensure you meet these prerequisites before starting:
  • Active incident.io Account (Administrator privileges recommended)
  • Verified Email Address linked to your incident.io account
  • Permission to generate API keys (Usually Admin or Developer role)

​
🔑 Generate an API Key in incident.io for API Authentication

To generate an API key in the incident.io UI for integrating with AirMDR, follow these steps:
1

Log in to incident.io

  1. Navigate to incident.io and sign in with your credentials.
2

Access API Key Settings

  1. Click on your profile avatar or initials in the top-right corner.
  2. From the dropdown menu, select Settings.
  3. In the Settings sidebar, click on API Keys. IncidentIO1 Pn
3

Create a new API Key

  1. Click the + Add new button in the top-right corner.
  2. Provide a descriptive name for the API key (e.g., AirMDRIntegration).
  3. Select the appropriate permissions for the API key. Common permissions include:
    • Create incidents
    • Edit incidents
    • Create and manage on-call resources
    • View private incidents (if necessary)
  4. Click Create.
This is the only time the API Key will be displayed.
Copy and securely store the value in your preferred password manager or secure storage solution.
Email the API key to AirMDR
or
Self configure incident.io in the AirMDR Integrations Dashboard.

​
Skills Provided by this Integration

Skill IDPurpose
Create Incident.io IncidentCreate a new incident in Incident.io with specified parameters.
Fetch Incident.io AlertsFetch alerts from Incident.io, including detailed summaries for analysis or monitoring.
Fetch Incident.io IncidentsFetch incidents from Incident.io, including detailed summaries for analysis or monitoring.
To view the details of Input Parameters and Output for the respective skills
  • Go to AirMDR → Incident.io Integration page.
  • Select the Skills tab and click on the required listed skills.

​
Incident.io API Testing

Open cURL and run the following command to check if your API Key is working: Request 

curl -X GET https://api.incident.io/v1/incidents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "incidents": [
    {
      "id": "in_abc123",
      "name": "Database latency spike",
      "severity": "high",
      "status": "open",
      "started_at": "2024-05-30T10:42:00Z",
      "created_by": {
        "id": "user_456",
        "name": "Surya"
      }
    },
    {
      "id": "in_def456",
      "name": "API outage",
      "severity": "critical",
      "status": "resolved",
      "started_at": "2024-05-25T07:30:00Z",
      "resolved_at": "2024-05-25T08:15:00Z"
    }
  ]
}

​
Configure Incident.io in the AirMDR Integrations Dashboard

  1. Navigate to AirMDR, provide the credentials, and click Login
  2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select Integrations
  3. Use the search option, enter the keyword “Incident.io”, select the Connections tab, and click Create. IncidentIO2 Pn
  4. Enter an unique name to the Instance (e.g., your org name-Incident.io) to easily identify the user connection by AirMDR.
  5. Enter the generated API Key in the Authentication Details field params, and click Create. IncidentIO3 Pn