Skip to content

Missing Request Part

URI: https://docs.ankatech.co/errors/missing-request-part

HTTP Status: 400 Bad Request

When you see this

The server expected a specific multipart/form-data part (file or field) but did not receive it.

Spring raised a MissingServletRequestPartException, and the API converted it to an RFC 7807 problem response.

Common Causes

  • You omitted the required file or form field in your request.

  • The HTML form or client code uses a different name attribute than the one the endpoint expects.

  • The request's Content-Type is not set to multipart/form-data (e.g., you sent JSON instead).

  • A proxy or gateway stripped the multipart boundary, corrupting the payload.

  • You sent an empty file or an empty field when the API requires a non-empty value.

How to Resolve

  1. Review the response detail to identify the missing part name (e.g., file, certificate, jwk).

  2. Ensure the client sets Content-Type: multipart/form-data and includes the required boundary.

  3. Verify each <input type="file" name="..."> or multipart field name matches the API specification.

  4. Confirm that every required part contains data (non-zero length for files, non-blank for text fields).

  5. If you must send optional fields, mark them as such in the request or consult the endpoint's schema.

If you continue to see a 400 error after these steps, please consult the full API Reference.