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

# Pagertree Provider

> The Pagertree Provider facilitates interactions with the Pagertree API, allowing the retrieval and management of alerts.

## Authentication

This provider requires authentication.

* **api\_token**: Your pagertree APIToken (required: True, sensitive: True)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

* **authenticated**: The user can connect to the server and is authenticated using their API\_Key (mandatory)

## In workflows

This provider can be used in workflows.

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query pagertree
      provider: pagertree
      config: "{{ provider.my_provider_name }}"
      with:
        title: {value}  # Title of the alert.
        urgency: {value}  # low|medium|high|critical
        incident: {value}  # True if the alert is an incident
        severities: {value}  # SEV-1|SEV-2|SEV-3|SEV-4|SEV-5|SEV_UNKNOWN
        incident_message: {value}  # Message to be displayed in the incident
        description: {value}  # UTF-8 string of custom message for alert. Shown in incident description
        status: {value}  # alert status to send
        destination_team_ids: {value}  # destination team_ids to send alert to
        destination_router_ids: {value}  # destination router_ids to send alert to
        destination_account_user_ids: {value}  # destination account_users_ids to send alert to
        # Additional parameters to be passed
```

If you need workflow examples with this provider, please raise a [GitHub issue](https://github.com/keephq/keep/issues).

## Connecting with the Provider

* To interact with the Pagertree API, you need to provide an api\_token.
* You can view and manage your API keys on your [User Settings](https://app.pagertree.com/user/settings) page.

## Notes

*This provider uses the Pagertree API to send alerts or mark them as incidents based on the parameters provided. Depending on whether an incident is flagged as true, it either calls `__send_alert` or `__send_incident` method.*

## Useful Links

* Pagertree API documentation: [Pagertree API](https://pagertree.com/docs)
* Pagertree Authentication: [Authentication](https://pagertree.com/docs/api/authentication)
* Pagertree Alerts: [Alerts & Incident](https://pagertree.com/docs/api/alerts)