Skip to main content

MALFORMED_REQUEST

The request body did not match the schema of the endpoint.

HTTP status400
GroupRelay path
RetryableNo — sending it again changes nothing
Re-signNONE — do not ask the user to sign anything

What happened​

A required field is missing, a field has the wrong JSON type, or a value is outside the range the schema allows.

What to do​

Read details.field, fix the request and send it again. Validate against /openapi.yaml before retrying in a loop.

Extra members​

This code carries field in the problem document, on top of the common members.

The problem document​

Every error is application/problem+json (RFC 9457) with the same shape:

{
"type": "https://docs.co-relayer.com/errors/malformed-request",
"title": "The request body did not match the schema of the endpoint.",
"status": 400,
"detail": "A sentence about this specific occurrence.",
"instance": "req_01JB…",
"code": "MALFORMED_REQUEST",
"retryable": false,
"resign": "NONE",
"hint": "Read `details.field`, fix the request and send it again. Validate against `/openapi.yaml` before retrying in a loop."
}

See the error model for what each member means and how to handle unknown codes.