Sentry API

Use the Sentry API via direct curl calls to manage error tracking, issues, projects, and releases.

Official docs: https://docs.sentry.io/api/

When to Use

Use this skill when you need to:

• List and search issues - find errors and exceptions
• Resolve or ignore issues - manage issue status
• View issue details - get stack traces and event data
• Manage projects - list and configure projects
• Track releases - create and monitor releases
• View events - get detailed error events

Prerequisites

1. Connect your Sentry account at vm0 Settings > Connectors and click sentry
2. The SENTRY_TOKEN environment variable is automatically configured

Verify authentication:

bash -c 'curl -s "https://sentry.io/api/0/organizations/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[0] | {slug, name}'

Discovering Your Organization Slug

Most endpoints require your organization slug. Get it from the organizations endpoint above — the slug field is what you need.

Important: When using $VAR in a command that pipes to another command, wrap the command containing $VAR in bash -c '...'. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.

bash -c 'curl -s "https://api.example.com" -H "Authorization: Bearer $API_KEY"'

How to Use

All examples below assume SENTRY_TOKEN is set. Replace my-org with your actual organization slug from the prerequisites step.

Base URL: https://sentry.io/api/0

1. List Organizations

Get all organizations you have access to:

bash -c 'curl -s "https://sentry.io/api/0/organizations/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {slug, name, dateCreated}'

2. List Your Projects

Get all projects you have access to:

bash -c 'curl -s "https://sentry.io/api/0/projects/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {slug, name, platform, dateCreated}'

3. Get Project Details

Get details for a specific project:

Note: Replace my-org with your organization slug and my-project with your actual project slug from the "List Your Projects" output.

ORG=my-org PROJECT=my-project bash -c 'curl -s "https://sentry.io/api/0/projects/$ORG/$PROJECT/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '{slug, name, platform, status, dateCreated}'

4. List Organization Issues

Get all issues across the organization:

Note: Replace my-org with your organization slug.

ORG=my-org bash -c 'curl -s "https://sentry.io/api/0/organizations/$ORG/issues/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {id, shortId, title, culprit, status, count, userCount, firstSeen, lastSeen}'

Query parameters:

• query=is:unresolved - Filter by status
• query=error.type:TypeError - Filter by error type
• sort=date - Sort by last seen (default)
• sort=new - Sort by first seen
• sort=freq - Sort by event count

5. List Project Issues

Get issues for a specific project:

Note: Replace my-org and my-project with your actual values.

ORG=my-org PROJECT=my-project bash -c 'curl -s "https://sentry.io/api/0/projects/$ORG/$PROJECT/issues/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {id, shortId, title, status, count, lastSeen}'

6. Search Issues

Search issues with query:

Note: Replace my-org with your organization slug.

ORG=my-org bash -c 'curl -s -G "https://sentry.io/api/0/organizations/$ORG/issues/" -H "Authorization: Bearer $SENTRY_TOKEN" --data-urlencode "query=is:unresolved level:error"' | jq '.[] | {shortId, title, level, count}'

Common query filters:

• is:unresolved / is:resolved / is:ignored - By status
• level:error / level:warning / level:info - By level
• assigned:me / assigned:none - By assignee
• release:1.0.0 - By release version

7. Get Issue Details

Get details for a specific issue:

Note: Replace my-org with your organization slug and 123456789 with an actual issue ID from the "List Issues" output (use the id field, not shortId).

ORG=my-org ISSUE_ID=123456789 bash -c 'curl -s "https://sentry.io/api/0/organizations/$ORG/issues/$ISSUE_ID/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '{id, shortId, title, culprit, status, level, count, userCount, firstSeen, lastSeen, assignedTo}'

8. Get Latest Event for Issue

Get the most recent event for an issue:

Note: Replace my-org with your organization slug and 123456789 with an actual issue ID.

ORG=my-org ISSUE_ID=123456789 bash -c 'curl -s "https://sentry.io/api/0/organizations/$ORG/issues/$ISSUE_ID/events/latest/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '{eventID, message, platform, dateCreated, tags, contexts}'

9. List Issue Events

Get all events for an issue:

Note: Replace my-org with your organization slug and 123456789 with an actual issue ID.

ORG=my-org ISSUE_ID=123456789 bash -c 'curl -s "https://sentry.io/api/0/organizations/$ORG/issues/$ISSUE_ID/events/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {eventID, message, dateCreated}'

10. Resolve Issue

Mark an issue as resolved:

Note: Replace my-org with your organization slug and 123456789 with an actual issue ID.

ORG=my-org ISSUE_ID=123456789 bash -c 'curl -s -X PUT "https://sentry.io/api/0/organizations/$ORG/issues/$ISSUE_ID/" -H "Authorization: Bearer $SENTRY_TOKEN" -H "Content-Type: application/json" -d "{\"status\":\"resolved\"}"' | jq '{id, shortId, status}'

11. Ignore Issue

Ignore an issue:

Note: Replace my-org with your organization slug and 123456789 with an actual issue ID.

ORG=my-org ISSUE_ID=123456789 bash -c 'curl -s -X PUT "https://sentry.io/api/0/organizations/$ORG/issues/$ISSUE_ID/" -H "Authorization: Bearer $SENTRY_TOKEN" -H "Content-Type: application/json" -d "{\"status\":\"ignored\"}"' | jq '{id, shortId, status}'

12. Unresolve Issue

Reopen a resolved issue:

Note: Replace my-org with your organization slug and 123456789 with an actual issue ID.

ORG=my-org ISSUE_ID=123456789 bash -c 'curl -s -X PUT "https://sentry.io/api/0/organizations/$ORG/issues/$ISSUE_ID/" -H "Authorization: Bearer $SENTRY_TOKEN" -H "Content-Type: application/json" -d "{\"status\":\"unresolved\"}"' | jq '{id, shortId, status}'

13. List Releases

Get all releases for the organization:

Note: Replace my-org with your organization slug.

ORG=my-org bash -c 'curl -s "https://sentry.io/api/0/organizations/$ORG/releases/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {version, dateCreated, newGroups, projects: [.projects[].slug]}'

14. Get Release Details

Get details for a specific release:

Note: Replace my-org with your organization slug and 1.0.0 with an actual release version.

ORG=my-org RELEASE=1.0.0 bash -c 'curl -s "https://sentry.io/api/0/organizations/$ORG/releases/$RELEASE/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '{version, dateCreated, dateReleased, newGroups, lastEvent, projects}'

15. List Project Error Events

Get recent error events for a project:

Note: Replace my-org and my-project with your actual values.

ORG=my-org PROJECT=my-project bash -c 'curl -s "https://sentry.io/api/0/projects/$ORG/$PROJECT/events/" -H "Authorization: Bearer $SENTRY_TOKEN"' | jq '.[] | {eventID, title, message, dateCreated}'

Issue Status Values

Guidelines

1. Discover org slug first: Call the organizations endpoint to get your org slug before using other endpoints
2. Pagination: Use cursor parameter for paginated results
3. Query syntax: Use Sentry's query language for powerful filtering
4. Rate limits: Sentry has rate limits; implement backoff for 429 responses
5. Scopes matter: Ensure your token has required scopes for each operation