pygerduty

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 on this page — 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

pygerduty on PyPI

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

Evidence: pygerduty-0.38.3-py3-none-any.whl

Tags

More Software Development packages