> ## Documentation Index
> Fetch the complete documentation index at: https://trigger.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an error

> Retrieve detailed information about a single error group, including its lifecycle state and the worker versions it has affected.



## OpenAPI

````yaml v3-openapi GET /api/v1/errors/{errorId}
openapi: 3.1.0
info:
  title: Trigger.dev v3 REST API
  description: >-
    The REST API lets you trigger and manage runs on Trigger.dev. You can
    trigger a run, get the status of a run, and get the results of a run. 
  version: 2024-04
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.trigger.dev
    description: Trigger.dev API
security: []
paths:
  /api/v1/errors/{errorId}:
    parameters:
      - $ref: '#/components/parameters/errorId'
    get:
      tags:
        - errors
      summary: Retrieve an error
      description: >-
        Retrieve detailed information about a single error group, including its
        lifecycle state and the worker versions it has affected.
      operationId: retrieve_error_v1
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorObject'
        '401':
          description: Unauthorized request
        '404':
          description: Error not found
      security:
        - secretKey: []
      x-codeSamples:
        - lang: curl
          label: Retrieve an error
          source: >-
            curl -X GET
            "https://api.trigger.dev/api/v1/errors/error_8f3b2a1c9d4e5f60" \
              -H "Authorization: Bearer $TRIGGER_SECRET_KEY"
components:
  parameters:
    errorId:
      in: path
      name: errorId
      required: true
      schema:
        type: string
      description: The ID of an error group, starts with `error_`.
      example: error_8f3b2a1c9d4e5f60
  schemas:
    ErrorObject:
      type: object
      required:
        - id
        - fingerprint
        - taskIdentifier
        - errorType
        - errorMessage
        - status
        - count
        - firstSeen
        - lastSeen
        - affectedVersions
      properties:
        id:
          type: string
          description: The unique ID of the error group, prefixed with `error_`
          example: error_8f3b2a1c9d4e5f60
        fingerprint:
          type: string
          description: The raw fingerprint the error is grouped by
        taskIdentifier:
          type: string
          description: The identifier of the task the error belongs to
        errorType:
          type: string
          description: The error type or name (e.g. `TypeError`)
        errorMessage:
          type: string
          description: The normalized error message
        count:
          type: integer
          description: The total number of occurrences of this error group
        firstSeen:
          type: string
          format: date-time
        lastSeen:
          type: string
          format: date-time
        affectedVersions:
          type: array
          items:
            type: string
          description: >-
            The most recent worker versions the error has occurred in (up to
            five)
        status:
          type: string
          enum:
            - unresolved
            - resolved
            - ignored
        resolvedAt:
          type: string
          format: date-time
          nullable: true
        resolvedInVersion:
          type: string
          nullable: true
        resolvedBy:
          type: string
          nullable: true
          description: The ID of the user who resolved the error, when attributable
        ignoredAt:
          type: string
          format: date-time
          nullable: true
        ignoredUntil:
          type: string
          format: date-time
          nullable: true
        ignoredReason:
          type: string
          nullable: true
        ignoredByUserId:
          type: string
          nullable: true
        ignoredUntilOccurrenceRate:
          type: number
          nullable: true
        ignoredUntilTotalOccurrences:
          type: integer
          nullable: true
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: >
        Use a named environment API key. It starts with `tr_dev_sk_`,
        `tr_prod_sk_`, `tr_stg_sk_`, etc.


        Create a named API key in the API Keys section of your Trigger.dev
        project dashboard. Choose the narrowest access preset that supports your
        integration.


        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.


        ```typescript

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


        configure({ accessToken: "tr_dev_sk_1234" });

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.