⌘ K

API-referens för incidenter

Hämta alla incidenter på sidan

Endpoint:

GET /v1/:page_id/incidents?page=:page&per_page=:per_page
  • Standardvärdet för page är 1.
  • Standardvärdet för per_page är 50 och maxvärdet är 100 poster per sida.

Exempelsvar:

[
  {
    "id": "ckf01m59ueaqb0a32wrljz1yd",
    "name": "Rocket is going down",
    "started": "2020-09-12T19:05:17.398Z",
    "status": "RESOLVED",
    "resolved": "2020-09-12T19:09:04.498Z",
    "updates": [
      {
        "id": "ckf01m5ioeaqi0a32jtv8ovp8",
        "message": "We are currently investigating this incident.",
        "messageHtml": "<p>We are currently investigating this incident.</p>",
        "status": "INVESTIGATING",
        "notify": true,
        "started": "2020-09-12T19:05:17.398Z",
        "ended": null,
        "duration": 228,
        "createdAt": "2020-09-12T19:08:50.160Z"
      },
      {
        "id": "ckf01mnk9eaui0a32mmhgq68g",
        "message": "This incident has been resolved.",
        "messageHtml": "<p>This incident has been resolved.</p>",
        "status": "RESOLVED",
        "notify": true,
        "started": "2020-09-12T19:09:04.498Z",
        "ended": null,
        "duration": null,
        "createdAt": "2020-09-12T19:09:13.545Z"
      }
    ],
    "components": [
      {
        "id": "ckf01fvnxywz50a35nh1qzssm",
        "name": "Website",
        "status": "PARTIALOUTAGE",
        "showUptime": true,
        "site": {
          "id": "ckf01fonve9i40a32oas5b0uw",
          "name": "Nasa",
          "subdomain": "nasa",
          "color": null,
          "logoUrl": null,
          "publicEmail": null
        },
        "customImpactPercentage": 40
      }
    ],
    "user": {
      "id": "ckf01g7m4eaqb0a32fl7jl1xx",
      "name": "Buzz Aldrin",
      "email": "buzz@nasa.com"
    }
  }
]

Du kan lägga till query-parametrarna status och !status för att begränsa resultatet till incidenter som har respektive inte har en av statusarna i en kommaseparerad lista.

user är den medlem i arbetsytan som skapade incidenten. Den är null när incidenten skapades automatiskt (av en övervakare, en tredjepartsintegration eller via e-post).

Hämta en incident

Endpoint:

GET /v1/:page_id/incidents/:incident_id

Exempelsvar:

{
  "id": "ckf01m59ueaqb0a32wrljz1yd",
  "name": "Rocket is going down",
  "status": "RESOLVED",
  "started": "2020-09-12T19:05:17.398Z",
  "resolved": "2020-09-12T19:09:04.498Z",
  "updates": [
    {
      "id": "ckf01m5ioeaqi0a32jtv8ovp8",
      "message": "We are currently investigating this incident.",
      "messageHtml": "<p>We are currently investigating this incident.</p>",
      "status": "INVESTIGATING",
      "notify": true,
      "started": "2020-09-12T19:05:17.398Z",
      "ended": null,
      "duration": 228,
      "createdAt": "2020-09-12T19:08:50.160Z"
    },
    {
      "id": "ckf01mnk9eaui0a32mmhgq68g",
      "message": "This incident has been resolved.",
      "messageHtml": "<p>This incident has been resolved.</p>",
      "status": "RESOLVED",
      "notify": true,
      "started": "2020-09-12T19:09:04.498Z",
      "ended": null,
      "duration": null,
      "createdAt": "2020-09-12T19:09:13.545Z"
    }
  ],
  "components": [
    {
      "id": "ckf01fvnxywz50a35nh1qzssm",
      "name": "Website",
      "status": "MAJOROUTAGE",
      "showUptime": true,
      "site": {
        "id": "ckf01fonve9i40a32oas5b0uw",
        "name": "Nasa",
        "subdomain": "nasa",
        "color": null,
        "logoUrl": null,
        "publicEmail": null
      }
    }
  ],
  "user": {
    "id": "ckf01g7m4eaqb0a32fl7jl1xx",
    "name": "Buzz Aldrin",
    "email": "buzz@nasa.com"
  }
}

Lägg till en incident

Endpoint:

POST /v1/:page_id/incidents

Exempelanrop:

{
  "name": "Test incident",
  "message": "We're currently investigating an issue with the Website",
  "components": ["ckf01fvnxywz50a35nh1qzssm"],
  "started": "2020-09-12 05:38:47.998",
  "status": "INVESTIGATING",
  "notify": true,
  "statuses": [
    {
      "id": "ckf01fvnxywz50a35nh1qzssm",
      "status": "PARTIALOUTAGE",
      "customImpactPercentage": 40
    }
  ],
  "translations": {
    "name": {
      "fr": "Incident de test"
    },
    "message": {
      "fr": "Nous enquêtons actuellement sur un problème avec le site Web"
    }
  }
}

Incidenter publiceras på din statussida som standard. Om du vill skapa en opublicerad incident behöver du skicka med shouldPublish och sätta den till false.

Exempelsvar:

