​
Overview

The Incident.io provider facilitates interaction with Incident.io’s API, allowing for the management of incidents. This includes the ability to query specific incidents, retrieve all incidents, and manage incident details. This provider integrates Keep’s system with Incident.io’s robust incident management platform.

​
Authentication

This provider requires authentication.

  • incidentIoApiKey: IncidentIO’s API_KEY (required: True, sensitive: True)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

  • authenticated: User is Authenticated (mandatory)
  • read_access: User has read access (mandatory)

​
In workflows

This provider can be used in workflows.

As “step” to query data, example:

steps:
    - name: Query incidentio
      provider: incidentio
      config: "{{ provider.my_provider_name }}"
      with:
        incident_id: {value}

If you need workflow examples with this provider, please raise a GitHub issue.

​
Connecting with the Provider

​
API Key

To use the Incident.io API:

  1. Log in to your Incident.io account.
  2. Navigate to the “API Keys” section under your account settings.
  3. Generate a new API key or use an existing one.
  4. Ensure it has read permissions enabled for reading and managing incidents.

​
Incident Endpoint

The Incident.io incident endpoint allows querying and managing incidents. Operations include retrieving specific incident details or fetching a list of all incidents. This is crucial for monitoring and responding to incidents efficiently.

For more details, refer to the Incident.io API Documentation.