MuleSoft · APIkit for REST
APIKIT:UNSUPPORTED_MEDIA_TYPE
APIKIT:UNSUPPORTED_MEDIA_TYPE is the APIkit for REST error type that maps to HTTP status 415 with the response message "Unsupported media type". APIkit validates incoming requests against your RAML or OAS API specification, so compare the failing request with the specification.
Needs verificationLast reviewed
01Error text
Error type: APIKIT:UNSUPPORTED_MEDIA_TYPE
HTTP status: 415
Response message: Unsupported media type02Likely causes
- Unconfirmed: the request's
Content-Typeis not one the API specification defines for that resource and method. - APIkit for REST automatically validates incoming requests against the API contract defined in RAML or OAS.
03How to fix it
- Check the
Content-Typeheader of the request against the media types the API specification defines for that resource and method. - Compare the failing request with the API specification the APIkit router uses, and correct whichever of the two is wrong.
- To control what the caller receives, add an On Error Propagate handler with the type
APIKIT:UNSUPPORTED_MEDIA_TYPEthat sets the response body and anhttpStatusvariable of 415. The APIkit scaffolder can generate this baseline handler. - 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
→Related errors
- APIKIT:BAD_REQUESTAPIKIT: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.
- APIKIT:METHOD_NOT_ALLOWEDAPIKIT:METHOD_NOT_ALLOWED is the APIkit for REST error type that maps to HTTP status 405 with the response message "Method not allowed". APIkit validates incoming requests against your RAML or OAS API specification, so compare the failing request with the specification.
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