Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -58,56 +58,78 @@ A status can mean multiple things, so substatus gives more details about the sta
* `ignoreUserWindow`: Used with `ignoreUserCount` indicating the number of minutes that `ignoreUserCount` affected users will be ignored
* `ignoreDuration`: The duration (in minutes) that an archived issue should be ignored before it gets escalated. Increase in the number of users affected or the number of occurrences will not escalate before this duration has passed unless there is a spike. To learn more about how this works, see [Escalating Issues Algorithm](/product/issues/states-triage/escalating-issues/).

### issueCategory & issueType
`issueCategory` and `issueType` provide more detail to distinguish different issues from eachother. For `issueCategory` variations include, `outage` (for issues created from `uptime` and `cron` monitors) and `error` (for issues created from an error event).

`issueType` allows for even more specificity on top of `issueCategory`, examples include `uptime_domain_failure` for `uptime` issues and `monitor_check_in_failure` for `cron` issues.

The issue categories we currently support `issue.created` webhooks for are `OUTAGE`, `ERROR`, and FEEDBACK.

```json
{
"action": "created",
"actor": {
"id": "sentry",
"name": "Sentry",
"type": "application"
"installation": {
"uuid": "24b397fc-a86e-43ef-9297-949e21b82480"
},
"data": {
"issue": {
"annotations": [],
"assignedTo": null,
"count": "1",
"culprit": "?(runner)",
"firstSeen": "2019-08-19T20:58:37.391000Z",
"hasSeen": false,
"id": "1170820242",
"isBookmarked": false,
"url": "https://sentry.io/api/0/organizations/example-org/issues/1234567890/",
"web_url": "https://example-org.sentry.io/issues/1234567890/",
"project_url": "https://example-org.sentry.io/issues/?project=4509877862268928",
"id": "1234567890",
"shareId": null,
"shortId": "PYTHON-Y",
"title": "Error generated with event_id: 495d375a-1df6-45c0-9890-34dae8e1b6a4(Priority: HIGH)",
"culprit": "test-transaction-0-41e49cd3-7252-441f-8d27-63a9ad697b0a",
"permalink": "https://example-org.sentry.io/issues/1234567890/",
"logger": "edge-function",
"level": "fatal",
"status": "unresolved",
"statusDetails": {},
"substatus": "new",
"isPublic": false,
"isSubscribed": false,
"lastSeen": "2019-08-19T20:58:37.391000Z",
"level": "error",
"logger": null,
"metadata": {
"filename": "/runner",
"type": "ReferenceError",
"value": "blooopy is not defined"
},
"numComments": 0,
"permalink": null,
"platform": "javascript",
"project": {
"id": "1",
"name": "front-end",
"platform": "",
"slug": "front-end"
"id": "112313123123134",
"name": "python",
"slug": "python",
"platform": "python"
},
"shareId": null,
"shortId": "FRONT-END-9",
"status": "unresolved",
"statusDetails": {},
"type": "default",
"metadata": {
"title": "Error generated with event_id: 495d375a-1df6-45c0-9890-34dae8e1b6a4(Priority: HIGH)",
"sdk": {
"name": "edge-function",
"name_normalized": "other"
},
"severity": 1,
"severity_reason": "log_level_fatal",
"initial_priority": 75
},
"numComments": 0,
"assignedTo": null,
"isBookmarked": false,
"isSubscribed": false,
"subscriptionDetails": null,
"substatus": "escalating",
"title": "ReferenceError: blooopy is not defined",
"type": "error",
"userCount": 1
"hasSeen": false,
"annotations": [],
"issueType": "error",
"issueCategory": "error",
"priority": "high",
"priorityLockedAt": null,
"seerFixabilityScore": null,
"seerAutofixLastTriggered": null,
"isUnhandled": false,
"count": "3",
"userCount": 3,
"firstSeen": "2025-11-10T20:56:00.679000+00:00",
"lastSeen": "2025-11-10T20:56:00.738000+00:00"
}
},
"installation": {
"uuid": "a8e5d37a-696c-4c54-adb5-b3f28d64c7de"
"actor": {
"type": "application",
"id": "example-app",
"name": "Example App"
}
}
```
Loading