`error-groups`

Open an operation to see its authentication, its parameters and the fields of its request and response.

6 operations

GET`/v1/error-groups`

Error groups by last seen with users, trend, release, status, trigger and ticket; the proactive summary of one workspace.

Authentication: Dashboard session

Parameters

Parameters, GET /v1/error-groups
Name	Type	Description
`cursor`query	`string`
`limit`query	`integer`
`workspace_id`query	`string`
`status`query	`array of enum`
`q`query	`string`

Response `200`

Response, GET /v1/error-groups
Name	Type	Description
`items`required	`array of object`
`items[].id`required	`string`
`items[].workspace_id`required	`string`
`items[].status`required	`enum`	Values `watching \| ticketed \| resolved \| ignored`
`items[].type`required	`string`
`items[].title`required	`string`
`items[].affected_users`required	`integer`
`items[].users_24h`required	`integer`
`items[].event_count`required	`integer`
`items[].events_24h`required	`integer`
`items[].trend`required	`array of integer`
`items[].first_seen`required	`string (date-time)`
`items[].last_seen`required	`string (date-time)`
`items[].release`required	`string`
`items[].sources`required	`array of enum`
`items[].trigger`required	`enum`	Values `user_threshold \| critical_path \| regression`
`items[].critical_path_hit`required	`boolean`
`items[].noise`required	`boolean`
`items[].held_reason`required	`string`
`items[].held_at`required	`string (date-time)`
`items[].resolved_in_release`required	`string`
`items[].resolved_at`required	`string (date-time)`
`items[].regressed_at`required	`string (date-time)`
`items[].ticket`required	`object`
`items[].ticket.id`required	`string`
`items[].ticket.subject`required	`string`
`items[].ticket.state`required	`enum`	Values `received \| triage \| needs_info \| draft_ready \| answered \| fixing \| awaiting_approval \| releasing \| customer_notified \| closed \| escalated`
`items[].ticket.origin`required	`enum`	Values `email \| widget \| github \| proactive`
`items[].ticket.resolved_version`required	`string`
`items[].ticket.released_at`required	`string (date-time)`
`next_cursor`required	`string`
`overview`required	`object`
`overview.workspace_id`required	`string`
`overview.enabled`required	`boolean`
`overview.plan_allows`required	`boolean`
`overview.threshold_users`required	`integer`
`overview.critical_paths`required	`array of string`
`overview.notify_affected_users`required	`boolean`
`overview.monthly_fix_cap`required	`integer`
`overview.fixes_this_month`required	`integer`
`overview.pending_tickets`required	`integer`
`overview.cap_reached`required	`boolean`
`overview.counts`required	`object`
`overview.counts.watching`required	`integer`
`overview.counts.ticketed`required	`integer`
`overview.counts.resolved`required	`integer`
`overview.counts.ignored`required	`integer`
`overview.counts.held`required	`integer`

GET`/v1/error-groups/{id}`

One error group: sample events (masked), symbolicated stack, releases, environments.

Authentication: Dashboard session

Parameters

Parameters, GET /v1/error-groups/{id}
Name	Type	Description
`id`pathrequired	`string`

Response `200`

