Skip to main content
POST
/
api
/
v1
/
errors
/
{errorId}
/
ignore
Ignore an error
curl -X POST "https://api.trigger.dev/api/v1/errors/error_8f3b2a1c9d4e5f60/ignore" \
  -H "Authorization: Bearer $TRIGGER_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration": 86400000, "reason": "Known flaky dependency"}'
{
  "id": "error_8f3b2a1c9d4e5f60",
  "fingerprint": "<string>",
  "taskIdentifier": "<string>",
  "errorType": "<string>",
  "errorMessage": "<string>",
  "count": 123,
  "firstSeen": "2023-11-07T05:31:56Z",
  "lastSeen": "2023-11-07T05:31:56Z",
  "affectedVersions": [
    "<string>"
  ],
  "resolvedAt": "2023-11-07T05:31:56Z",
  "resolvedInVersion": "<string>",
  "resolvedBy": "<string>",
  "ignoredAt": "2023-11-07T05:31:56Z",
  "ignoredUntil": "2023-11-07T05:31:56Z",
  "ignoredReason": "<string>",
  "ignoredByUserId": "<string>",
  "ignoredUntilOccurrenceRate": 123,
  "ignoredUntilTotalOccurrences": 123
}

Authorizations

​
Authorization
string
header
required

Use your project-specific Secret API key. Will start with tr_dev_, tr_prod, tr_stg, etc.

You can find your Secret API key in the API Keys section of your Trigger.dev project dashboard.

Our TypeScript SDK will default to using the value of the TRIGGER_SECRET_KEY environment variable if it is set. If you are using the SDK in a different environment, you can set the key using the configure function.

import { configure } from "@trigger.dev/sdk";

configure({ accessToken: "tr_dev_1234" });

Path Parameters

​
errorId
string
required

The ID of an error group, starts with error_.

Body

application/json
​
duration
integer

How long to ignore the error for, in milliseconds.

Example:

86400000

​
occurrenceRate
number

Re-surface the error if its occurrence rate exceeds this many occurrences per minute.

​
totalOccurrences
integer

Re-surface the error once it accrues this many new occurrences after being ignored.

​
reason
string

An optional human-readable reason for ignoring the error.

Response

Successful request

​
id
string
required

The unique ID of the error group, prefixed with error_

Example:

"error_8f3b2a1c9d4e5f60"

​
fingerprint
string
required

The raw fingerprint the error is grouped by

​
taskIdentifier
string
required

The identifier of the task the error belongs to

​
errorType
string
required

The error type or name (e.g. TypeError)

​
errorMessage
string
required

The normalized error message

​
count
integer
required

The total number of occurrences of this error group

​
firstSeen
string<date-time>
required
​
lastSeen
string<date-time>
required
​
affectedVersions
string[]
required

The most recent worker versions the error has occurred in (up to five)

​
status
enum<string>
required
Available options:
unresolved,
resolved,
ignored
​
resolvedAt
string<date-time> | null
​
resolvedInVersion
string | null
​
resolvedBy
string | null

The ID of the user who resolved the error, when attributable

​
ignoredAt
string<date-time> | null
​
ignoredUntil
string<date-time> | null
​
ignoredReason
string | null
​
ignoredByUserId
string | null
​
ignoredUntilOccurrenceRate
number | null
​
ignoredUntilTotalOccurrences
integer | null