Report a browser-side edge or fatal failure the API never saw.
POST /api/v1/client-errors. Report a browser-side edge or fatal failure the API never saw.
Request
POST /api/v1/client-errors
The schema permits anonymous access.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
Request body
A body is required.
Content type: application/json
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
cfRay | string | No | pattern: ^[0-9a-f]{16}-[A-Z]{3,4}$ | — |
clientRequestId | string | No | pattern: ^[A-Za-z0-9._:-]{8,128}$ | — |
digest | string | No | pattern: ^[A-Za-z0-9_-]{1,64}$ | — |
kind | string | Yes | allowed: "edge_html", "edge_413", "edge_502", "edge_503", "edge_504", "network", "timeout", "invalid_json", "render_fatal" | — |
release | string | No | pattern: ^[A-Za-z0-9._-]{1,64}$ | — |
requestId | string | No | pattern: ^[A-Za-z0-9._:-]{8,128}$ | — |
route | string | Yes | pattern: ^\/[A-Za-z0-9/_.:~[\]-]{0,199}$ | — |
status | integer | Yes | minimum: 0; maximum: 599 | — |
Additional fields are not allowed.
cURL
Create request.json using the request-body schema. The example sends the file bytes unchanged.
curl --fail-with-body --silent --show-error \
--request POST \
--url "https://launch-api.supanova.app/api/v1/client-errors" \
--header "Content-Type: application/json" \
--data-binary @request.jsonResponses
204
Recorded (or deduplicated).
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
400
The request is malformed or failed validation. Codes: VALIDATION_FAILED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
413
The request body exceeds the size limit.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
429
The caller exceeded an IP or principal request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
default
Machine-readable API error. The HTTP status identifies the error class.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.