Response, GET /v1/error-groups/{id}
Name	Type	Description
`group`required	`object`
`group.id`required	`string`
`group.workspace_id`required	`string`
`group.status`required	`enum`	Values `watching \| ticketed \| resolved \| ignored`
`group.type`required	`string`
`group.title`required	`string`
`group.affected_users`required	`integer`
`group.users_24h`required	`integer`
`group.event_count`required	`integer`
`group.events_24h`required	`integer`
`group.trend`required	`array of integer`
`group.first_seen`required	`string (date-time)`
`group.last_seen`required	`string (date-time)`
`group.release`required	`string`
`group.sources`required	`array of enum`
`group.trigger`required	`enum`	Values `user_threshold \| critical_path \| regression`
`group.critical_path_hit`required	`boolean`
`group.noise`required	`boolean`
`group.held_reason`required	`string`
`group.held_at`required	`string (date-time)`
`group.resolved_in_release`required	`string`
`group.resolved_at`required	`string (date-time)`
`group.regressed_at`required	`string (date-time)`
`group.ticket`required	`object`
`group.ticket.id`required	`string`
`group.ticket.subject`required	`string`
`group.ticket.state`required	`enum`	Values `received \| triage \| needs_info \| draft_ready \| answered \| fixing \| awaiting_approval \| releasing \| customer_notified \| closed \| escalated`
`group.ticket.origin`required	`enum`	Values `email \| widget \| github \| proactive`
`group.ticket.resolved_version`required	`string`
`group.ticket.released_at`required	`string (date-time)`
`normalized_message`required	`string`
`sample_stack`required	`string`
`frames`required	`array of object`
`frames[].file`required	`string`
`frames[].function`required	`string`
`frames[].line`required	`integer`
`frames[].column`required	`integer`
`frames[].in_app`required	`boolean`
`frames[].generated`required	`object`
`frames[].generated.file`required	`string`
`frames[].generated.function`required	`string`
`frames[].generated.line`required	`integer`
`frames[].generated.column`required	`integer`
`symbolicated`required	`boolean`
`events`required	`array of object`
`events[].id`required	`string`
`events[].source`required	`enum`	Values `widget \| sentry \| datadog \| cloudwatch \| endpoint`
`events[].external_id`required	`string`
`events[].type`required	`string`
`events[].level`required	`string`
`events[].message`required	`string`
`events[].url`required	`string`
`events[].browser`required	`string`
`events[].release`required	`string`
`events[].environment`required	`string`
`events[].user`required	`string`
`events[].occurred_at`required	`string (date-time)`
`events[].symbolicated`required	`boolean`
`releases`required	`array of object`
`releases[].group_id`required	`string`
`releases[].release`required	`string`
`releases[].status`required	`enum`	Values `watching \| ticketed \| resolved \| ignored`
`releases[].event_count`required	`integer`
`releases[].affected_users`required	`integer`
`releases[].first_seen`required	`string (date-time)`
`releases[].last_seen`required	`string (date-time)`
`releases[].resolved_in_release`required	`string`
`environments`required	`array of string`
`capabilities`required	`object`
`capabilities.ignore`required	`boolean`
`capabilities.unignore`required	`boolean`
`capabilities.resolve`required	`boolean`
`capabilities.open_ticket`required	`boolean`

POST`/v1/error-groups/{id}/ignore`

Ignores the error in every release: kept and counted, never ticketed.

409 `group_has_open_ticket` while an open ticket follows the group.

Authentication: Dashboard session

Parameters

Parameters, POST /v1/error-groups/{id}/ignore
Name	Type	Description
`id`pathrequired	`string`

Response `200`

The same fields as GET /v1/error-groups/{id}.

POST`/v1/error-groups/{id}/resolve`

Marks a group resolved, optionally in a release: a reappearance after it is a regression.

Authentication: Dashboard session

Parameters

Parameters, POST /v1/error-groups/{id}/resolve
Name	Type	Description
`id`pathrequired	`string`

Request body

Request body, POST /v1/error-groups/{id}/resolve
Name	Type	Description
`release`	`string`

Response `200`

The same fields as GET /v1/error-groups/{id}.

POST`/v1/error-groups/{id}/ticket`

Opens a proactive ticket now, or joins the open ticket that already reports the problem.

Within the monthly cap of proactive fixes: 402 `plan_limit_reached` with `details.reason` (`proactive_cap_reached`, a quota or the spend cap; the group stays watching, held with the reason), 422 `no_repository`, 409 `group_not_watching`.

Authentication: Dashboard session

Parameters

Parameters, POST /v1/error-groups/{id}/ticket
Name	Type	Description
`id`pathrequired	`string`

Response `201`

