MuleSoft · APIkit for REST

APIKIT:BAD_REQUEST

Short answer

APIKIT:BAD_REQUEST is the APIkit for REST error type that maps to HTTP status 400 with the response message "Bad request". APIkit validates incoming requests against your RAML or OAS API specification, so compare the failing request with the specification.

Needs verificationLast reviewed

Needs verification. The error type, its HTTP status code and its response message are confirmed in the APIkit error handling reference. The documentation pages checked do not state exactly which request condition raises this type, so the causes below are not confirmed. Treat it as a starting point, not as a confirmed fix.

01Error text

MuleSoft error
Error type: APIKIT:BAD_REQUEST

HTTP status: 400
Response message: Bad request

02Likely causes

  • Unconfirmed: the request does not satisfy the rules of the API specification, such as a body, query parameter or header that fails validation.
  • APIkit for REST automatically validates incoming requests against the API contract defined in RAML or OAS.

03How to fix it

  1. Read the full error description in the log to see which part of the request was rejected.
  2. Compare the failing request with the API specification the APIkit router uses, and correct whichever of the two is wrong.
  3. To control what the caller receives, add an On Error Propagate handler with the type APIKIT:BAD_REQUEST that sets the response body and an httpStatus variable of 400. The APIkit scaffolder can generate this baseline handler.
  4. Adapt the handler if your API needs a custom status code or message.

iNotes

The APIkit router has attributes that change what it validates: queryParamsStrictValidation (validates that request query parameters are defined in the RAML file), headerStrictValidation (validates that request headers are defined in the RAML file or belong to a well-known set of headers) and disableValidations (disables validations of requests).

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for MuleSoft work:Open MuleSoft jobsMuleSoft rates and salariesHire a senior MuleSoft developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.