Sentry Integration
Connection
- Base URL:
https://sentry.io/api/0
- Org slug: discovered from the token's accessible organizations by default. Configure
SENTRY_ORG_SLUG or pass orgSlug to the sentry action when a user needs a specific Sentry organization.
- Auth:
Authorization: Bearer $SENTRY_SERVER_TOKEN (internal integration token, NOT user auth token or DSN)
- Env vars:
SENTRY_SERVER_TOKEN (falls back to SENTRY_AUTH_TOKEN)
- Caching: 5-minute in-memory cache, max 100 entries
- Scopes needed:
alerts:read, event:read, org:read, project:distribution, project:read, team:read
Server Lib & API Routes
- File:
server/lib/sentry.ts
Exported Functions
| Function |
Description |
listProjects() |
List all projects in the org |
listIssues(projectSlug?, query?, statsPeriod?) |
List issues (project-scoped or org-wide) |
getIssueEvents(issueId) |
Events for a specific issue |
getOrganizationStats(statsPeriod?, category?) |
Org-level error stats over time |
Agent Action
Use sentry for all agent-facing Sentry work. Do not call /api/sentry/*
directly from the agent.
| Mode |
Args |
Description |
organizations |
|
List organizations visible to the token |
issues |
statsPeriod, project, query, orgSlug |
Frequent issues, sorted by frequency |
projects |
orgSlug |
List projects |
issue-events |
issueId, orgSlug |
Events for a specific issue |
stats |
statsPeriod, category, orgSlug |
Org-level stats |
API Routes
| Route |
Description |
GET /api/sentry/projects |
List projects |
GET /api/sentry/issues |
List issues |
GET /api/sentry/issue-events |
Events for an issue |
GET /api/sentry/stats |
Org error stats |
Dashboard
/adhoc/sentry — Sentry Error Health dashboard
Key Patterns & Gotchas
- Token type: This is a custom/internal integration token from Sentry's integration settings TOKEN table (not the Client Secret)
getOrganizationStats uses stats_v2 endpoint with field=sum(quantity), groupBy=outcome, default category error- If the default org is wrong, pass
orgSlug explicitly in the action call.
