> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tierity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty

> View active incidents, on-call schedules, and service health from PagerDuty in Tierity's Security Workbench.

## Overview

The PagerDuty integration surfaces active incidents and on-call schedule data in Tierity so security teams can monitor operational incidents alongside vulnerability findings and security events — without switching tools.

## Prerequisites

* A PagerDuty account
* Admin or Account Owner access in PagerDuty to create API keys
* Manage access (or higher) in Tierity

## Credentials required

| Field | Description |
| - | - |
| **API Key** | A PagerDuty REST API key — either a General Access key or a Read-only key |

A read-only key is sufficient for pulling incident and schedule data into Tierity.

## Setup

**1. Create a PagerDuty API key**

1. In PagerDuty, go to **Integrations → API Access Keys**.
2. Click **Create New API Key**.
3. Give it a description like "Tierity".
4. Select **Read-only API Key** (Tierity only needs read access).
5. Copy the generated key.

**2. Configure in Tierity**

1. Go to **Config → Integrations → PagerDuty**.
2. Paste your **API Key**.
3. Click **Save & Test** — Tierity verifies access by listing your PagerDuty services.

## What's available

| Feature | Description |
| - | - |
| **Active incidents** | Count of open and acknowledged incidents, broken out by urgency |
| **Incident list** | Filterable list of incidents with service, status, and triggered time |
| **On-call schedules** | Who is currently on call for each schedule |
| **Services** | Health summary across your PagerDuty services |

## Workbench card

The PagerDuty workbench card on your Security Workbench shows:

* Count of triggered (unacknowledged) and acknowledged incidents
* Current on-call responder name for your primary schedule
* A **View all** link to the full incident list

## Incident urgency mapping

PagerDuty incidents have a `high` or `low` urgency. Tierity displays them as:

| PagerDuty urgency | Displayed as |
| - | - |
| `high` | Critical |
| `low` | Low |

## Disconnecting

1. Go to **Config → Integrations → PagerDuty**.
2. Click **Disconnect**.
3. Confirm.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.