get_incidents
Retrieve PagerDuty incidents by applying filters or fetch details for a specific incident ID. Filter by status, services, teams, or time range, and include notes or related incidents for comprehensive incident management.
Instructions
Get PagerDuty incidents by filters or get details for a specific incident ID or number.
Args:
incident_id (str): The incident ID or number to retrieve (optional, cannot be used with any other filters).
current_user_context (bool): Filter by current user's context (default: True). Not used if incident_id is provided.
service_ids (List[str]): Filter by services (optional, excludes current_user_context). Not used if incident_id is provided.
team_ids (List[str]): Filter by teams (optional, excludes current_user_context). Not used if incident_id is provided.
statuses (List[str]): Filter by status (optional). Not used if incident_id is provided. Must be input as a list of strings, valid values are ["triggered", "acknowledged", "resolved"].
since (str): Start of query range in ISO8601 format (default range: 1 month, max range: 6 months). Not used if incident_id is provided.
until (str): End of query range in ISO8601 format (default range: 1 month, max range: 6 months). Not used if incident_id is provided.
limit (int): Max results (optional). Not used if incident_id is provided.
include_past_incidents (Optional[bool]): If True and incident_id is provided, includes similar past incidents
in the response. Defaults to False. Cannot be used without incident_id.
include_related_incidents (Optional[bool]): If True and incident_id is provided, includes related incidents
impacting other services/responders in the response. Defaults to False. Cannot be used without incident_id.
include_notes (Optional[bool]): If True, includes notes for each incident in the response. Defaults to False.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| current_user_context | No | ||
| incident_id | No | ||
| include_notes | No | ||
| include_past_incidents | No | ||
| include_related_incidents | No | ||
| limit | No | ||
| service_ids | No | ||
| since | No | ||
| statuses | No | ||
| team_ids | No | ||
| until | No |