415
415 Unsupported Media Type Error
What This Error Means
The 415 Unsupported Media Type error indicates that the server refuses to accept the request because the payload format is in an unsupported format. While similar to 406 Not Acceptable, the distinction is important: a 406 error means the server cannot produce the response the client wants, whereas a 415 error means the client sent data (like a file upload or API body) that the server does not know how to process. This is common in REST APIs when a client sends XML to an endpoint that only understands JSON.
Common Causes
- Sending a request with the wrong Content-Type header (e.g., sending application/xml when the server expects application/json).
- Uploading an image format (like WebP or HEIC) that the backend image processor does not support.
- Missing Content-Type header entirely, causing the server to guess incorrectly or reject the data.
- API version mismatches where the newer client sends a format the older server version does not yet recognize.
How to Fix It (For Users)
- 1 Check the file extension and format of any file you are trying to upload.
- 2 If using an API tool, verify that your Content-Type header matches the API documentation.
- 3 Convert files to standard formats like JPG, PNG, or PDF before uploading.
For Site Owners / Developers
- Inspect the Content-Type header of incoming requests in your access logs.
- Ensure your application's body parser is configured to handle the formats you expect (e.g., enabling JSON parsing in Express or PHP).
- Provide clear error messages indicating which media types are allowed.
- Update your API documentation to explicitly state supported Content-Types.
When It Is NOT Your Fault
If the API documentation claims to support a format but the server is misconfigured to reject it.
Check if this outage affects everyone globally
This error often indicates a wider problem. Use our tool to verify if the site is down for everyone.
Check Website Status →Recommended Tool to Prevent This Error
Prevent server timeouts and resource exhaustion with scalable cloud infrastructure.