PagerDuty Connector

Overview

The PagerDuty connector enables AI Team members to interact with your PagerDuty account for incident management and on-call coordination. By connecting PagerDuty to AI Team, AI teammates can query incidents, check on-call schedules, manage services and teams, and help coordinate incident response.

The connector provides access to incidents, services, teams, schedules, escalation policies, and users, allowing AI teammates to help with incident investigation, on-call management, and response coordination.

Add the PagerDuty Connector

To add the PagerDuty connector, you obtain a REST API token from PagerDuty and configure it in Edge Delta.

Prerequisites

Before configuring the connector, ensure you have:

• PagerDuty account with appropriate permissions
• Ability to create API tokens in PagerDuty

Configuration Steps

For detailed setup instructions including webhook configuration, see the PagerDuty Integration Guide.

General Options

PagerDuty Token

REST API token for authenticating with PagerDuty. To create an API token, click your profile image and select My Profile → User Settings tab → Create API User Token.

Recommended: Create a dedicated PagerDuty user for AI Team to track actions performed by AI teammates.

Format: REST API token string

Webhook URL

URL for receiving PagerDuty events in Edge Delta. Copy this URL and configure it as a webhook in PagerDuty to receive incident notifications and updates.

Optional: Webhooks are not required for AI teammates to query PagerDuty data, but enable real-time incident notifications.

Tools

list_incidents

List incidents with optional filtering.

get_incident

Get details of a specific incident.

create_incident

Create a new incident.

manage_incidents

Manage one or more incidents by changing status, urgency, assignment, or escalation level.

add_responders

Add responders to an incident.

add_note_to_incident

Add a note to an incident.

list_services

List all services with optional filtering.

get_service

Get details for a specific service.

create_service

Create a new service.

update_service

Update an existing service.

list_teams

List teams based on query parameters.

get_team

Get details of a specific team.

list_team_members

List members of a team.

create_team

Create a new team.

update_team

Update a team.

delete_team

Delete a team.

add_team_member

Add a user to a team.

remove_team_member

Remove a user from a team.

get_user_data

Get the current user’s data including name, role, ID, and teams.

list_users

List users with optional filtering by name and team IDs.

list_schedules

List schedules with optional filtering.

get_schedule

Get details of a specific schedule.

list_schedule_users

List users in a schedule.

create_schedule_override

Create an override for a schedule.

list_oncalls

List on-call schedules with optional filtering.

list_escalation_policies

List escalation policies with optional filtering.

get_escalation_policy

Get details of a specific escalation policy.

How to Use the PagerDuty Connector

The PagerDuty connector integrates with AI Team, enabling AI teammates to manage incidents and coordinate response based on natural language queries. Once configured, AI teammates can query incident status, check on-call schedules, and help manage incident response.

Use Case: Incident Investigation

AI teammates can help investigate incidents by retrieving incident details, analyzing context, and checking related information. For example, when asked about a specific incident, the AI can retrieve incident details, check who’s assigned, review incident notes and timeline, and identify related incidents or services.

Use Case: On-Call Management

AI teammates can help manage on-call schedules and rotations. When asked about on-call status, the AI can check who’s currently on-call for specific services, review upcoming schedule changes, list escalation policies, and help plan schedule overrides.

Use Case: Incident Response

AI teammates can help coordinate incident response by managing incident status, adding notes with investigation findings, assigning responders, and updating incident urgency based on impact.

Troubleshooting

Authentication errors: Verify your PagerDuty API token is correct and hasn’t expired. Check that the token has appropriate permissions for the operations you need.

Permission errors: Some operations require additional permissions. Verify your API token has write access if you need to create or update incidents, services, or teams.

Webhook not receiving events: Verify the webhook URL is correctly configured in PagerDuty. Check that the webhook is enabled and subscribed to the appropriate event types.

Next Steps

• Complete PagerDuty Integration Setup for webhook configuration
• Learn about creating custom teammates that can use this connector
• Explore other connectors to integrate additional tools

For additional help, visit AI Team Support.