Rootly

Overview

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

Property	Value
Provider ID	rootly
Category	Monitoring & Observability
Credential Type	Bearer Token

Step 1: Get Credentials

Log in to Rootly

Log in to Rootly at rootly.com.

Go to Account → API Keys

Go to Account → API Keys at rootly.com/account/api-keys.

Generate a new key

Click ‘Generate New 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 Rootly

Go to Managed Secrets > Add Provider > Rootly.

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.rootly.com/v1/incidents",
    grant_id="YOUR_GRANT_ID",
)

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
createAiChat	send	POST	/v1/ai/chat
createUserEmailAddress	admin, send	POST	/v1/users/{user_id}/email_addresses
createUserNotificationRule	admin, send	POST	/v1/users/{user_id}/notification_rules
resendUserEmailAddressVerification	admin, send	POST	/v1/email_addresses/{id}/resend_verification
updateUserEmailAddress	admin, send	PUT	/v1/email_addresses/{id}
updateUserNotificationRule	admin, send	PUT	/v1/notification_rules/{id}
verifyUserEmailAddress	admin, send	POST	/v1/email_addresses/{id}/verify
bulkDeleteCatalogEntities	delete, write	POST	/v1/catalogs/{catalog_id}/entities/bulk_delete
deleteAiChatSession	delete	DELETE	/v1/ai/chat/sessions/{id}
deleteAlertEvent	delete	DELETE	/v1/alert_events/{id}
deleteAlertField	delete	DELETE	/v1/alert_fields/{id}
deleteAlertGroup	admin, delete	DELETE	/v1/alert_groups/{id}
deleteAlertRoute	delete	DELETE	/v1/alert_routes/{id}
deleteAlertRoutingRule	delete	DELETE	/v1/alert_routing_rules/{id}
deleteAlertUrgency	delete	DELETE	/v1/alert_urgencies/{id}
deleteAlertsSource	delete	DELETE	/v1/alert_sources/{id}
deleteApiKey	admin, delete	DELETE	/v1/api_keys/{id}
deleteAuthorization	admin, delete	DELETE	/v1/authorizations/{id}
deleteCatalog	delete	DELETE	/v1/catalogs/{id}
deleteCatalogChecklistTemplate	delete	DELETE	/v1/catalog_checklist_templates/{id}
deleteCatalogEntity	delete	DELETE	/v1/catalog_entities/{id}
createEscalationLevel	admin, write	POST	/v1/escalation_policies/{escalation_policy_id}/escalation_levels
createEscalationLevelPaths	admin, write	POST	/v1/escalation_paths/{escalation_policy_path_id}/escalation_levels
createEscalationPath	admin, write	POST	/v1/escalation_policies/{escalation_policy_id}/escalation_paths
createIncidentPermissionSetBoolean	admin, write	POST	/v1/incident_permission_sets/{incident_permission_set_id}/booleans
createIncidentPermissionSetResource	admin, write	POST	/v1/incident_permission_sets/{incident_permission_set_id}/resources
createAlertEvent	write	POST	/v1/alerts/{alert_id}/events
createCatalogEntity	write	POST	/v1/catalogs/{catalog_id}/entities
createCatalogEntityProperty	write	POST	/v1/catalog_entities/{catalog_entity_id}/properties
createCatalogProperty	write	POST	/v1/catalogs/{catalog_id}/properties
createCustomFieldOption	write	POST	/v1/custom_fields/{custom_field_id}/options
createDashboardPanel	write	POST	/v1/dashboards/{dashboard_id}/panels
createEdgeConnectorAction	write	POST	/v1/edge_connectors/{edge_connector_id}/actions
createFormFieldOption	write	POST	/v1/form_fields/{form_field_id}/options
getIncidentRoleTask	read	GET	/v1/incident_role_tasks/{id}
getMeetingRecording	read	GET	/v1/meeting_recordings/{id}
getPlaybookTask	read	GET	/v1/playbook_tasks/{id}
getUserEmailAddresses	read	GET	/v1/users/{user_id}/email_addresses
getWebhooksEndpoint	read	GET	/v1/webhooks/endpoints/{id}
getWorkflowTask	read	GET	/v1/workflow_tasks/{id}