Response, POST /v1/error-groups/{id}/ticket
Name	Type	Description
`outcome`required	`enum`	Values `opened \| linked`
`ticket_id`required	`string`
`detail`required	`object`
`detail.group`required	`object`
`detail.group.id`required	`string`
`detail.group.workspace_id`required	`string`
`detail.group.status`required	`enum`	Values `watching \| ticketed \| resolved \| ignored`
`detail.group.type`required	`string`
`detail.group.title`required	`string`
`detail.group.affected_users`required	`integer`
`detail.group.users_24h`required	`integer`
`detail.group.event_count`required	`integer`
`detail.group.events_24h`required	`integer`
`detail.group.trend`required	`array of integer`
`detail.group.first_seen`required	`string (date-time)`
`detail.group.last_seen`required	`string (date-time)`
`detail.group.release`required	`string`
`detail.group.sources`required	`array of enum`
`detail.group.trigger`required	`enum`	Values `user_threshold \| critical_path \| regression`
`detail.group.critical_path_hit`required	`boolean`
`detail.group.noise`required	`boolean`
`detail.group.held_reason`required	`string`
`detail.group.held_at`required	`string (date-time)`
`detail.group.resolved_in_release`required	`string`
`detail.group.resolved_at`required	`string (date-time)`
`detail.group.regressed_at`required	`string (date-time)`
`detail.group.ticket`required	`object`
`detail.group.ticket.id`required	`string`
`detail.group.ticket.subject`required	`string`
`detail.group.ticket.state`required	`enum`	Values `received \| triage \| needs_info \| draft_ready \| answered \| fixing \| awaiting_approval \| releasing \| customer_notified \| closed \| escalated`
`detail.group.ticket.origin`required	`enum`	Values `email \| widget \| github \| proactive`
`detail.group.ticket.resolved_version`required	`string`
`detail.group.ticket.released_at`required	`string (date-time)`
`detail.normalized_message`required	`string`
`detail.sample_stack`required	`string`
`detail.frames`required	`array of object`
`detail.frames[].file`required	`string`
`detail.frames[].function`required	`string`
`detail.frames[].line`required	`integer`
`detail.frames[].column`required	`integer`
`detail.frames[].in_app`required	`boolean`
`detail.frames[].generated`required	`object`
`detail.frames[].generated.file`required	`string`
`detail.frames[].generated.function`required	`string`
`detail.frames[].generated.line`required	`integer`
`detail.frames[].generated.column`required	`integer`
`detail.symbolicated`required	`boolean`
`detail.events`required	`array of object`
`detail.events[].id`required	`string`
`detail.events[].source`required	`enum`	Values `widget \| sentry \| datadog \| cloudwatch \| endpoint`
`detail.events[].external_id`required	`string`
`detail.events[].type`required	`string`
`detail.events[].level`required	`string`
`detail.events[].message`required	`string`
`detail.events[].url`required	`string`
`detail.events[].browser`required	`string`
`detail.events[].release`required	`string`
`detail.events[].environment`required	`string`
`detail.events[].user`required	`string`
`detail.events[].occurred_at`required	`string (date-time)`
`detail.events[].symbolicated`required	`boolean`
`detail.releases`required	`array of object`
`detail.releases[].group_id`required	`string`
`detail.releases[].release`required	`string`
`detail.releases[].status`required	`enum`	Values `watching \| ticketed \| resolved \| ignored`
`detail.releases[].event_count`required	`integer`
`detail.releases[].affected_users`required	`integer`
`detail.releases[].first_seen`required	`string (date-time)`
`detail.releases[].last_seen`required	`string (date-time)`
`detail.releases[].resolved_in_release`required	`string`
`detail.environments`required	`array of string`
`detail.capabilities`required	`object`
`detail.capabilities.ignore`required	`boolean`
`detail.capabilities.unignore`required	`boolean`
`detail.capabilities.resolve`required	`boolean`
`detail.capabilities.open_ticket`required	`boolean`

POST`/v1/error-groups/{id}/unignore`

Puts an ignored or resolved group back to watching (an ignored error: in every release).

Authentication: Dashboard session

Parameters

Parameters, POST /v1/error-groups/{id}/unignore
Name	Type	Description
`id`pathrequired	`string`

Response `200`

The same fields as GET /v1/error-groups/{id}.

Name

Type

Description

cursorquery

string

limitquery

integer

workspace_idquery

string

statusquery

array of enum

qquery

string

Name

Type

Description

itemsrequired

array of object

items[].idrequired

string

items[].workspace_idrequired

string

items[].statusrequired

enum

Values watching | ticketed | resolved | ignored

items[].typerequired

string

items[].titlerequired

string

items[].affected_usersrequired

integer

items[].users_24hrequired

integer

items[].event_countrequired

integer

items[].events_24hrequired

integer

items[].trendrequired

array of integer

items[].first_seenrequired

string (date-time)

items[].last_seenrequired

string (date-time)

items[].releaserequired

string

items[].sourcesrequired

array of enum

items[].triggerrequired

enum

Values user_threshold | critical_path | regression

items[].critical_path_hitrequired

boolean

items[].noiserequired

boolean

items[].held_reasonrequired

string

items[].held_atrequired

string (date-time)

items[].resolved_in_releaserequired

string

items[].resolved_atrequired

string (date-time)

items[].regressed_atrequired

string (date-time)

items[].ticketrequired

object

items[].ticket.idrequired

string

items[].ticket.subjectrequired

string

items[].ticket.staterequired

enum

Values

received | triage | needs_info | draft_ready | answered | fixing | awaiting_approval | releasing | customer_notified | closed | escalated

items[].ticket.originrequired

enum

Values email | widget | github | proactive

