Skip to main content
POST
SubmitErrorReport

Headers

Idempotency-Key
string

Optional client-generated idempotency key. Retrying a POST with the same key and an identical request body replays the original response (only the status, body, and Content-Type are reproduced) instead of re-executing; reusing the key with a different body is rejected with 422. For mutations this avoids duplicating the side effect, while for batch-read POSTs it replays a cached snapshot that can be up to 24 hours stale. Keys are scoped per authenticated caller (falling back to the source IP for unauthenticated endpoints) and retained for 24 hours.

Required string length: 1 - 255
Pattern: ^[\x21-\x7E]{1,255}$

Body

application/json

SubmitErrorReportRequest is a reader's report that a WorldMonitor label or story is wrong. Stored for review; never applied automatically.

message
string

What is wrong, in the reader's words.

Required string length: 10 - 2000
storyId
string

Story identity hash the report concerns, when known (64 hex characters).

Maximum string length: 64
url
string

Article or WorldMonitor URL the report concerns, when known.

Maximum string length: 2048
contact
string

Optional email for a reply. Never published.

Maximum string length: 320
website
string

Honeypot. Leave empty: a filled value is accepted and discarded.

Response

Successful response

SubmitErrorReportResponse acknowledges a stored report.

status
string

received | queue-full.

reportId
string

Report id, empty unless received.