## ReportErrors

**post** `/gitpod.v1.ErrorsService/ReportErrors`

ReportErrors allows clients to report batches of errors that will be sent to error reporting systems.
The structure is fully compatible with Sentry's event payload format.

Use this method to:

- Report client-side errors and exceptions
- Track application crashes and panics
- Send error context and metadata for debugging

### Examples

- Report a JavaScript error with Sentry-compatible structure:
  The service accepts events with comprehensive error information
  including stack traces, identity context, breadcrumbs, and metadata
  that align with Sentry's event payload format.

### Body Parameters

- `events: optional array of ErrorEvent`

  Error events to be reported (batch) - now using Sentry-compatible structure

  - `breadcrumbs: optional array of Breadcrumb`

    Breadcrumbs leading up to the error

    - `category: optional string`

      Breadcrumb category

    - `data: optional map[string]`

      Additional breadcrumb data

    - `level: optional ErrorLevel`

      Breadcrumb level

      - `"ERROR_LEVEL_UNSPECIFIED"`

      - `"ERROR_LEVEL_DEBUG"`

      - `"ERROR_LEVEL_INFO"`

      - `"ERROR_LEVEL_WARNING"`

      - `"ERROR_LEVEL_ERROR"`

      - `"ERROR_LEVEL_FATAL"`

    - `message: optional string`

      Breadcrumb message

    - `timestamp: optional string`

      When the breadcrumb occurred

    - `type: optional string`

      Breadcrumb type (e.g., "navigation", "http", "user", "error")

  - `environment: optional string`

    Environment (e.g., "production", "staging", "development")

  - `eventId: optional string`

    Unique event identifier (required by Sentry)

  - `exceptions: optional array of ExceptionInfo`

    Exception information (primary error data)

    - `mechanism: optional ExceptionMechanism`

      Exception mechanism

      - `data: optional map[string]`

        Additional mechanism-specific data

      - `description: optional string`

        Human-readable description of the mechanism

      - `handled: optional boolean`

        Whether the exception was handled by user code

      - `synthetic: optional boolean`

        Whether this is a synthetic exception (created by SDK)

      - `type: optional string`

        Type of mechanism (e.g., "generic", "promise", "onerror")

    - `module: optional string`

      Module or package where the exception type is defined

    - `stacktrace: optional array of StackFrame`

      Stack trace frames

      - `colno: optional number`

        Column number in the line

      - `contextLine: optional string`

      - `filename: optional string`

        File name or path

      - `function: optional string`

        Function name

      - `inApp: optional boolean`

        Whether this frame is in application code (vs library/framework code)

      - `lineno: optional number`

        Line number in the file

      - `module: optional string`

        Module or package name

      - `postContext: optional array of string`

      - `preContext: optional array of string`

        Source code context around the error line

      - `vars: optional map[string]`

        Additional frame-specific variables/locals

    - `threadId: optional string`

      Thread ID if applicable

    - `type: optional string`

      Exception type/class name

    - `value: optional string`

      Exception message/value

  - `extra: optional map[string]`

    Additional arbitrary metadata

  - `fingerprint: optional array of string`

    Custom fingerprint for grouping

  - `identityId: optional string`

    Identity ID of the user (UUID)

  - `level: optional ErrorLevel`

    Error severity level

  - `logger: optional string`

    Logger name

  - `modules: optional map[string]`

    Modules/dependencies information

  - `platform: optional string`

    Platform identifier (required by Sentry)

  - `release: optional string`

    Release version

  - `request: optional RequestInfo`

    Request information

    - `data: optional string`

      Request body (truncated if large)

    - `headers: optional map[string]`

      Request headers

    - `method: optional string`

      HTTP method

    - `queryString: optional map[string]`

      Query parameters

    - `url: optional string`

      Request URL

  - `sdk: optional map[string]`

    SDK information

  - `serverName: optional string`

    Server/host name

  - `tags: optional map[string]`

    Tags for filtering and grouping

  - `timestamp: optional string`

    When the event occurred (required by Sentry)

  - `transaction: optional string`

    Transaction name (e.g., route name, function name)

### Example

```http
curl https://app.gitpod.io/api/gitpod.v1.ErrorsService/ReportErrors \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $GITPOD_API_KEY" \
    -d '{}'
```

#### Response

```json
{}
```