---
title: "Report Frontend Error"
method: POST
path: "/api/v1/utils/report-error"
tags: ["utils"]
---

# Report Frontend Error

`POST /api/v1/utils/report-error`

## Request

- Base URL: `https://api.komos.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.komos.ai/api/v1/utils/report-error`
- Auth: none declared

Receive error reports from the frontend application.

This endpoint accepts error reports from the Next.js app's error boundaries
and global error handlers. It creates GitHub issues for production errors
using the same auto-issue system as the backend.

Includes PostHog session ID for direct link to session replay.

No authentication required - this allows error reporting even when
auth state is broken. Rate limiting is handled by fingerprint deduplication.

## Request body

- FrontendErrorReport: Error report from the frontend application.
  - `message` string, required: Error message
  - `stack_trace` string, nullable: Stack trace
  - `url` string, nullable: Page URL where error occurred
  - `component` string, nullable: Component name
  - `user_agent` string, nullable: Browser user agent
  - `extra` object, nullable: Additional context
  - `posthog_session_id` string, nullable: PostHog session ID for replay
  - `posthog_distinct_id` string, nullable: PostHog distinct ID (user)
  - `user_id` string, nullable: Clerk user ID
  - `user_email` string, nullable: User email
  - `org_id` string, nullable: Organization ID
  - `task_id` string, nullable: Task ID from URL
  - `run_id` string, nullable: Run ID from URL
  - `screen_size` string, nullable: Screen dimensions

## Response `200`

Successful Response

- FrontendErrorResponse: Response for frontend error report.
  - `ok` boolean, required
  - `message` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/komos/apis/komos-backend.md) · [All operations](https://skmtc.dev/komos/apis/komos-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/komos/apis/komos-backend/revisions/f10e153fab38?raw)