---
id: pdpyras
version: "5.4.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# pdpyras — PagerDuty Python REST API Sessions.

License: permissive · Maintenance: aging · Downloads: 3.5M/mo

## What it is and what it does

pdpyras is a Python client library that simplifies interaction with PagerDuty's REST API by building on top of the Requests library. It handles authentication and provides a Session-based interface for making API calls, reducing boilerplate code needed to work with PagerDuty's incident management, escalation policies, and other resources.

The package is built on two core dependencies—requests and urllib3—and targets Python 3.6 and later. It sits in the top 5000 PyPI packages by download volume, indicating real-world adoption in operations and incident management workflows. The aging maintenance status (437 days since last release) suggests the package may be in stable maintenance rather than active development, so it's worth checking whether your use case aligns with the current API coverage.

Use it for:

- Automate incident creation and management workflows from Python applications or scripts
- Query PagerDuty data (incidents, users, escalation policies) programmatically for reporting or integration
- Build custom dashboards or monitoring tools that pull live PagerDuty state into your infrastructure
- Integrate PagerDuty with third-party systems or internal tools that need to trigger or acknowledge incidents

## Worth the install?

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

A REST API client library for PagerDuty that wraps the Requests Session class to simplify authentication and API interactions with PagerDuty's services.

Yes, if you need to interact with PagerDuty's API from Python. The package has low install friction, permissive licensing, no known vulnerabilities, and solid download volume indicating real-world use. The aging maintenance status is a minor concern—verify that the current API version meets your needs and that you're comfortable with a package that may not receive frequent updates.

## Install

pip install pdpyras
uv add pdpyras
poetry add pdpyras

## Installing pdpyras

Before you install: Low install friction with a pure-Python wheel distribution. Maintenance status is aging—last release was 437 days ago—but the package remains functional and supports current Python versions (3.6+).

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install pdpyras

from pdpyras import APISession

session = APISession(token='your-api-token')
incidents = session.list_all('incidents')

Requires a valid PagerDuty API token to authenticate; PagerDuty account access is necessary.

Verify before relying:

- Whether the package is actively maintained or in stable maintenance mode despite the aging status
- API coverage completeness relative to current PagerDuty API endpoints

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 3.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pagerduty api client, pagerduty rest api python, pagerduty python sdk, incident management api client, pagerduty session wrapper, incident-management, api-client

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