Project-level rules (CREATE_PROJECT_RULE) and org-level metric alerts (CREATE_ORGANIZATION_ALERT_RULE) are different
Conditions, actions, and filters use specific JSON schemas; check Sentry docs for valid types
frequency
is in minutes; setting too low causes alert fatigue
actionMatch
defaults may vary; explicitly set to avoid unexpected behavior
4. Manage Releases
When to use
User wants to create, track, or manage release versions
Tool sequence
:
SENTRY_LIST_ORGANIZATION_RELEASES
- List existing releases [Optional]
SENTRY_CREATE_RELEASE_FOR_ORGANIZATION
- Create a new release [Required]
SENTRY_UPDATE_RELEASE_DETAILS_FOR_ORGANIZATION
- Update release metadata [Optional]
SENTRY_CREATE_RELEASE_DEPLOY_FOR_ORG
- Record a deployment for a release [Optional]
SENTRY_UPLOAD_RELEASE_FILE_TO_ORGANIZATION
- Upload source maps or files [Optional]
Key parameters
:
version
Release version string (e.g., '1.0.0', commit SHA)
projects
Array of project slugs this release belongs to
dateReleased
Release timestamp (ISO 8601)
environment
Deployment environment name (e.g., 'production', 'staging')
Pitfalls
:
Release versions must be unique within an organization
Releases can span multiple projects; use the
projects
array
Deploying a release is separate from creating it; use CREATE_RELEASE_DEPLOY
Source map uploads require the release to exist first
5. Monitor Organization and Teams
When to use
User wants to view org structure, teams, or member lists
Tool sequence
:
SENTRY_GET_ORGANIZATION_DETAILS
or
SENTRY_GET_ORGANIZATION_BY_ID_OR_SLUG
- Get org info [Required]
SENTRY_LIST_TEAMS_IN_ORGANIZATION
- List all teams [Optional]
SENTRY_LIST_ORGANIZATION_MEMBERS
- List org members [Optional]
SENTRY_GET_PROJECT_LIST
- List all accessible projects [Optional]
Key parameters
:
organization_id_or_slug
Organization identifier
cursor
Pagination cursor for large result sets
Pitfalls
:
Organization slugs are URL-safe identifiers, not display names
Member lists may be paginated; follow cursor pagination
Team and member visibility depends on the authenticated user's permissions
6. Manage Monitors (Cron Monitoring)
When to use
User wants to update cron job monitoring configuration
Tool sequence
:
SENTRY_UPDATE_A_MONITOR
- Update monitor configuration [Required]
Key parameters
:
organization_id_or_slug
Organization identifier
monitor_id_or_slug
Monitor identifier
name
Monitor display name
schedule
Cron schedule expression or interval
checkin_margin
Grace period in minutes for late check-ins
max_runtime
Maximum expected runtime in minutes
Pitfalls
:
Monitor slugs are auto-generated from the name; use slug for API calls
Schedule changes take effect immediately
Missing check-ins trigger alerts after the margin period
Common Patterns
ID Resolution
Organization name -> Slug
:
1. Call SENTRY_GET_ORGANIZATION_DETAILS
2. Extract slug field from response
Project name -> Slug
:
1. Call SENTRY_RETRIEVE_ORGANIZATION_PROJECTS
2. Find project by name, extract slug
Pagination
Sentry uses cursor-based pagination with
Link
headers
Check response for cursor values
Pass cursor in next request until no more pages
Search Query Syntax
is:unresolved
- Unresolved issues
is:resolved
- Resolved issues
assigned:me
- Assigned to current user
assigned:team-slug
- Assigned to a team
!has:release
- Issues without a release
first-release:1.0.0
- Issues first seen in release
times-seen:>100
- Seen more than 100 times
browser:Chrome
- Filter by browser tag
Known Pitfalls
ID Formats
:
Organization: use slug (e.g., 'my-org'), not display name
Project: use slug (e.g., 'my-project'), not display name
Issue IDs: numeric integers
Event IDs: UUIDs (32-char hex strings)
Permissions
:
API token scopes must match the operations being performed
Organization-level operations require org-level permissions
Project-level operations require project access
Rate Limits
:
Sentry enforces per-organization rate limits
Implement backoff on 429 responses
Bulk operations should be staggered
Quick Reference
Task
Tool Slug
Key Params
List org issues
SENTRY_LIST_AN_ORGANIZATIONS_ISSUES
organization_id_or_slug, query
Get issue details
SENTRY_GET_ORGANIZATION_ISSUE_DETAILS
organization_id_or_slug, issue_id
List issue events
SENTRY_LIST_AN_ISSUES_EVENTS
issue_id
Get event details
SENTRY_RETRIEVE_AN_ISSUE_EVENT
organization_id_or_slug, event_id
List project issues
SENTRY_RETRIEVE_PROJECT_ISSUES_LIST
organization_id_or_slug, project_id_or_slug
List projects
SENTRY_RETRIEVE_ORGANIZATION_PROJECTS
organization_id_or_slug
Get org details
SENTRY_GET_ORGANIZATION_DETAILS
organization_id_or_slug
List teams
SENTRY_LIST_TEAMS_IN_ORGANIZATION
organization_id_or_slug
List members
SENTRY_LIST_ORGANIZATION_MEMBERS
organization_id_or_slug
Create alert rule
SENTRY_CREATE_PROJECT_RULE_FOR_ALERTS
organization_id_or_slug, project_id_or_slug
Create metric alert
SENTRY_CREATE_ORGANIZATION_ALERT_RULE
organization_id_or_slug
Create release
SENTRY_CREATE_RELEASE_FOR_ORGANIZATION
organization_id_or_slug, version
Deploy release
SENTRY_CREATE_RELEASE_DEPLOY_FOR_ORG
organization_id_or_slug, version
List releases
SENTRY_LIST_ORGANIZATION_RELEASES
organization_id_or_slug
Update monitor
SENTRY_UPDATE_A_MONITOR
organization_id_or_slug, monitor_id_or_slug
Powered by
Composio