{
  "id": "ckf02l5m8z36j0a35qr9q1tq1",
  "name": "Test incident",
  "status": "INVESTIGATING",
  "started": "2020-09-12T03:38:47.998Z",
  "resolved": null,
  "updates": [],
  "components": [
    {
      "id": "ckf01fvnxywz50a35nh1qzssm",
      "name": "Website",
      "status": "OPERATIONAL",
      "showUptime": true,
      "site": {
        "id": "ckf01fonve9i40a32oas5b0uw",
        "name": "Nasa",
        "subdomain": "nasa",
        "color": null,
        "logoUrl": null,
        "publicEmail": null
      }
    }
  ],
  "translations": {
    "name": {
      "fr": "Incident de test"
    },
    "message": {
      "fr": "Nous enquêtons actuellement sur un problème avec le site Web"
    }
  }
}

Lägg till en incident med en mall

Endpoint:

POST /v1/:page_id/incidents/:template

Exempelsvar:

{
  "id": "cl8hrdsdsasu441sv26yq",
  "name": "Investigating Template",
  "nameTranslationId": null,
  "notify": false,
  "status": "INVESTIGATING",
  "started": "2022-09-25T19:53:20.778Z",
  "resolved": null,
  "duration": null,
  "createdAt": "2022-09-25T19:53:20.800Z",
  "updatedAt": "2022-09-25T19:53:20.800Z",
  "automated": false,
  "impact": "MAJOROUTAGE",
  "appId": null,
  "siteId": "cl8hadasdasd6wkxdco",
  "importedFrom": null
}

Uppdatera incident

Endpoint:

PUT /v1/:page_id/incidents/:incident_id

Exempelanrop:

{
  "name": "Test incident 2",
  "components": ["ckf01fvnxywz50a35nh1qzssm"],
  "started": "2020-09-12 05:38:47.998",
  "status": "INVESTIGATING",
  "notify": true,
  "statuses": [
    {
      "id": "ckf01fvnxywz50a35nh1qzssm",
      "status": "OPERATIONAL"
    }
  ],
  "translations": {
    "name": {
      "fr": "Incident de test"
    },
    "message": {
      "fr": "Nous enquêtons actuellement sur un problème avec le site Web"
    }
  }
}

Exempelsvar:

{
  "id": "ckf02l5m8z36j0a35qr9q1tq1",
  "name": "Test incident 2",
  "status": "INVESTIGATING",
  "started": "2020-09-12T03:38:47.998Z",
  "resolved": null,
  "updates": [],
  "components": [
    {
      "id": "ckf01fvnxywz50a35nh1qzssm",
      "name": "Website",
      "status": "OPERATIONAL",
      "showUptime": true,
      "site": {
        "id": "ckf01fonve9i40a32oas5b0uw",
        "name": "Nasa",
        "subdomain": "nasa",
        "color": null,
        "logoUrl": null,
        "publicEmail": null
      }
    }
  ],
  "translations": {
    "name": {
      "fr": "Incident de test"
    },
    "message": {
      "fr": "Nous enquêtons actuellement sur un problème avec le site Web"
    }
  }
}

Radera incident

Endpoint:

DELETE /v1/:page_id/incidents/:incident_id

Exempelsvar:

{
  "id": "ckf02l5m8z36j0a35qr9q1tq1"
}

Hämta en incidents mottagare

Vem som larmades om en incident via jouren, om någon har kvitterat den och vem som leder den.

Endpoint:

GET /v1/:page_id/incidents/:incident_id/responders

Exempelsvar:

{
  "incidentId": "ckf02l5m8z36j0a35qr9q1tq1",
  "paged": true,
  "acknowledged": true,
  "lead": {
    "teamMemberId": "clh8nmaan72592bfokqjqd95s1",
    "name": "Sam Rivera",
    "email": "sam@example.com"
  },
  "pages": [
    {
      "teamMemberId": "clh8nmaan72592bfokqjqd95s1",
      "name": "Sam Rivera",
      "email": "sam@example.com",
      "pagedAt": "2026-11-01T12:01:00.000Z"
    }
  ],
  "responders": [
    {
      "teamMemberId": "clh8nmaan72592bfokqjqd95s1",
      "name": "Sam Rivera",
      "email": "sam@example.com",
      "status": "ACKNOWLEDGED",
      "acknowledgedAt": "2026-11-01T12:05:00.000Z",
      "declinedAt": null
    }
  ]
}

Kvittera en incident

Kvittera en incident som API-nyckelns användare. Den första kvitteringen avbryter all eskalering som fortfarande väntar på att larma fler personer, och gör den personen till incidentansvarig om det inte finns någon. Inget ändras på statussidan. Det är säkert att kvittera igen: alreadyAcknowledged är då true.

Endpoint:

POST /v1/:page_id/incidents/:incident_id/acknowledge

Exempelsvar:

{
  "incidentId": "ckf02l5m8z36j0a35qr9q1tq1",
  "alreadyAcknowledged": false,
  "paged": true,
  "acknowledged": true,
  "lead": {
    "teamMemberId": "clh8nmaan72592bfokqjqd95s1",
    "name": "Sam Rivera",
    "email": "sam@example.com"
  },
  "pages": [
    {
      "teamMemberId": "clh8nmaan72592bfokqjqd95s1",
      "name": "Sam Rivera",
      "email": "sam@example.com",
      "pagedAt": "2026-11-01T12:01:00.000Z"
    }
  ],
  "responders": [
    {
      "teamMemberId": "clh8nmaan72592bfokqjqd95s1",
      "name": "Sam Rivera",
      "email": "sam@example.com",
      "status": "ACKNOWLEDGED",
      "acknowledgedAt": "2026-11-01T12:05:00.000Z",
      "declinedAt": null
    }
  ]
}