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

# Sentry Integration

> Connect Sentry so operators can review safe organization and project context in Woes.

# Sentry Integration

<img src="https://mintcdn.com/woes/SjmqB9Aiw359c6aC/images/integrations/sentry-logo.svg?fit=max&auto=format&n=SjmqB9Aiw359c6aC&q=85&s=e03210e62f1152f3492f3819f6935319" alt="Sentry logo" width="56" height="56" data-path="images/integrations/sentry-logo.svg" />

Sentry connects error-monitoring context to Woes for operator triage. The
current integration is an operator-only connection foundation: admins can
connect a Sentry organization, review safe organization/user metadata, list
available projects, and disconnect the workspace connection.

## At A Glance

| Use Sentry for                                                                            | Where it appears       |
| ----------------------------------------------------------------------------------------- | ---------------------- |
| Operator visibility into the connected Sentry organization, user, and available projects. | Integrations > Sentry. |

## What It Does

| Capability               | What you can do                                                                |
| ------------------------ | ------------------------------------------------------------------------------ |
| Connect Sentry           | Authorize a Sentry organization from Workspace Settings.                       |
| Review connection status | See whether Sentry is connected and which organization/user authorized it.     |
| List projects            | Refresh and review the Sentry projects available to the connection.            |
| Keep it operator-only    | Sentry details stay out of the customer widget and public API responses.       |
| Disconnect               | Remove the Woes connection when operators should no longer use Sentry context. |

## Current Limits

The current Sentry integration does not yet:

* Attach Sentry events or issues to Woes conversations.
* Search error events by customer, release, environment, route, or fingerprint.
* Create Woes issues from Sentry alerts.
* Expose stack traces, request payloads, breadcrumbs, or event metadata to
  customers.
* Provide automation actions based on Sentry events.

## Setup

<Steps>
  <Step title="Open Integrations">
    In Woes, go to **Workspace Settings -> Integrations**.
  </Step>

  <Step title="Connect Sentry">
    Open **Sentry** and click **Connect**.
  </Step>

  <Step title="Authorize access">
    Approve the Sentry organization you want Woes operators to reference.
  </Step>

  <Step title="Review projects">
    Return to Woes, open the Sentry integration, and refresh projects to confirm
    the expected organization is connected.
  </Step>
</Steps>

## Data And Privacy

Sentry is not a customer support channel and is not a Context Library source.
Woes keeps Sentry connection details server-side and returns only safe status,
organization, user, and project metadata to the workspace UI.

<Warning>
  Do not copy stack traces, request bodies, access tokens, or customer-private
  Sentry event data into customer replies unless your team has reviewed and
  redacted it.
</Warning>

## Troubleshooting

| Issue                               | What to check                                                                             |
| ----------------------------------- | ----------------------------------------------------------------------------------------- |
| The Sentry card says setup needed   | Ask a workspace admin or Woes support to confirm Sentry is enabled for the workspace.     |
| The wrong organization is connected | Disconnect Sentry from Woes, then reconnect and choose the correct organization.          |
| Projects are missing                | Refresh the project list and confirm the connected Sentry user can access those projects. |
| Operators need event-level evidence | Use Sentry directly for now; event attachment and search are not available in Woes yet.   |

## Related Docs

* [Integrations Catalog](/integrations-catalog/overview)
* [Issues](/platform/issues)
* [Data Privacy](/security/data-privacy)