TRtriggerdotdev
errors

List errors

Changed on

List error groups in a specific environment. Runs that fail are grouped by a fingerprint derived from the error type, message, and stack trace. Filter by task identifier, version, status, search text, and time range.

get/api/v1/errors

Request

Query parameters

sizeinteger

Number of errors per page. Maximum is 100.

afterstring

The ID of the error to start the page after. Sets the pagination direction to forward.

beforestring

The ID of the error to start the page before. Sets the pagination direction to backward.

Paginate the results. Specify the number of errors per page, and the ID of the error to start the page after or before.

For object fields like page, use the "form" encoding style. For example, to get the next page, use page[after]=error_1234.

taskIdentifierstring[]

The identifier of the task the error belongs to

versionstring[]

The worker version the error occurred in

statusstring[]

The lifecycle status of the error group

searchstring

Free-text search across the error type and message

fromstring date-time

The start of the time range to count occurrences within

tostring date-time

The end of the time range to count occurrences within

periodstring

A relative time range to count occurrences within

Filter the error groups. Filter by task identifier, version, status, search text, and time range.

For array fields, provide multiple values as a comma-separated list. For example, to get unresolved and ignored errors, use filter[status]=unresolved,ignored.

For the time range, use filter[period] (e.g. filter[period]=7d) or filter[from] / filter[to] with ISO timestamps.

{
  "period": "7d"
}

Response

Successful request

Example response

{
  "data": [
    {
      "id": "error_8f3b2a1c9d4e5f60"
    }
  ],
  "pagination": {
    "next": "error_8f3b2a1c9d4e5f60"
  }
}

Changes