Where it is raised
- Checks: 8 routes
- Incidents: 1 route
- Errors: 1 route
- Agents: 3 routes
- The agent maintenance window routes on the ingest service (the same code, with the first failing hosts or field named)
What triggers it
The first validation step on every monitor route: the body is read as JSON and checked against the route's schema, and the first issue becomes the message. Query problems use it too: limit outside 1 to 500 and a before that is not an ISO 8601 timestamp on the runs route, and a format that is not csv or json on the exports.
Example response
POST /api/v1/checks
HTTP 400
{
"error": "Request body must be valid JSON.",
"code": "RU-3001"
}Common causes
- A missing required field (name, url, intervalSeconds, regions).
- A value outside its allowed range, or the wrong type.
- A request body that isn't valid JSON.
How to fix it
- Read the `error` field: it names the failing field and the rule it broke.
- Compare your payload against the API docs at /docs/api.
- Send the corrected request; nothing was created or changed by the refused one.