Submit a sanitized diagnostic report to this instance

Only the allowlisted diagnostic envelope is accepted. User content, credentials, and request bodies are rejected during validation.

POST/diagnostics/report

Authorization

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

attempt_count?integer

Attempt count, when relevant

Formatint64

Range0 <= value

error_code*string

Normalized error code from the diagnostics catalog

Lengthlength <= 64

frames?array<>|

Sanitized stack frames without domains or local paths

Itemsitems <= 24

http_status?integer

HTTP status, when relevant

Formatint64

Range0 <= value <= 599

operation*string

Route template, job type, or operation name

Lengthlength <= 160

provider?string

First-party platform, when relevant

Lengthlength <= 32

retry_count?integer

Retry count, when relevant

Formatint64

Range0 <= value

surface*string

Surface where the failure was observed

Value in

"browser"
"backend"
"worker"

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/diagnostics/report" \  -H "Content-Type: application/json" \  -d '{    "error_code": "string",    "operation": "string",    "surface": "browser"  }'

{  "$schema": "https://example.com/api/v1/schemas/SubmitDiagnosticsOutputBody.json",  "accepted": true,  "enabled": true}

Submit a sanitized diagnostic report to this instance

Authorization

Request Body

Response Body

200application/json

400application/problem+json

413application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`