Group Incidents
Lists collections of incidents by groups.
Headers
Authorization
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
group_by
The field to group the incidents by.
applies_to_parts
Filters for incidents that apply to any of the provided parts.
created_by
Filters for incidents created by any of the provided users.
cursor
The cursor to resume iteration from. If not provided, then iteration
starts from the beginning.
custom_fields
Filters for custom fields.
limit
The maximum number of groups to return. If not set, then the default
is '10'.
limit_per_group
The maximum number of incidents to return for an individual group.
The default is '50'.
mode
The iteration mode to use, otherwise if not set, then "after" is
used.
Allowed values:
owned_by
Filters for incidents owned by any of the provided users.
pia
Filters for incidents with any of the provided PIAs.
playbooks
Filters for incidents with any of the provided playbooks.
reported_by
Filters for incidents with any of the provided reporters.
severity
Filters for incidents containing any of the provided severities.
sort_by
Comma-separated fields to sort the incidents by.
sourceDeprecated
Filters for incidents with any of the provided sources.
stage
Filters for incidents in any of the provided stages.
staged_info.is_staged
Filters for issues that are staged.
subtype
Filters for incidents with any of the provided subtypes.
sync_metadata.external_reference
Filters for issues with this specific external reference.
sync_metadata.last_sync_in.status
Filters for works with selected sync statuses.
Allowed values:
sync_metadata.last_sync_in.sync_history
Filters for works modified with selected sync history.
sync_metadata.last_sync_in.sync_unit
Filters for works modified with selected sync units.
sync_metadata.last_sync_out.status
Filters for works with selected sync statuses.
Allowed values:
sync_metadata.last_sync_out.sync_history
Filters for works modified with selected sync history.
sync_metadata.last_sync_out.sync_unit
Filters for works modified with selected sync units.
sync_metadata.origin_system
Filters for issues synced from this specific origin system.
title
Filters for incidents by the provided titles.
Response
Success.
groups
The list of groups.
next_cursor
The cursor used to iterate subsequent results in accordance to the
sort order. If not set, then no later elements exist.
prev_cursor
The cursor used to iterate preceding results in accordance to the
sort order. If not set, then no prior elements exist.