# Sentry (/integrations/sentry)





{/* MANUAL-CONTENT-START:intro */}

Use [Sentry](https://sentry.io/) to read and update issues, inspect events, manage projects and releases, and record deployments. Webhook triggers can start workflows when Sentry reports an issue or alert.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Monitor issues, manage projects, track events, and coordinate releases across your applications.

## Actions [#actions]

### List Issues [#list-issues]

List issues from Sentry for a specific organization and optionally a specific project. Returns issue details including status, error counts, and last seen timestamps.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `projectSlug` | string | No | Filter issues by numeric project ID (e.g., "4501234"). This organization-scoped endpoint requires the numeric project ID, not the project slug. |
  | `query` | string | No | Search query to filter issues. Supports Sentry search syntax (e.g., "is:unresolved", "level:error") |
  | `statsPeriod` | string | No | Time window for the per-issue stats series (e.g., "24h", "14d"). Note: this controls the stats returned with each issue, not which issues are returned — use the query (e.g., "age:-7d", "lastSeen:-24h") to filter results. |
  | `cursor` | string | No | Pagination cursor for retrieving next page of results |
  | `limit` | number | No | Number of issues to return per page (max: 100) |
  | `status` | string | No | Filter by issue status: unresolved, resolved, or ignored. The legacy "ignored"/"muted" values map to Sentry's current "archived" search token. |
  | `sort` | string | No | Sort order: date, new, trends, freq, or user (default: date) |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `issues` | array | List of Sentry issues |
  | ↳ `id` | string | Unique issue ID |
  | ↳ `shortId` | string | Short issue identifier |
  | ↳ `title` | string | Issue title |
  | ↳ `culprit` | string | Function or location that caused the issue |
  | ↳ `permalink` | string | Direct link to the issue in Sentry |
  | ↳ `logger` | string | Logger name that reported the issue |
  | ↳ `level` | string | Severity level (error, warning, info, etc.) |
  | ↳ `status` | string | Current issue status |
  | ↳ `substatus` | string | Issue substatus (e.g., ongoing, escalating, new, archived\_until\_escalating) |
  | ↳ `priority` | string | Issue priority (high, medium, or low) |
  | ↳ `statusDetails` | object | Additional details about the status |
  | ↳ `isPublic` | boolean | Whether the issue is publicly visible |
  | ↳ `platform` | string | Platform where the issue occurred |
  | ↳ `project` | object | Project information |
  | ↳ `id` | string | Project ID |
  | ↳ `name` | string | Project name |
  | ↳ `slug` | string | Project slug |
  | ↳ `platform` | string | Project platform |
  | ↳ `type` | string | Issue type |
  | ↳ `metadata` | object | Error metadata |
  | ↳ `type` | string | Type of error (e.g., TypeError) |
  | ↳ `value` | string | Error message or value |
  | ↳ `function` | string | Function where the error occurred |
  | ↳ `numComments` | number | Number of comments on the issue |
  | ↳ `assignedTo` | object | User assigned to the issue |
  | ↳ `id` | string | User ID |
  | ↳ `name` | string | User name |
  | ↳ `email` | string | User email |
  | ↳ `isBookmarked` | boolean | Whether the issue is bookmarked |
  | ↳ `isSubscribed` | boolean | Whether subscribed to updates |
  | ↳ `hasSeen` | boolean | Whether the user has seen this issue |
  | ↳ `annotations` | array | Issue annotations |
  | ↳ `isUnhandled` | boolean | Whether the issue is unhandled |
  | ↳ `count` | string | Total number of occurrences |
  | ↳ `userCount` | number | Number of unique users affected |
  | ↳ `firstSeen` | string | When the issue was first seen (ISO timestamp) |
  | ↳ `lastSeen` | string | When the issue was last seen (ISO timestamp) |
  | ↳ `stats` | object | Statistical information about the issue |
  | `metadata` | object | Pagination metadata |
  | ↳ `nextCursor` | string | Cursor for the next page of results (if available) |
  | ↳ `hasMore` | boolean | Whether there are more results available |
</ReferenceDetails>

### Get Issue [#get-issue]

Retrieve detailed information about a specific Sentry issue by its ID. Returns complete issue details including metadata, tags, and statistics.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `issueId` | string | Yes | The unique ID of the issue to retrieve (e.g., "12345") |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `issue` | object | Detailed information about the Sentry issue |
  | ↳ `id` | string | Unique issue ID |
  | ↳ `shortId` | string | Short issue identifier |
  | ↳ `title` | string | Issue title |
  | ↳ `culprit` | string | Function or location that caused the issue |
  | ↳ `permalink` | string | Direct link to the issue in Sentry |
  | ↳ `logger` | string | Logger name that reported the issue |
  | ↳ `level` | string | Severity level (error, warning, info, etc.) |
  | ↳ `status` | string | Current issue status |
  | ↳ `substatus` | string | Issue substatus (e.g., ongoing, escalating, new, archived\_until\_escalating) |
  | ↳ `priority` | string | Issue priority (high, medium, or low) |
  | ↳ `statusDetails` | object | Additional details about the status |
  | ↳ `isPublic` | boolean | Whether the issue is publicly visible |
  | ↳ `platform` | string | Platform where the issue occurred |
  | ↳ `project` | object | Project information |
  | ↳ `id` | string | Project ID |
  | ↳ `name` | string | Project name |
  | ↳ `slug` | string | Project slug |
  | ↳ `platform` | string | Project platform |
  | ↳ `type` | string | Issue type |
  | ↳ `metadata` | object | Error metadata |
  | ↳ `type` | string | Type of error (e.g., TypeError, ValueError) |
  | ↳ `value` | string | Error message or value |
  | ↳ `function` | string | Function where the error occurred |
  | ↳ `numComments` | number | Number of comments on the issue |
  | ↳ `assignedTo` | object | User assigned to the issue (if any) |
  | ↳ `id` | string | User ID |
  | ↳ `name` | string | User name |
  | ↳ `email` | string | User email |
  | ↳ `isBookmarked` | boolean | Whether the issue is bookmarked |
  | ↳ `isSubscribed` | boolean | Whether the user is subscribed to updates |
  | ↳ `hasSeen` | boolean | Whether the user has seen this issue |
  | ↳ `annotations` | array | Issue annotations |
  | ↳ `isUnhandled` | boolean | Whether the issue is unhandled |
  | ↳ `count` | string | Total number of occurrences |
  | ↳ `userCount` | number | Number of unique users affected |
  | ↳ `firstSeen` | string | When the issue was first seen (ISO timestamp) |
  | ↳ `lastSeen` | string | When the issue was last seen (ISO timestamp) |
  | ↳ `stats` | object | Statistical information about the issue |
</ReferenceDetails>

### Update Issue [#update-issue]

Update a Sentry issue by changing its status, assignment, bookmark state, or other properties. Returns the updated issue details.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `issueId` | string | Yes | The unique ID of the issue to update (e.g., "12345") |
  | `status` | string | No | New status for the issue: resolved, unresolved, ignored, or resolvedInNextRelease |
  | `assignedTo` | string | No | Actor to assign the issue to, in the form "user:\<id>" or "team:\<id>" (a bare username or email is also accepted). Use an empty string to unassign. |
  | `isBookmarked` | boolean | No | Whether to bookmark the issue |
  | `isSubscribed` | boolean | No | Whether to subscribe to issue updates |
  | `isPublic` | boolean | No | Whether the issue should be publicly visible |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `issue` | object | The updated Sentry issue |
  | ↳ `id` | string | Unique issue ID |
  | ↳ `shortId` | string | Short issue identifier |
  | ↳ `title` | string | Issue title |
  | ↳ `status` | string | Updated issue status |
  | ↳ `substatus` | string | Issue substatus after the update |
  | ↳ `priority` | string | Issue priority (high, medium, or low) |
  | ↳ `assignedTo` | object | User assigned to the issue (if any) |
  | ↳ `id` | string | User ID |
  | ↳ `name` | string | User name |
  | ↳ `email` | string | User email |
  | ↳ `isBookmarked` | boolean | Whether the issue is bookmarked |
  | ↳ `isSubscribed` | boolean | Whether the user is subscribed to updates |
  | ↳ `isPublic` | boolean | Whether the issue is publicly visible |
  | ↳ `permalink` | string | Direct link to the issue in Sentry |
</ReferenceDetails>

### List Projects [#list-projects]

List all projects in a Sentry organization. Returns project details including name, platform, teams, and configuration.

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `cursor` | string | No | Pagination cursor for retrieving next page of results |
  | `limit` | number | No | Number of projects to return per page (default: 25, max: 100) |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `projects` | array | List of Sentry projects |
  | ↳ `id` | string | Unique project ID |
  | ↳ `slug` | string | URL-friendly project identifier |
  | ↳ `name` | string | Project name |
  | ↳ `platform` | string | Platform/language (e.g., javascript, python) |
  | ↳ `dateCreated` | string | When the project was created (ISO timestamp) |
  | ↳ `isBookmarked` | boolean | Whether the project is bookmarked |
  | ↳ `isMember` | boolean | Whether the user is a member of the project |
  | ↳ `features` | array | Enabled features for the project |
  | ↳ `organization` | object | Organization information |
  | ↳ `id` | string | Organization ID |
  | ↳ `slug` | string | Organization slug |
  | ↳ `name` | string | Organization name |
  | ↳ `teams` | array | Teams associated with the project |
  | ↳ `id` | string | Team ID |
  | ↳ `name` | string | Team name |
  | ↳ `slug` | string | Team slug |
  | ↳ `status` | string | Project status |
  | ↳ `isPublic` | boolean | Whether the project is publicly visible |
  | `metadata` | object | Pagination metadata |
  | ↳ `nextCursor` | string | Cursor for the next page of results (if available) |
  | ↳ `hasMore` | boolean | Whether there are more results available |
</ReferenceDetails>

### Get Project [#get-project]

Retrieve detailed information about a specific Sentry project by its slug. Returns complete project details including teams, features, and configuration.

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `projectSlug` | string | Yes | The slug of the project to retrieve (e.g., "my-project") |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `project` | object | Detailed information about the Sentry project |
  | ↳ `id` | string | Unique project ID |
  | ↳ `slug` | string | URL-friendly project identifier |
  | ↳ `name` | string | Project name |
  | ↳ `platform` | string | Platform/language (e.g., javascript, python) |
  | ↳ `dateCreated` | string | When the project was created (ISO timestamp) |
  | ↳ `isBookmarked` | boolean | Whether the project is bookmarked |
  | ↳ `isMember` | boolean | Whether the user is a member of the project |
  | ↳ `features` | array | Enabled features for the project |
  | ↳ `firstEvent` | string | When the first event was received (ISO timestamp) |
  | ↳ `firstTransactionEvent` | boolean | Whether the project has received its first transaction event |
  | ↳ `access` | array | Access permissions |
  | ↳ `organization` | object | Organization information |
  | ↳ `id` | string | Organization ID |
  | ↳ `slug` | string | Organization slug |
  | ↳ `name` | string | Organization name |
  | ↳ `team` | object | Primary team for the project |
  | ↳ `id` | string | Team ID |
  | ↳ `name` | string | Team name |
  | ↳ `slug` | string | Team slug |
  | ↳ `teams` | array | Teams associated with the project |
  | ↳ `id` | string | Team ID |
  | ↳ `name` | string | Team name |
  | ↳ `slug` | string | Team slug |
  | ↳ `status` | string | Project status |
  | ↳ `color` | string | Project color code |
  | ↳ `isPublic` | boolean | Whether the project is publicly visible |
  | ↳ `isInternal` | boolean | Whether the project is internal |
  | ↳ `hasAccess` | boolean | Whether the user has access to this project |
  | ↳ `hasMinifiedStackTrace` | boolean | Whether minified stack traces are available |
  | ↳ `hasMonitors` | boolean | Whether the project has monitors configured |
  | ↳ `hasProfiles` | boolean | Whether the project has profiling enabled |
  | ↳ `hasReplays` | boolean | Whether the project has session replays enabled |
  | ↳ `hasSessions` | boolean | Whether the project has sessions enabled |
</ReferenceDetails>

### Create Project [#create-project]

Create a new Sentry project in an organization. Requires a team to associate the project with. Returns the created project details.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `name` | string | Yes | The name of the project |
  | `teamSlug` | string | Yes | The slug of the team that will own this project |
  | `slug` | string | No | URL-friendly project identifier (auto-generated from name if not provided) |
  | `platform` | string | No | Platform/language for the project (e.g., javascript, python, node, react-native). If not specified, defaults to "other" |
  | `defaultRules` | boolean | No | Whether to create default alert rules (default: true) |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `project` | object | The newly created Sentry project |
  | ↳ `id` | string | Unique project ID |
  | ↳ `slug` | string | URL-friendly project identifier |
  | ↳ `name` | string | Project name |
  | ↳ `platform` | string | Platform/language |
  | ↳ `dateCreated` | string | When the project was created (ISO timestamp) |
  | ↳ `isBookmarked` | boolean | Whether the project is bookmarked |
  | ↳ `isMember` | boolean | Whether the user is a member |
  | ↳ `hasAccess` | boolean | Whether the user has access |
  | ↳ `features` | array | Enabled features |
  | ↳ `firstEvent` | string | First event timestamp |
  | ↳ `organization` | object | Organization information |
  | ↳ `id` | string | Organization ID |
  | ↳ `slug` | string | Organization slug |
  | ↳ `name` | string | Organization name |
  | ↳ `team` | object | Primary team for the project |
  | ↳ `id` | string | Team ID |
  | ↳ `name` | string | Team name |
  | ↳ `slug` | string | Team slug |
  | ↳ `teams` | array | Teams associated with the project |
  | ↳ `id` | string | Team ID |
  | ↳ `name` | string | Team name |
  | ↳ `slug` | string | Team slug |
  | ↳ `status` | string | Project status |
  | ↳ `color` | string | Project color code |
  | ↳ `isPublic` | boolean | Whether the project is public |
</ReferenceDetails>

### Update Project [#update-project]

Update a Sentry project by changing its name, slug, platform, or other settings. Returns the updated project details.

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `projectSlug` | string | Yes | The slug of the project to update (e.g., "my-project") |
  | `name` | string | No | New name for the project |
  | `slug` | string | No | New URL-friendly project identifier |
  | `platform` | string | No | New platform/language for the project (e.g., javascript, python, node) |
  | `isBookmarked` | boolean | No | Whether to bookmark the project |
  | `digestsMinDelay` | number | No | Minimum delay (in seconds) for digest notifications |
  | `digestsMaxDelay` | number | No | Maximum delay (in seconds) for digest notifications |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `project` | object | The updated Sentry project |
  | ↳ `id` | string | Unique project ID |
  | ↳ `slug` | string | URL-friendly project identifier |
  | ↳ `name` | string | Project name |
  | ↳ `platform` | string | Platform/language |
  | ↳ `isBookmarked` | boolean | Whether the project is bookmarked |
  | ↳ `organization` | object | Organization information |
  | ↳ `id` | string | Organization ID |
  | ↳ `slug` | string | Organization slug |
  | ↳ `name` | string | Organization name |
  | ↳ `teams` | array | Teams associated with the project |
  | ↳ `id` | string | Team ID |
  | ↳ `name` | string | Team name |
  | ↳ `slug` | string | Team slug |
</ReferenceDetails>

### List Events [#list-events]

List events from a Sentry project. Can be filtered by issue ID, query, or time period. Returns event details including context, tags, and user information.

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `projectSlug` | string | Yes | The slug of the project to list events from (e.g., "my-project") |
  | `issueId` | string | No | Filter events by a specific issue ID (e.g., "12345") |
  | `query` | string | No | Search query to filter events. Only applied when an Issue ID is provided (the issue events endpoint); the project events endpoint ignores it. Supports Sentry search syntax (e.g., "user.email:\*@example.com") |
  | `cursor` | string | No | Pagination cursor for retrieving next page of results |
  | `limit` | number | No | Number of events to return per page (max: 100) |
  | `statsPeriod` | string | No | Time period to query (e.g., "24h", "7d", "14d"). Cannot be combined with absolute start/end. |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `events` | array | List of Sentry events |
  | ↳ `id` | string | Unique event ID |
  | ↳ `eventID` | string | Event identifier |
  | ↳ `projectID` | string | Project ID |
  | ↳ `groupID` | string | Issue group ID |
  | ↳ `message` | string | Event message |
  | ↳ `title` | string | Event title |
  | ↳ `location` | string | Location information |
  | ↳ `culprit` | string | Function or location that caused the event |
  | ↳ `dateCreated` | string | When the event was created (ISO timestamp) |
  | ↳ `dateReceived` | string | When Sentry received the event (ISO timestamp) |
  | ↳ `user` | object | User information associated with the event |
  | ↳ `id` | string | User ID |
  | ↳ `email` | string | User email |
  | ↳ `username` | string | Username |
  | ↳ `ipAddress` | string | IP address |
  | ↳ `name` | string | User display name |
  | ↳ `tags` | array | Tags associated with the event |
  | ↳ `key` | string | Tag key |
  | ↳ `value` | string | Tag value |
  | ↳ `contexts` | object | Additional context data (device, OS, etc.) |
  | ↳ `platform` | string | Platform where the event occurred |
  | ↳ `type` | string | Event type |
  | ↳ `metadata` | object | Error metadata |
  | ↳ `type` | string | Type of error (e.g., TypeError) |
  | ↳ `value` | string | Error message or value |
  | ↳ `function` | string | Function where the error occurred |
  | ↳ `entries` | array | Event entries (exception, breadcrumbs, etc.) |
  | ↳ `errors` | array | Processing errors |
  | ↳ `dist` | string | Distribution identifier |
  | ↳ `fingerprints` | array | Fingerprints for grouping |
  | ↳ `size` | number | Event size in bytes |
  | ↳ `release` | object | Release associated with the event (version, dateCreated) |
  | ↳ `sdk` | object | SDK information |
  | ↳ `name` | string | SDK name |
  | ↳ `version` | string | SDK version |
  | `metadata` | object | Pagination metadata |
  | ↳ `nextCursor` | string | Cursor for the next page of results (if available) |
  | ↳ `hasMore` | boolean | Whether there are more results available |
</ReferenceDetails>

### Get Event [#get-event]

Retrieve detailed information about a specific Sentry event by its ID. Returns complete event details including stack traces, breadcrumbs, context, and user information.

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `projectSlug` | string | Yes | The slug of the project (e.g., "my-project") |
  | `eventId` | string | Yes | The unique ID of the event to retrieve (e.g., "abc123def456") |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `event` | object | Detailed information about the Sentry event |
  | ↳ `id` | string | Unique event ID |
  | ↳ `eventID` | string | Event identifier |
  | ↳ `projectID` | string | Project ID |
  | ↳ `groupID` | string | Issue group ID this event belongs to |
  | ↳ `message` | string | Event message |
  | ↳ `title` | string | Event title |
  | ↳ `location` | string | Location information |
  | ↳ `culprit` | string | Function or location that caused the event |
  | ↳ `dateCreated` | string | When the event was created (ISO timestamp) |
  | ↳ `dateReceived` | string | When Sentry received the event (ISO timestamp) |
  | ↳ `user` | object | User information associated with the event |
  | ↳ `id` | string | User ID |
  | ↳ `email` | string | User email |
  | ↳ `username` | string | Username |
  | ↳ `ipAddress` | string | IP address |
  | ↳ `name` | string | User display name |
  | ↳ `tags` | array | Tags associated with the event |
  | ↳ `key` | string | Tag key |
  | ↳ `value` | string | Tag value |
  | ↳ `contexts` | object | Additional context data (device, OS, browser, etc.) |
  | ↳ `platform` | string | Platform where the event occurred |
  | ↳ `type` | string | Event type (error, transaction, etc.) |
  | ↳ `metadata` | object | Error metadata |
  | ↳ `type` | string | Type of error (e.g., TypeError, ValueError) |
  | ↳ `value` | string | Error message or value |
  | ↳ `function` | string | Function where the error occurred |
  | ↳ `entries` | array | Event entries including exception, breadcrumbs, and request data |
  | ↳ `errors` | array | Processing errors that occurred |
  | ↳ `dist` | string | Distribution identifier |
  | ↳ `fingerprints` | array | Fingerprints used for grouping events |
  | ↳ `size` | number | Event size in bytes |
  | ↳ `release` | object | Release associated with the event (version, dateCreated) |
  | ↳ `sdk` | object | SDK information |
  | ↳ `name` | string | SDK name |
  | ↳ `version` | string | SDK version |
</ReferenceDetails>

### List Releases [#list-releases]

List releases for a Sentry organization or project. Returns release details including version, commits, deploy information, and associated projects.

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `projectSlug` | string | No | Filter releases by numeric project ID (e.g., "4501234"). This organization-scoped endpoint requires the numeric project ID, not the project slug. |
  | `query` | string | No | Search query to filter releases (e.g., "1.0" to match version patterns) |
  | `cursor` | string | No | Pagination cursor for retrieving next page of results |
  | `limit` | number | No | Number of releases to return per page (default: 25, max: 100) |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `releases` | array | List of Sentry releases |
  | ↳ `id` | string | Unique release ID |
  | ↳ `version` | string | Release version identifier |
  | ↳ `shortVersion` | string | Shortened version identifier |
  | ↳ `ref` | string | Git reference (commit SHA, tag, or branch) |
  | ↳ `url` | string | URL to the release (e.g., GitHub release page) |
  | ↳ `dateReleased` | string | When the release was deployed (ISO timestamp) |
  | ↳ `dateCreated` | string | When the release was created (ISO timestamp) |
  | ↳ `dateStarted` | string | When the release started (ISO timestamp) |
  | ↳ `newGroups` | number | Number of new issues introduced in this release |
  | ↳ `owner` | object | Owner of the release |
  | ↳ `id` | string | User ID |
  | ↳ `name` | string | User name |
  | ↳ `email` | string | User email |
  | ↳ `commitCount` | number | Number of commits in this release |
  | ↳ `deployCount` | number | Number of deploys for this release |
  | ↳ `lastCommit` | object | Last commit in the release |
  | ↳ `id` | string | Commit SHA |
  | ↳ `message` | string | Commit message |
  | ↳ `dateCreated` | string | Commit timestamp |
  | ↳ `lastDeploy` | object | Last deploy of the release |
  | ↳ `id` | string | Deploy ID |
  | ↳ `environment` | string | Deploy environment |
  | ↳ `dateStarted` | string | Deploy start timestamp |
  | ↳ `dateFinished` | string | Deploy finish timestamp |
  | ↳ `authors` | array | Authors of commits in the release |
  | ↳ `id` | string | Author ID |
  | ↳ `name` | string | Author name |
  | ↳ `email` | string | Author email |
  | ↳ `projects` | array | Projects associated with this release |
  | ↳ `id` | string | Project ID |
  | ↳ `name` | string | Project name |
  | ↳ `slug` | string | Project slug |
  | ↳ `platform` | string | Project platform |
  | ↳ `firstEvent` | string | First event timestamp |
  | ↳ `lastEvent` | string | Last event timestamp |
  | ↳ `versionInfo` | object | Version metadata |
  | ↳ `buildHash` | string | Build hash |
  | ↳ `version` | object | Version details |
  | ↳ `raw` | string | Raw version string |
  | ↳ `package` | string | Package name |
  | `metadata` | object | Pagination metadata |
  | ↳ `nextCursor` | string | Cursor for the next page of results (if available) |
  | ↳ `hasMore` | boolean | Whether there are more results available |
</ReferenceDetails>

### Create Release [#create-release]

Create a new release in Sentry. A release is a version of your code deployed to an environment. Can include commit information and associated projects. Returns the created release details.

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `version` | string | Yes | Version identifier for the release (e.g., "2.0.0", "my-app\@1.0.0", or a git commit SHA) |
  | `projects` | string | Yes | Comma-separated list of project slugs to associate with this release |
  | `ref` | string | No | Git reference (commit SHA, tag, or branch) for this release |
  | `url` | string | No | URL pointing to the release (e.g., GitHub release page) |
  | `dateReleased` | string | No | ISO 8601 timestamp for when the release was deployed (defaults to current time) |
  | `commits` | string | No | JSON array of commit objects with id, repository (optional), and message (optional). Example: \[\{"id":"abc123","message":"Fix bug"}] |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `release` | object | The newly created Sentry release |
  | ↳ `id` | string | Unique release ID |
  | ↳ `version` | string | Release version identifier |
  | ↳ `shortVersion` | string | Shortened version identifier |
  | ↳ `ref` | string | Git reference (commit SHA, tag, or branch) |
  | ↳ `url` | string | URL to the release |
  | ↳ `dateReleased` | string | When the release was deployed (ISO timestamp) |
  | ↳ `dateCreated` | string | When the release was created (ISO timestamp) |
  | ↳ `dateStarted` | string | When the release started (ISO timestamp) |
  | ↳ `newGroups` | number | Number of new issues introduced |
  | ↳ `commitCount` | number | Number of commits in this release |
  | ↳ `deployCount` | number | Number of deploys for this release |
  | ↳ `owner` | object | Release owner |
  | ↳ `id` | string | Owner ID |
  | ↳ `name` | string | Owner name |
  | ↳ `email` | string | Owner email |
  | ↳ `lastCommit` | object | Last commit in the release |
  | ↳ `id` | string | Commit SHA |
  | ↳ `message` | string | Commit message |
  | ↳ `dateCreated` | string | Commit timestamp |
  | ↳ `lastDeploy` | object | Last deploy of the release |
  | ↳ `id` | string | Deploy ID |
  | ↳ `environment` | string | Deploy environment |
  | ↳ `dateStarted` | string | Deploy start timestamp |
  | ↳ `dateFinished` | string | Deploy finish timestamp |
  | ↳ `authors` | array | Authors of commits in the release |
  | ↳ `id` | string | Author ID |
  | ↳ `name` | string | Author name |
  | ↳ `email` | string | Author email |
  | ↳ `projects` | array | Projects associated with this release |
  | ↳ `id` | string | Project ID |
  | ↳ `name` | string | Project name |
  | ↳ `slug` | string | Project slug |
  | ↳ `platform` | string | Project platform |
  | ↳ `firstEvent` | string | First event timestamp |
  | ↳ `lastEvent` | string | Last event timestamp |
  | ↳ `versionInfo` | object | Version metadata |
  | ↳ `buildHash` | string | Build hash |
  | ↳ `version` | object | Version details |
  | ↳ `raw` | string | Raw version string |
  | ↳ `package` | string | Package name |
</ReferenceDetails>

### Create Deploy [#create-deploy]

Create a deploy record for a Sentry release in a specific environment. Deploys track when and where releases are deployed. Returns the created deploy details.

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `version` | string | Yes | Version identifier of the release being deployed (e.g., "1.0.0" or "abc123") |
  | `environment` | string | Yes | Environment name where the release is being deployed (e.g., "production", "staging") |
  | `name` | string | No | Optional name for this deploy (e.g., "Deploy v2.0 to Production") |
  | `url` | string | No | URL pointing to the deploy (e.g., CI/CD pipeline URL) |
  | `dateStarted` | string | No | ISO 8601 timestamp for when the deploy started (defaults to current time) |
  | `dateFinished` | string | No | ISO 8601 timestamp for when the deploy finished |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `deploy` | object | The newly created deploy record |
  | ↳ `id` | string | Unique deploy ID |
  | ↳ `environment` | string | Environment name where the release was deployed |
  | ↳ `name` | string | Name of the deploy |
  | ↳ `url` | string | URL pointing to the deploy |
  | ↳ `dateStarted` | string | When the deploy started (ISO timestamp) |
  | ↳ `dateFinished` | string | When the deploy finished (ISO timestamp) |
</ReferenceDetails>

### List Teams [#list-teams]

List all teams in a Sentry organization. Useful for discovering the team slug required when creating a project. Returns team details including slug, name, member count, and associated projects.

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Sentry API authentication token |
  | `organizationSlug` | string | Yes | The slug of the organization (e.g., "my-org") |
  | `query` | string | No | Filter teams by name or slug |
  | `cursor` | string | No | Pagination cursor for retrieving next page of results |
  | `limit` | number | No | Number of teams to return per page (default: 25, max: 100) |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `teams` | array | List of Sentry teams |
  | ↳ `id` | string | Unique team ID |
  | ↳ `slug` | string | URL-friendly team identifier (used to own projects) |
  | ↳ `name` | string | Team name |
  | ↳ `dateCreated` | string | When the team was created (ISO timestamp) |
  | ↳ `isMember` | boolean | Whether the user is a member of the team |
  | ↳ `teamRole` | string | The role of the user on the team |
  | ↳ `hasAccess` | boolean | Whether the user has access to this team |
  | ↳ `isPending` | boolean | Whether team membership is pending |
  | ↳ `memberCount` | number | Number of members in the team |
  | ↳ `projects` | array | Projects owned by this team |
  | ↳ `id` | string | Project ID |
  | ↳ `slug` | string | Project slug |
  | ↳ `name` | string | Project name |
  | ↳ `platform` | string | Project platform |
  | `metadata` | object | Pagination metadata |
  | ↳ `nextCursor` | string | Cursor for the next page of results (if available) |
  | ↳ `hasMore` | boolean | Whether there are more results available |
</ReferenceDetails>

## Triggers [#triggers]

A trigger starts a workflow when a supported event occurs in this service.

### Sentry Error Created [#sentry-error-created]

Trigger workflow when a new error event is created in Sentry

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `clientSecret` | string | Yes | Client Secret |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `action` | string | The action that triggered the webhook (e.g., created, resolved, triggered) |
  | `installation` | json | Installation object containing the integration installation uuid |
  | `actor` | json | Who triggered the webhook (user, the integration application, or Sentry) |
  | `error` | object | |
  | ↳ `event_id` | string | Unique event ID |
  | ↳ `issue_id` | string | ID of the issue this error belongs to |
  | ↳ `issue_url` | string | API URL of the issue |
  | ↳ `project` | number | Project ID |
  | ↳ `key_id` | string | Project key ID |
  | ↳ `level` | string | Error level |
  | ↳ `title` | string | Error title |
  | ↳ `eventType` | string | Event type (the payload's `type` field; `type` is reserved) |
  | ↳ `message` | string | Error message |
  | ↳ `culprit` | string | Error culprit (location/transaction) |
  | ↳ `platform` | string | Platform |
  | ↳ `logger` | string | Logger name |
  | ↳ `timestamp` | number | Event timestamp (epoch seconds) |
  | ↳ `datetime` | string | Event datetime (ISO 8601) |
  | ↳ `received` | number | Received timestamp (epoch seconds) |
  | ↳ `dist` | string | Distribution identifier |
  | ↳ `release` | string | Release version |
  | ↳ `fingerprint` | json | Grouping fingerprint |
  | ↳ `tags` | json | Event tags |
  | ↳ `user` | json | User context |
  | ↳ `request` | json | HTTP request context |
  | ↳ `contexts` | json | Additional contexts (browser, os, device) |
  | ↳ `sdk` | json | SDK information |
  | ↳ `exception` | json | Exception details including stack frames |
  | ↳ `metadata` | json | Error metadata |
  | ↳ `url` | string | API URL for the event |
  | ↳ `web_url` | string | Browser URL for the event |
</ReferenceDetails>

### Sentry Issue Alert [#sentry-issue-alert]

Trigger workflow when a Sentry issue alert rule fires

#### Configuration [#configuration-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `clientSecret` | string | Yes | Client Secret |

#### Output [#output-14]

| Parameter | Type | Description |
| - | - | - |
| `action` | string | The action that triggered the webhook (e.g., created, resolved, triggered) |
| `installation` | json | Installation object containing the integration installation uuid |
| `actor` | json | Who triggered the webhook (user, the integration application, or Sentry) |
| `event` | json | The event that triggered the alert rule |
| `triggered_rule` | string | Label of the alert rule that was triggered |
| `issue_alert` | object | |
| ↳ `title` | string | Alert rule name |
| ↳ `settings` | json | Alert rule action settings (name/value pairs) |

***

### Sentry Issue Created [#sentry-issue-created]

Trigger workflow when a new issue is created in Sentry

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `clientSecret` | string | Yes | Client Secret |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `action` | string | The action that triggered the webhook (e.g., created, resolved, triggered) |
  | `installation` | json | Installation object containing the integration installation uuid |
  | `actor` | json | Who triggered the webhook (user, the integration application, or Sentry) |
  | `issue` | object | |
  | ↳ `id` | string | Issue ID |
  | ↳ `shortId` | string | Short human-readable issue ID |
  | ↳ `shareId` | string | Share ID for the issue |
  | ↳ `title` | string | Issue title |
  | ↳ `culprit` | string | Issue culprit (location/transaction) |
  | ↳ `logger` | string | Logger name |
  | ↳ `level` | string | Issue level (error, warning, etc.) |
  | ↳ `status` | string | Issue status (unresolved, resolved, ignored) |
  | ↳ `substatus` | string | Issue substatus |
  | ↳ `statusDetails` | json | Status details (inRelease, inCommit, ignore\*) |
  | ↳ `platform` | string | Platform of the issue |
  | ↳ `eventType` | string | Issue type (the payload's `type` field; `type` is reserved) |
  | ↳ `issueType` | string | Specific issue type classification |
  | ↳ `issueCategory` | string | Issue category |
  | ↳ `isUnhandled` | boolean | Whether the issue is unhandled |
  | ↳ `isPublic` | boolean | Whether the issue is public |
  | ↳ `isBookmarked` | boolean | Whether the issue is bookmarked |
  | ↳ `isSubscribed` | boolean | Whether the viewer is subscribed |
  | ↳ `hasSeen` | boolean | Whether the issue has been seen |
  | ↳ `numComments` | number | Number of comments on the issue |
  | ↳ `count` | string | Total event count |
  | ↳ `userCount` | number | Number of affected users |
  | ↳ `firstSeen` | string | Timestamp when first seen |
  | ↳ `lastSeen` | string | Timestamp when last seen |
  | ↳ `priority` | string | Issue priority |
  | ↳ `assignedTo` | json | Assignee (user or team), or null |
  | ↳ `annotations` | json | Issue annotations |
  | ↳ `metadata` | json | Issue metadata (title, type, value, sdk, severity) |
  | ↳ `project` | object | |
  | ↳ `id` | string | Project ID |
  | ↳ `name` | string | Project name |
  | ↳ `slug` | string | Project slug |
  | ↳ `platform` | string | Project platform |
  | ↳ `url` | string | API URL for the issue |
  | ↳ `web_url` | string | Browser URL for the issue |
  | ↳ `project_url` | string | Browser URL for the project |
  | ↳ `permalink` | string | Permalink to the issue |
</ReferenceDetails>

### Sentry Issue Resolved [#sentry-issue-resolved]

Trigger workflow when an issue is resolved in Sentry

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `clientSecret` | string | Yes | Client Secret |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `action` | string | The action that triggered the webhook (e.g., created, resolved, triggered) |
  | `installation` | json | Installation object containing the integration installation uuid |
  | `actor` | json | Who triggered the webhook (user, the integration application, or Sentry) |
  | `issue` | object | |
  | ↳ `id` | string | Issue ID |
  | ↳ `shortId` | string | Short human-readable issue ID |
  | ↳ `shareId` | string | Share ID for the issue |
  | ↳ `title` | string | Issue title |
  | ↳ `culprit` | string | Issue culprit (location/transaction) |
  | ↳ `logger` | string | Logger name |
  | ↳ `level` | string | Issue level (error, warning, etc.) |
  | ↳ `status` | string | Issue status (unresolved, resolved, ignored) |
  | ↳ `substatus` | string | Issue substatus |
  | ↳ `statusDetails` | json | Status details (inRelease, inCommit, ignore\*) |
  | ↳ `platform` | string | Platform of the issue |
  | ↳ `eventType` | string | Issue type (the payload's `type` field; `type` is reserved) |
  | ↳ `issueType` | string | Specific issue type classification |
  | ↳ `issueCategory` | string | Issue category |
  | ↳ `isUnhandled` | boolean | Whether the issue is unhandled |
  | ↳ `isPublic` | boolean | Whether the issue is public |
  | ↳ `isBookmarked` | boolean | Whether the issue is bookmarked |
  | ↳ `isSubscribed` | boolean | Whether the viewer is subscribed |
  | ↳ `hasSeen` | boolean | Whether the issue has been seen |
  | ↳ `numComments` | number | Number of comments on the issue |
  | ↳ `count` | string | Total event count |
  | ↳ `userCount` | number | Number of affected users |
  | ↳ `firstSeen` | string | Timestamp when first seen |
  | ↳ `lastSeen` | string | Timestamp when last seen |
  | ↳ `priority` | string | Issue priority |
  | ↳ `assignedTo` | json | Assignee (user or team), or null |
  | ↳ `annotations` | json | Issue annotations |
  | ↳ `metadata` | json | Issue metadata (title, type, value, sdk, severity) |
  | ↳ `project` | object | |
  | ↳ `id` | string | Project ID |
  | ↳ `name` | string | Project name |
  | ↳ `slug` | string | Project slug |
  | ↳ `platform` | string | Project platform |
  | ↳ `url` | string | API URL for the issue |
  | ↳ `web_url` | string | Browser URL for the issue |
  | ↳ `project_url` | string | Browser URL for the project |
  | ↳ `permalink` | string | Permalink to the issue |
</ReferenceDetails>

### Sentry Metric Alert [#sentry-metric-alert]

Trigger workflow when a Sentry metric alert changes state (critical, warning, resolved)

#### Configuration [#configuration-4]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `clientSecret` | string | Yes | Client Secret |

#### Output [#output-17]

| Parameter | Type | Description |
| - | - | - |
| `action` | string | The action that triggered the webhook (e.g., created, resolved, triggered) |
| `installation` | json | Installation object containing the integration installation uuid |
| `actor` | json | Who triggered the webhook (user, the integration application, or Sentry) |
| `metric_alert` | json | Metric alert object (alert\_rule + incident details) |
| `description_text` | string | Human-friendly description of the alert |
| `description_title` | string | Human-friendly title of the alert |
| `web_url` | string | API URL for the incident |