Diagnostics

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

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/diagnostics/report
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Request body

$schemastring uri

A URL to the JSON Schema for this object.

attempt_countinteger

Attempt count, when relevant

error_codestring required

Normalized error code from the diagnostics catalog

error_kind'deadline_exceeded' | 'canceled' | 'not_found' | 'permission_denied' | 'connection_refused' | 'connection_reset' | 'unexpected_eof' | 'dns_error' | 'network_timeout' | 'runtime_error' | 'type_error' | 'reference_error' | 'range_error' | 'syntax_error' | 'quota_exceeded' | 'security_error' | 'not_supported' | 'invalid_state' | 'abort_error' | 'network_error'

Allowlisted error type, never message text

http_method'GET' | 'HEAD' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'CONNECT' | 'TRACE'

HTTP request method, when relevant

http_statusinteger

HTTP status, when relevant

operationstring required

Route template, job type, or operation name

providerstring

First-party platform, when relevant

retry_countinteger

Retry count, when relevant

surface'browser' | 'backend' | 'worker' required

Surface where the failure was observed

Example request

{
  "$schema": "https://example.com/api/v1/schemas/SubmitDiagnosticsInputBody.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

acceptedboolean required
enabledboolean required

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.