Sign in
Incidents

List project incidents

Returns incidents in the project, ordered from oldest to newest. The time window defaults to the trailing 7 days.

get/v1/projects/{projectSlug}/incidents

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

Query parameters

fromIsostring date-time

Lower bound (inclusive) of the time window. Returns incidents whose lifetime overlaps [fromIso, toIso]. Defaults to 7 days before toIso.

Lower bound (inclusive) of the time window. Returns incidents whose lifetime overlaps [fromIso, toIso]. Defaults to 7 days before toIso.

toIsostring date-time

Upper bound (inclusive) of the time window. Defaults to now.

Upper bound (inclusive) of the time window. Defaults to now.

source_type'monitor' | 'signal'

Restrict to incidents triggered by this source type: monitor or signal.

Restrict to incidents triggered by this source type: monitor or signal.

source_idstring

Restrict to incidents tied to one source entity id.

Restrict to incidents tied to one source entity id.

severitiesstring[]

Restrict to incidents whose severity matches any value in this list.

Restrict to incidents whose severity matches any value in this list.

Response

Matching incidents

Changes

Changed in 8 of the 67 revisions of this API.51419

  • 2ce07f01d6c211See the full diff
    • ●

      added the new urgent enum value to the items/items/severity response property for the response status 200

      response-property-enum-value-added

    • ○

      added the enum value urgent to the property items/ of the query request parameter severities

      request-parameter-property-enum-value-added

  • f618a20f107f2See the full diff
    • ▲

      added subschema #3 to the items/items/condition/anyOf[AlertEscalatingCondition]/metric response property oneOf list for the response status 200

      response-property-one-of-added

    • ▲

      added subschema #3 to the items/items/condition/anyOf[AlertThresholdCondition]/metric response property oneOf list for the response status 200

      response-property-one-of-added

  • 5cedc15b21b5256See the full diff
    • ▲

      removed the required property items/items/kind from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property items/items/monitorAlertId from the response with the 200 status

      response-required-property-removed

    • ●

      deleted the query request parameter kinds

      request-parameter-removed

    • ●

      deleted the query request parameter sourceId

      request-parameter-removed

    • ●

      deleted the query request parameter sourceTypes

      request-parameter-removed

    • ●

      added the new monitor enum value to the items/items/sourceType response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new signal enum value to the items/items/sourceType response property for the response status 200

      response-property-enum-value-added

    • ○

      added the new optional query request parameter source_id

      new-optional-request-parameter

    • ○

      added the new optional query request parameter source_type

      new-optional-request-parameter

    • ○

      added AlertThresholdCondition AlertEscalatingCondition subschema #3 to the items/items/condition response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed the issue enum value from the items/items/sourceType response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the savedSearch enum value from the items/items/sourceType response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 from the items/items/condition response property oneOf list for the response status 200

      response-property-one-of-removed

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • b68fa53b6ab111See the full diff
    • ▲

      added subschema #1 subschema #2 subschema #4 subschema #5 to the items/items/condition response property oneOf list for the response status 200

      response-property-one-of-added

    • ○

      removed subschema #1 subschema #2 from the items/items/condition response property oneOf list for the response status 200

      response-property-one-of-removed

  • 0e5d35c9aa1533See the full diff
    • ●

      added the new event.matched enum value to the items/items/kind response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new metric.escalating enum value to the items/items/kind response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new metric.threshold enum value to the items/items/kind response property for the response status 200

      response-property-enum-value-added

    • ○

      added the enum value event.matched to the property items/ of the query request parameter kinds

      request-parameter-property-enum-value-added

    • ○

      added the enum value metric.escalating to the property items/ of the query request parameter kinds

      request-parameter-property-enum-value-added

    • ○

      added the enum value metric.threshold to the property items/ of the query request parameter kinds

      request-parameter-property-enum-value-added

  • 7a4027f058a72See the full diff
    • ○

      added the required property items/items/condition to the response with the 200 status

      response-required-property-added

    • ○

      added the required property items/items/monitorAlertId to the response with the 200 status

      response-required-property-added

  • f4b19b86cb9455See the full diff
    • ●

      added the new low enum value to the items/items/severity response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new savedSearch enum value to the items/items/sourceType response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new savedSearch.escalating enum value to the items/items/kind response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new savedSearch.match enum value to the items/items/kind response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new savedSearch.threshold enum value to the items/items/kind response property for the response status 200

      response-property-enum-value-added

    • ○

      added the enum value low to the property items/ of the query request parameter severities

      request-parameter-property-enum-value-added

    • ○

      added the enum value savedSearch to the property items/ of the query request parameter sourceTypes

      request-parameter-property-enum-value-added

    • ○

      added the enum value savedSearch.escalating to the property items/ of the query request parameter kinds

      request-parameter-property-enum-value-added

    • ○

      added the enum value savedSearch.match to the property items/ of the query request parameter kinds

      request-parameter-property-enum-value-added

    • ○

      added the enum value savedSearch.threshold to the property items/ of the query request parameter kinds

      request-parameter-property-enum-value-added

  • fc0da553a9501See the full diff
    • ○

      endpoint added

      endpoint-added