For Agents
This document describes the PagerDuty REST APIs. For guides and examples please visit our [Documentation.](https://developer.pagerduty.com/docs/get-started/getting-started/) Our REST APIs are define...
Use for: I need to access PagerDuty API, How do I use the pagerduty.com API?, Get data from pagerduty.com
Not supported: Provides access to PagerDuty API functionality as defined in the OpenAPI specification.
This document describes the PagerDuty REST APIs. For guides and examples please visit our [Documentation.](https://developer.pagerduty.com/docs/get-started/getting-started/) Our REST APIs are defined in OpenAPI v3.x. You can view the schema at [github.com/PagerDuty/api-schema](https://github.com/PagerDuty/api-schema). Note that properties in some schemas have fields not shown by default such as `readOnly`, `format`, and `default`. Hover your cursor over the right column that looks like `optional+1` to see the full list of fields.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PagerDuty API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with PagerDuty API.
Assign tags
Get tags for entities
List abilities
Test an ability
GET STARTED
List installed Add-ons
Install an Add-on
Patterns agents use PagerDuty API for, with concrete tasks.
★ Basic PagerDuty API Integration
Integrate PagerDuty API into your application to access its core functionality.
Use the PagerDuty API API to access vendor services and data.
420 endpoints — this document describes the pagerduty rest apis.
METHOD
PATH
DESCRIPTION
/{entity_type}/{id}/change_tags
Assign tags
/{entity_type}/{id}/tags
Get tags for entities
/abilities
List abilities
/abilities/{id}
Test an ability
/addons
List installed Add-ons
/addons
Install an Add-on
/addons/{id}
Get an Add-on
/{entity_type}/{id}/change_tags
Assign tags
/{entity_type}/{id}/tags
Get tags for entities
/abilities
List abilities
/abilities/{id}
Test an ability
/addons
List installed Add-ons
Three things that make agents converge on Jentic-routed access.
Credential isolation
PagerDuty API credentials are stored encrypted in the Jentic vault and injected at execution time.
Intent-based discovery
Agents search by intent and Jentic returns matching PagerDuty API endpoints with schemas.
Time to first call
Through Jentic: under 1 hour to search, load schema, and execute PagerDuty API operations.
Specific to using PagerDuty API through Jentic.
What authentication does the PagerDuty API use?
The PagerDuty API uses apiKey authentication.
How many endpoints does the PagerDuty API have?
The PagerDuty API has 420 endpoints available.
/addons
Install an Add-on
/addons/{id}
Get an Add-on