items[].ticket.resolved_versionrequired

string

items[].ticket.released_atrequired

string (date-time)

next_cursorrequired

string

overviewrequired

object

overview.workspace_idrequired

string

overview.enabledrequired

boolean

overview.plan_allowsrequired

boolean

overview.threshold_usersrequired

integer

overview.critical_pathsrequired

array of string

overview.notify_affected_usersrequired

boolean

overview.monthly_fix_caprequired

integer

overview.fixes_this_monthrequired

integer

overview.pending_ticketsrequired

integer

overview.cap_reachedrequired

boolean

overview.countsrequired

object

overview.counts.watchingrequired

integer

overview.counts.ticketedrequired

integer

overview.counts.resolvedrequired

integer

overview.counts.ignoredrequired

integer

overview.counts.heldrequired

integer

Name

Type

Description

idpathrequired

string

Name

Type

Description

grouprequired

object

group.idrequired

string

group.workspace_idrequired

string

group.statusrequired

enum

Values watching | ticketed | resolved | ignored

group.typerequired

string

group.titlerequired

string

group.affected_usersrequired

integer

group.users_24hrequired

integer

group.event_countrequired

integer

group.events_24hrequired

integer

group.trendrequired

array of integer

group.first_seenrequired

string (date-time)

group.last_seenrequired

string (date-time)

group.releaserequired

string

group.sourcesrequired

array of enum

group.triggerrequired

enum

Values user_threshold | critical_path | regression

group.critical_path_hitrequired

boolean

group.noiserequired

boolean

group.held_reasonrequired

string

group.held_atrequired

string (date-time)

group.resolved_in_releaserequired

string

group.resolved_atrequired

string (date-time)

group.regressed_atrequired

string (date-time)

group.ticketrequired

object

group.ticket.idrequired

string

group.ticket.subjectrequired

string

group.ticket.staterequired

enum

Values

received | triage | needs_info | draft_ready | answered | fixing | awaiting_approval | releasing | customer_notified | closed | escalated

group.ticket.originrequired

enum

Values email | widget | github | proactive

group.ticket.resolved_versionrequired

string

group.ticket.released_atrequired

string (date-time)

normalized_messagerequired

string

sample_stackrequired

string

framesrequired

array of object

frames[].filerequired

string

frames[].functionrequired

string

frames[].linerequired

integer

frames[].columnrequired

integer

frames[].in_apprequired

boolean

frames[].generatedrequired

object

frames[].generated.filerequired

string

frames[].generated.functionrequired

string

frames[].generated.linerequired

integer

frames[].generated.columnrequired

integer

symbolicatedrequired

boolean

eventsrequired

array of object

events[].idrequired

string

events[].sourcerequired

enum

Values widget | sentry | datadog | cloudwatch | endpoint

events[].external_idrequired

string

events[].typerequired

string

events[].levelrequired

string

events[].messagerequired

string

events[].urlrequired

string

events[].browserrequired

string

events[].releaserequired

string

events[].environmentrequired

string

events[].userrequired

string

events[].occurred_atrequired

string (date-time)

events[].symbolicatedrequired

boolean

releasesrequired

array of object

releases[].group_idrequired

string

releases[].releaserequired

string

releases[].statusrequired

enum

Values watching | ticketed | resolved | ignored

releases[].event_countrequired

integer

releases[].affected_usersrequired

integer

releases[].first_seenrequired

string (date-time)

releases[].last_seenrequired

string (date-time)

releases[].resolved_in_releaserequired

string

environmentsrequired

array of string

capabilitiesrequired

object

capabilities.ignorerequired

boolean

capabilities.unignorerequired

boolean

capabilities.resolverequired

boolean

capabilities.open_ticketrequired

boolean

Name

Type

Description

idpathrequired

string

Name

Type

Description

idpathrequired

string

Name

Type

Description

release

string

Name

Type

Description

idpathrequired

string

Name

Type

Description

outcomerequired

enum

Values opened | linked

ticket_idrequired

string

detailrequired

object

detail.grouprequired

object

detail.group.idrequired

string

detail.group.workspace_idrequired

string

detail.group.statusrequired

enum

Values watching | ticketed | resolved | ignored

detail.group.typerequired

string

detail.group.titlerequired

string

detail.group.affected_usersrequired

integer

detail.group.users_24hrequired

integer

detail.group.event_countrequired

integer

detail.group.events_24hrequired

integer

detail.group.trendrequired

array of integer

detail.group.first_seenrequired

string (date-time)

detail.group.last_seenrequired

