Events & ExportSingle exception issue

Single exception issue

The detail-header view: the same aggregates and volume_series as a list row, fetched by the stable issue_id. Returns 404 (issue_not_found) when no occurrences match the id in the window.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/data/exceptions/issues/example_string?location_id=example_string&date_from=2024-12-25&date_to=2024-12-25&hours_back=42&segment_id=123e4567-e89b-12d3-a456-426614174000&exclude_segment_id=123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -H "X-Location-Id: example_string" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": {
    "issue_id": "v1:1d908dc6145bd8dc7982aff9366b5042",
    "exception_type": "TypeError",
    "message": "Cannot read properties of null (reading 'addEventListener')",
    "culprit": "handler in app.js",
    "first_seen": "2024-12-25T10:00:00Z",
    "last_seen": "2024-12-25T10:00:00Z",
    "occurrences": 366,
    "sessions": 204,
    "users": 183,
    "volume_series": [
      {
        "bucket": "2024-12-25T10:00:00Z",
        "count": 10
      }
    ]
  }
}
GET
/exceptions/issues/{id}
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.

Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.
path
idstring
Required

The stable issue_id from the issue list.

query
location_idstring

Alternative to the X-Location-Id header for agency (ak_) keys. Ignored for secret (sk_) keys.

query
date_fromstring

Start date (YYYY-MM-DD).

Format: date
query
date_tostring

End date (YYYY-MM-DD).

Format: date
query
segment_idstring

Scope results to members of a saved segment (created via the Segments API). Two independent time filters apply: the segment decides WHICH PEOPLE qualify (a live definition, evaluated at query time — not stored membership), and date_from/date_to decides WHICH OF THEIR ROWS are returned. A person who qualifies today contributes all their sessions/events inside the date window — including ones unrelated to how they qualified; there is no "only rows from while they were a member". For first/last attribution scopes membership runs through the identity graph (a row counts when its distinct_id maps to a matching person); a segment with attribution: "session" instead matches visitors directly against the sessions store ("ever had a session that arrived via X"), with no identity-graph dependency. Composable with all other filters. Unknown or foreign id → 404 segment_not_found.

Format: uuid
query
exclude_segment_idstring

Scope results OUT — exclude rows from members of a saved segment (the inverse of segment_id, evaluated the same live way). Fully composable with segment_id: scope to one segment and exclude another simultaneously. The primary use is stripping your own QA/test traffic — which is often anonymous, so a rule-based segment (email domain, known ids) catches it with no SDK changes on the client's site. Unknown or foreign id → 404 exclude_segment_not_found.

Format: uuid
header
X-Location-Idstring

Location to scope the request to. Required for agency (ak_) keys on the event routes. Ignored for secret (sk_) keys, which resolve their own location, and not used by /export.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.

Path Parameters

idstring
Required

The stable issue_id from the issue list.

Query Parameters

location_idstring

Alternative to the X-Location-Id header for agency (ak_) keys. Ignored for secret (sk_) keys.

date_fromstring

Start date (YYYY-MM-DD).

date_tostring

End date (YYYY-MM-DD).

segment_idstring

Scope results to members of a saved segment (created via the Segments API). Two independent time filters apply: the segment decides WHICH PEOPLE qualify (a live definition, evaluated at query time — not stored membership), and date_from/date_to decides WHICH OF THEIR ROWS are returned. A person who qualifies today contributes all their sessions/events inside the date window — including ones unrelated to how they qualified; there is no "only rows from while they were a member". For first/last attribution scopes membership runs through the identity graph (a row counts when its distinct_id maps to a matching person); a segment with attribution: "session" instead matches visitors directly against the sessions store ("ever had a session that arrived via X"), with no identity-graph dependency. Composable with all other filters. Unknown or foreign id → 404 segment_not_found.

exclude_segment_idstring

Scope results OUT — exclude rows from members of a saved segment (the inverse of segment_id, evaluated the same live way). Fully composable with segment_id: scope to one segment and exclude another simultaneously. The primary use is stripping your own QA/test traffic — which is often anonymous, so a rule-based segment (email domain, known ids) catches it with no SDK changes on the client's site. Unknown or foreign id → 404 exclude_segment_not_found.

Headers

X-Location-Idstring

Location to scope the request to. Required for agency (ak_) keys on the event routes. Ignored for secret (sk_) keys, which resolve their own location, and not used by /export.

Responses

successboolean
dataobject

One grouped exception issue. issue_id is stable across requests and deploys — persist resolve/ignore state against it.