Group Incidents

Lists collections of incidents by groups.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

group_bystringRequiredformat: "text"
The field to group the incidents by.
applies_to_partslist of stringsOptional
Filters for incidents that apply to any of the provided parts.
created_bylist of stringsOptional
Filters for incidents created by any of the provided users.
cursorstringOptionalformat: "text"
The cursor to resume iteration from. If not provided, then iteration starts from the beginning.
custom_fieldsobjectOptional
Filters for custom fields.
limitintegerOptional
The maximum number of groups to return. If not set, then the default is '10'.
limit_per_groupintegerOptional
The maximum number of incidents to return for an individual group. The default is '50'.
modeenumOptional
The iteration mode to use, otherwise if not set, then "after" is used.
Allowed values:
owned_bylist of stringsOptional
Filters for incidents owned by any of the provided users.
pialist of stringsOptional
Filters for incidents with any of the provided PIAs.
playbookslist of stringsOptional
Filters for incidents with any of the provided playbooks.
related_docslist of stringsOptional
Filters for incidents with any of the provided related docs.
reported_bylist of longsOptional
Filters for incidents with any of the provided reporters.
severitylist of longsOptional
Filters for incidents containing any of the provided severities.
sort_bylist of stringsOptional

Comma-separated fields to sort the incidents by.

sourcelist of longsOptionalDeprecated
Filters for incidents with any of the provided sources.
stagelist of stringsOptional
Filters for incidents in any of the provided stages.
staged_info.is_stagedbooleanOptional
Filters for issues that are staged.
subtypelist of stringsOptional
Filters for incidents with any of the provided subtypes.
sync_metadata.external_referencelist of stringsOptional
Filters for issues with this specific external reference.
sync_metadata.last_sync_in.statuslist of enumsOptional
Filters for works with selected sync statuses.
Allowed values:
sync_metadata.last_sync_in.sync_historylist of stringsOptional
Filters for works modified with selected sync history.
sync_metadata.last_sync_in.sync_unitlist of stringsOptional
Filters for works modified with selected sync units.
sync_metadata.last_sync_out.statuslist of enumsOptional
Filters for works with selected sync statuses.
Allowed values:
sync_metadata.last_sync_out.sync_historylist of stringsOptional
Filters for works modified with selected sync history.
sync_metadata.last_sync_out.sync_unitlist of stringsOptional
Filters for works modified with selected sync units.
sync_metadata.origin_systemlist of stringsOptional
Filters for issues synced from this specific origin system.
titlelist of stringsOptional
Filters for incidents by the provided titles.

Response

Success.
groupslist of objects
The list of groups.
next_cursorstring or nullformat: "text"
The cursor used to iterate subsequent results in accordance to the sort order. If not set, then no later elements exist.
prev_cursorstring or nullformat: "text"
The cursor used to iterate preceding results in accordance to the sort order. If not set, then no prior elements exist.

Errors