Stock update using REST API PUT Method gives error 'Invalid content type' Magento 2

Stock update using REST API PUT Method gives error 'Invalid content type' Magento 2

October 5, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Stock update using REST API PUT Method gives error 'Invalid content type' Magento 2

Solving “Content-Type header is invalid” Error for Magento 2 REST API PUT Method

Dear developer,

Are you facing the dreaded “Content-Type header is invalid” error when trying to update stock using the Magento 2 REST API PUT method? You’re not alone! Let’s dive into why this happens and how to fix it.

Understanding the “Invalid Content Type” Error

This error occurs because Magento expects a specific format for your request. It needs to understand that you’re sending JSON data, which is indicated by setting Content-Type: application/json in your API call header. However, something in your setup isn’t communicating this correctly.

Debugging Your Configuration

Currently, your configuration looks like this:

At first glance, everything seems correct according to Magento’s official documentation. So why the “Content-Type header is invalid” error?

The Hidden Culprit: JSON Encapsulation

The issue lies in how you’re sending your data. While you’ve set Content-Type: application/json, Magento expects JSON data to be encapsulated within a parent object.

Your current setup sends this:

stockItems: 10

But Magento wants something like this (note the outer curly braces):

{
    "stockItem": {
        "sku": "{sku_of_product}",
        "qty": 10,
        "item_id": {item_id}
    }
}

The stockItem object is required for the PUT operation. Replace {item_id} with the actual item ID of the product.

The Fix: Wrapping Your Data

To resolve this, update your Body in Postman to look like this:

{
    "stockItem": {
        "sku": "{sku_of_product}",
        "qty": 10,
        "item_id": {item_id}
    }
}

Ensure you replace {sku_of_product} with the actual SKU of your product and {item_id} with its corresponding item ID from the database.

Testing Again

With this change, your updated configuration should look like this:

Your updated Body is the JSON object we created above. Test your API again, and with luck, you should now see a successful stock update instead of the “Content-Type header is invalid” error.

Conclusion

In Magento 2, the PUT method requires that your JSON data is encapsulated within an appropriate object structure. Wrapping your stockItems data within the stockItem object solved this issue.

If you’re still facing difficulties, feel free to reach out or explore our Magento 2 REST API guide for more in-depth insights. Happy coding!

Magento 2 Catalog API Admin

Our network