Ingest a cross-instance diagnostic report

Public receiver for privacy-limited diagnostic reports sent by OpenPost instances. Strictly validated and quota-limited; accepted reports are forwarded to the maintainer channel.

POST/diagnostics/ingest

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 <= 1000000

db_driver?string

Normalized database driver

Lengthlength <= 16

error_code*string

Normalized error code from the diagnostics catalog

Lengthlength <= 64

first_seen?string

RFC3339 first observation, when known

Lengthlength <= 32

frames?array<>|

Sanitized stack frames without domains or local paths

Itemsitems <= 24

http_status?integer

HTTP status, when relevant

Formatint64

Range0 <= value <= 599

installation_id*string

Random installation ID generated by the sending instance

Lengthlength <= 64

last_seen?string

RFC3339 last observation, when known

Lengthlength <= 32

occurrence_count?integer

Aggregated occurrence count

Formatint64

Range0 <= value <= 1000000

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 <= 1000000

revision*string

OpenPost source revision reported by the sending instance

Lengthlength <= 128

storage_driver?string

Normalized media storage driver

Lengthlength <= 16

surface*string

Surface where the failure was observed

Value in

"browser"
"backend"
"worker"

version*string

OpenPost release reported by the sending instance

Lengthlength <= 64

Response Body

`application/json`

`application/problem+json`

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

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

Ingest a cross-instance diagnostic report

Authorization

Request Body

Response Body

200application/json

400application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

503application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`