sym.sdk.integrations.pagerduty.get_incidents

sym.sdk.integrations.pagerduty.get_incidents(*, assignees: Optional[List[sym.sdk.user.User]] = None, service_ids: Optional[List[str]] = None, statuses: Optional[List[sym.sdk.integrations.pagerduty.PagerDutyStatus]] = None, urgencies: Optional[List[sym.sdk.integrations.pagerduty.PagerDutyUrgency]] = None, since: Optional[str] = None, until: Optional[str] = None) → List[Dict[str, Any]]

Retrieve incidents from PagerDuty based on provided filter params.

Parameters

  • assignees – When provided, only incidents assigned to one of these users will be returned.

  • service_ids – When provided, only incidents in one of these services will be returned.

  • statuses – When provided, only incidents with these statuses will be returned. Defaults to ["TRIGGERED", "ACKNOWLEDGED"]. Note: If assignees is provided, statuses cannot contain RESOLVED.

  • urgencies – When provided, only incidents with these urgencies will be returned. Defaults to ["HIGH"].

  • since – When provided, only incidents on or after since will be returned. Defaults to 24 hours ago if not provided. Must be an ISO-8601 datetime.

  • until – When provided, only incidents before until will be returned. Defaults to 1 month after since if not provided. Must be an ISO-8601 datetime.

Returns

A list of dictionaries, with each dictionary representing an incident in PagerDuty’s incident structure. See here for details.