Where it is raised
- Errors ingest (/api/errors/v1/ingest)
What triggers it
The batch parser refuses the whole body for the first failing field. A batch of more than 50 events fails here too, with events must contain 50 entries or fewer. The refusal is counted as dropped malformed events, one per event in the array when its length is readable. Entries over the hard map limit take RU-4009 instead.
Example response
POST /api/errors/v1/ingest/<key>
HTTP 400
{
"error": "Body must be valid JSON.",
"reason": "malformed",
"code": "RU-4004"
}Common causes
- A hand-rolled client not matching the ingest payload shape.
- A field with the wrong type (for example a numeric string where a number is required).
- An empty events array, or a batch over the per-batch event cap.
How to fix it
- Read the `error` field: it names the exact failing field.
- Use an official SDK, or match its payload shape exactly.
- Resend the corrected batch; the refused one wrote nothing.