---
title: "Ignore an error"
method: POST
path: "/api/v1/errors/{errorId}/ignore"
tags: ["errors"]
---

# Ignore an error

`POST /api/v1/errors/{errorId}/ignore`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/errors/{errorId}/ignore`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/errors/:errorId/ignore/post.ts> (a function with typed inputs; its response is checked against the schema)

Mark an error group as ignored. Provide a `duration` to ignore it for a fixed window, and/or thresholds that re-surface the error when exceeded. Send a JSON body (use `{}` to ignore indefinitely).

## Request body

- object
  - `duration` integer: How long to ignore the error for, in milliseconds.
  - `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 `200`

Successful request

- ErrorObject
  - `id` string, required: The unique ID of the error group, prefixed with `error_`
  - `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` 'unresolved' | 'resolved' | 'ignored', required
  - `resolvedAt` string, date-time, nullable
  - `resolvedInVersion` string, nullable
  - `resolvedBy` string, nullable: The ID of the user who resolved the error, when attributable
  - `ignoredAt` string, date-time, nullable
  - `ignoredUntil` string, date-time, nullable
  - `ignoredReason` string, nullable
  - `ignoredByUserId` string, nullable
  - `ignoredUntilOccurrenceRate` number, nullable
  - `ignoredUntilTotalOccurrences` integer, nullable

## Other responses

- `401`: Unauthorized request
- `404`: Error not found

## Changes

- **2026-06-21** `87f56eb19e57`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/errors/:errorId/ignore/post.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)