PagerDuty (API Key)

Overview

Use PagerDuty credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	pagerduty
Category	Monitoring & Observability
Credential Type	API Key

Step 1: Get Credentials

Log in to PagerDuty

Log in to PagerDuty at app.pagerduty.com.

Go to Integrations → Developer Tools → API Access Keys

Follow the PagerDuty API access-key guide, then go to Integrations → Developer Tools → API Access Keys (the direct URL is https://<your-subdomain>.pagerduty.com/api_access_keys).

Create a new API Key

Click ‘Create New API Key’.

Copy your API key

Copy the generated API key.

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add PagerDuty

Go to Managed Secrets > Add Provider > PagerDuty.

Enter credentials

Paste your API Key into the credential field.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.GET,
    "https://api.pagerduty.com/incidents",
    grant_id="YOUR_GRANT_ID",
    extra_headers={"Accept": "application/vnd.pagerduty+json;version=2"},
)

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
createIncidentNotificationSubscribers	send	POST	/incidents/{id}/status_updates/subscribers
createTeamNotificationSubscriptions	admin, send	POST	/teams/{id}/notification_subscriptions
createUserHandoffNotificationRule	admin, send	POST	/users/{id}/oncall_handoff_notification_rules
createUserNotificationRule	admin, send	POST	/users/{id}/notification_rules
createUserNotificationSubscriptions	admin, send	POST	/users/{id}/notification_subscriptions
createUserStatusUpdateNotificationRule	admin, send	POST	/users/{id}/status_update_notification_rules
removeIncidentNotificationSubscribers	delete, send	POST	/incidents/{id}/status_updates/unsubscribe
unsubscribeUserNotificationSubscriptions	admin, delete, send	POST	/users/{id}/notification_subscriptions/unsubscribe
updateUserHandoffNotification	admin, send	PUT	/users/{id}/oncall_handoff_notification_rules/{oncall_handoff_notification_rule_id}
updateUserNotificationRule	admin, send	PUT	/users/{id}/notification_rules/{notification_rule_id}
updateUserStatusUpdateNotificationRule	admin, send	PUT	/users/{id}/status_update_notification_rules/{status_update_notification_rule_id}
deleteAcceptedRecommendedRule	delete	DELETE	/recommendations/event_orchestrations/services/{service_id}/accepted_rules/{rule_id}
deleteAddon	delete	DELETE	/addons/{id}
deleteAlertGroupingSetting	admin, delete	DELETE	/alert_grouping_settings/{id}
deleteAutomationAction	delete	DELETE	/automation_actions/actions/{id}
deleteAutomationActionServiceAssociation	delete	DELETE	/automation_actions/actions/{id}/services/{service_id}
deleteAutomationActionTeamAssociation	admin, delete	DELETE	/automation_actions/actions/{id}/teams/{team_id}
deleteAutomationActionsRunner	delete	DELETE	/automation_actions/runners/{id}
deleteAutomationActionsRunnerTeamAssociation	admin, delete	DELETE	/automation_actions/runners/{id}/teams/{team_id}
deleteBusinessService	delete	DELETE	/business_services/{id}
deleteCacheVarOnGlobalOrch	delete	DELETE	/event_orchestrations/{id}/cache_variables/{cache_variable_id}
createAutomationActionTeamAssociation	admin, write	POST	/automation_actions/actions/{id}/teams
createAutomationActionsRunnerTeamAssociation	admin, write	POST	/automation_actions/runners/{id}/teams
createEscalationPolicy	admin, write	POST	/escalation_policies
createUserContactMethod	admin, write	POST	/users/{id}/contact_methods
updateUserContactMethod	admin, write	PUT	/users/{id}/contact_methods/{contact_method_id}
createAutomationActionInvocation	write	POST	/automation_actions/actions/{id}/invocations
createAutomationActionServiceAssocation	write	POST	/automation_actions/actions/{id}/services
createBusinessServiceAccountSubscription	write	POST	/business_services/{id}/account_subscription
createBusinessServiceNotificationSubscribers	write	POST	/business_services/{id}/subscribers
createCacheVarOnGlobalOrch	write	POST	/event_orchestrations/{id}/cache_variables
createCacheVarOnServiceOrch	write	POST	/event_orchestrations/services/{service_id}/cache_variables
createCustomFieldsFieldOption	write	POST	/incidents/custom_fields/{field_id}/field_options
createCustomShifts	write	POST	/v3/schedules/{id}/custom_shifts
getUserContactMethod	read	GET	/users/{id}/contact_methods/{contact_method_id}
getUserContactMethods	read	GET	/users/{id}/contact_methods
listEscalationPolicyAuditRecords	read	GET	/escalation_policies/{id}/audit/records
listIpAllowListAuditRecords	read	GET	/ip_allow_lists/{id}/audit/records
listSchedulesAuditRecords	read	GET	/schedules/{id}/audit/records
listSchedulesAuditRecordsV3	read	GET	/v3/schedules/{id}/audit/records