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

# Rootly

> Connect Rootly to give ewake read access to your incidents so it can pull live incident context into investigations.

<Info>
  **What you'll get:** ewake can read your Rootly incidents and match the one tied to the Slack channel it's working in, surfacing severity, status, and summary directly in the investigation, without anyone pasting context by hand.
</Info>

***

## Prerequisites

* A Rootly account with permission to create API keys
* An API key with **read access to incidents**
* Access to your ewake dashboard

***

## Configuration

<Steps>
  <Step title="Generate an API key in Rootly">
    In Rootly, go to **Configuration** → **API Keys** → click **Generate New API Key**.

    Give it **observer** (read-only) permissions, ewake only needs read access to incidents.

    <Note>
      Copy the key now, you won't be able to see it again after closing the screen.
    </Note>
  </Step>

  <Step title="Open the Rootly integration in ewake">
    In your ewake dashboard, go to **Integrations** → **Rootly** → click **Configure**.

    <img src="https://mintcdn.com/ewakeai/RRnFF3HXBXV95pZ2/images/integrations/alerting/rootly/connect-modal.png?fit=max&auto=format&n=RRnFF3HXBXV95pZ2&q=85&s=2074d1f7cfa799ce720f8574e3561878" alt="Connect to Rootly modal in ewake" style={{ maxHeight: "320px", objectFit: "cover", objectPosition: "top", borderRadius: "8px" }} width="587" height="426" data-path="images/integrations/alerting/rootly/connect-modal.png" />
  </Step>

  <Step title="Enter your API key">
    | Field       | Value                       |
    | ----------- | --------------------------- |
    | **API Key** | The key generated in Step 1 |
  </Step>

  <Step title="Test and save">
    Click **Test Configuration** to verify the connection, then click **Save**.

    <Check>
      Rootly is connected. Ewake can now pull incident context during investigations.
    </Check>
  </Step>
</Steps>

***

<Note>
  Ewake only requires **read-only** access to Rootly. It never declares, edits, or resolves incidents.
</Note>