---
id: pygerduty
version: "0.38.3"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pygerduty — Python Client Library for PagerDuty's REST API

License: permissive · Maintenance: abandoned · Downloads: 232.2K/mo

## What it is and what it does

Pygerduty is a thin wrapper around PagerDuty's REST and Events APIs, allowing Python developers to programmatically manage schedules, users, incidents, and overrides. The library provides standard resource methods (list, show, create, update, delete) that map to PagerDuty's API endpoints. It was originally built for API v1 and has been partially updated for v2; the codebase is split into separate modules for v2 REST logic, Events API logic, and shared utilities.

The package is no longer actively maintained—the last release was in 2020 and the repository has seen no commits since 2023. While it remains functional for basic use cases, it is not updated to follow PagerDuty's current API evolution, and backwards compatibility is not guaranteed between versions. Developers should verify that the v2 implementation covers their specific use case before relying on it in production.

Use it for:

- Automate on-call schedule management and retrieve user schedules from PagerDuty
- Programmatically create and manage schedule overrides for temporary coverage
- Query and acknowledge triggered incidents in bulk or by user
- Build internal tools that integrate PagerDuty incident data with other systems
- Send events to PagerDuty via the Events API for alerting workflows

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Pygerduty is a Python client library for PagerDuty's REST API and Events API, providing thin wrapper methods to list, show, create, update, and delete PagerDuty resources.

No—not recommended for new projects. The package is abandoned (last release 2020-04-22, no commits since 2023-05-09) and only partially supports PagerDuty's v2 API. While it has low install friction and a permissive MIT license, the lack of maintenance and incomplete API coverage make it a poor choice for production use. Consider using PagerDuty's official client libraries or a more actively maintained alternative.

## Install

pip install pygerduty
uv add pygerduty
poetry add pygerduty

## Installing pygerduty

Before you install: Low install friction with a single runtime dependency (six). However, the package is abandoned—last release was 2020-04-22 and no commits since 2023-05-09. It was originally written for v1 API and is only partially updated for v2, with backwards compatibility not guaranteed.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute it freely with minimal restrictions.

Quickstart:

pip install pygerduty

import pygerduty.v2
pager = pygerduty.v2.PagerDuty("SOMEAPIKEY123456")
for schedule in pager.schedules.list():
    print(schedule.id, schedule.name)

Requires a valid PagerDuty API key. The library supports Python 2.7 and Python 3.6+, though it is no longer actively maintained.

Verify before relying:

- Whether v2 API support is complete enough for current PagerDuty API versions
- Compatibility with modern Python versions beyond 3.6
- Whether the Events API module is fully functional

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 232.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pagerduty api client, pagerduty python library, incident management api, on-call scheduling automation, pagerduty rest api wrapper, schedule management python, pagerduty events api, pagerduty-integration, abandoned

[View on SkillFed](https://skillfed.io/packages/pygerduty) · [View on PyPI](https://pypi.org/project/pygerduty/)