POST /analytics/metrics/responders/all

Provides aggregated incident metrics for all selected responders.

Example metrics include Seconds to Resolve, Seconds to Engage, Snoozed Seconds, and Sleep Hour Interruptions. Metric definitions can be found in our Knowledge Base.

Note: Analytics data is updated periodically. It takes up to 24 hours before new incidents appear in the Analytics API.

Scoped OAuth requires: analytics.read

Servers

Request headers

Name Type Required Description
Accept String Yes

The Accept header is used as a versioning header.

Default value: "application/vnd.pagerduty+json;version=2"

Content-Type String Yes

Possible values:

  • "application/json"

Default value: "application/json"

Request body fields

Name Type Required Description
filters Object No

Accepts a set of filters to apply to the Incidents before aggregating. Any incidents that do not match the included filters will be omitted from the results

filters.urgency String No

Any incidents whose urgency does not match the provided string will be omitted from the results.

Possible values:

  • "high"
  • "low"
filters.priority_ids[] Array No

An array of priority IDs. Only incidents with these priorities will be included in the results. If omitted, all priorities will be included in the results.

filters.responder_ids[] Array No

An array of responder IDs. Only incidents related to these responders will be included in the results. If omitted, all responders the requestor has access to will be included in the results.

filters.date_range_start String No

Accepts an ISO8601 DateTime string. Any incidents with a created_at less than this value will be omitted from the results. The maximum supported time range in conjunction with date_range_end is one year.

filters.date_range_end String No

Accepts an ISO8601 DateTime string. Any incidents with a created_at greater than or equal to this value will be omitted from the results. The maximum supported time range in conjunction with date_range_start is one year.

filters.team_ids[] Array No

An array of team IDs. Only incidents related to these teams will be included in the results. If omitted, all teams the requestor has access to will be included in the results.

filters.priority_names[] Array No

An array of user-defined priority names. Only incidents with these priorities will be included in the results. If omitted, all priorities will be included in the results.

time_zone String No

The time zone to use for the results and grouping.

order String No

The order in which the results were sorted; asc for ascending, desc for descending.

Possible values:

  • "desc"
  • "asc"
order_by String No

The column that was used for ordering the results.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.