string (date-time)

detail.group.releaserequired

string

detail.group.sourcesrequired

array of enum

detail.group.triggerrequired

enum

Values user_threshold | critical_path | regression

detail.group.critical_path_hitrequired

boolean

detail.group.noiserequired

boolean

detail.group.held_reasonrequired

string

detail.group.held_atrequired

string (date-time)

detail.group.resolved_in_releaserequired

string

detail.group.resolved_atrequired

string (date-time)

detail.group.regressed_atrequired

string (date-time)

detail.group.ticketrequired

object

detail.group.ticket.idrequired

string

detail.group.ticket.subjectrequired

string

detail.group.ticket.staterequired

enum

Values

received | triage | needs_info | draft_ready | answered | fixing | awaiting_approval | releasing | customer_notified | closed | escalated

detail.group.ticket.originrequired

enum

Values email | widget | github | proactive

detail.group.ticket.resolved_versionrequired

string

detail.group.ticket.released_atrequired

string (date-time)

detail.normalized_messagerequired

string

detail.sample_stackrequired

string

detail.framesrequired

array of object

detail.frames[].filerequired

string

detail.frames[].functionrequired

string

detail.frames[].linerequired

integer

detail.frames[].columnrequired

integer

detail.frames[].in_apprequired

boolean

detail.frames[].generatedrequired

object

detail.frames[].generated.filerequired

string

detail.frames[].generated.functionrequired

string

detail.frames[].generated.linerequired

integer

detail.frames[].generated.columnrequired

integer

detail.symbolicatedrequired

boolean

detail.eventsrequired

array of object

detail.events[].idrequired

string

detail.events[].sourcerequired

enum

Values widget | sentry | datadog | cloudwatch | endpoint

detail.events[].external_idrequired

string

detail.events[].typerequired

string

detail.events[].levelrequired

string

detail.events[].messagerequired

string

detail.events[].urlrequired

string

detail.events[].browserrequired

string

detail.events[].releaserequired

string

detail.events[].environmentrequired

string

detail.events[].userrequired

string

detail.events[].occurred_atrequired

string (date-time)

detail.events[].symbolicatedrequired

boolean

detail.releasesrequired

array of object

detail.releases[].group_idrequired

string

detail.releases[].releaserequired

string

detail.releases[].statusrequired

enum

Values watching | ticketed | resolved | ignored

detail.releases[].event_countrequired

integer

detail.releases[].affected_usersrequired

integer

detail.releases[].first_seenrequired

string (date-time)

detail.releases[].last_seenrequired

string (date-time)

detail.releases[].resolved_in_releaserequired

string

detail.environmentsrequired

array of string

detail.capabilitiesrequired

object

detail.capabilities.ignorerequired

boolean

detail.capabilities.unignorerequired

boolean

detail.capabilities.resolverequired

boolean

detail.capabilities.open_ticketrequired

boolean

Name

Type

Description

idpathrequired

string

GET/v1/error-groups

Parameters

Response 200

GET/v1/error-groups/{id}

Parameters

Response 200

POST/v1/error-groups/{id}/ignore

Parameters

Response 200

POST/v1/error-groups/{id}/resolve

Parameters

Request body

Response 200

POST/v1/error-groups/{id}/ticket

Parameters

Response 201

POST/v1/error-groups/{id}/unignore

Parameters

Response 200

GET/v1/error-groups

Parameters

Response 200

GET/v1/error-groups/{id}

Parameters

Response 200

POST/v1/error-groups/{id}/ignore

Parameters

Response 200

POST/v1/error-groups/{id}/resolve

Parameters

Request body

Response 200

POST/v1/error-groups/{id}/ticket

Parameters

Response 201

POST/v1/error-groups/{id}/unignore

Parameters

Response 200

GET`/v1/error-groups`

Response `200`

GET`/v1/error-groups/{id}`

Response `200`

POST`/v1/error-groups/{id}/ignore`

Response `200`

POST`/v1/error-groups/{id}/resolve`

Response `200`

POST`/v1/error-groups/{id}/ticket`

Response `201`

POST`/v1/error-groups/{id}/unignore`

Response `200`

GET`/v1/error-groups`

Response `200`

GET`/v1/error-groups/{id}`

Response `200`

POST`/v1/error-groups/{id}/ignore`

Response `200`

POST`/v1/error-groups/{id}/resolve`

Response `200`

POST`/v1/error-groups/{id}/ticket`

Response `201`

POST`/v1/error-groups/{id}/unignore`

Response `200`