Jira Align REST API - Resolve PATCH operation issues with HTTP 204

Summary

A PATCH request to update a "read-only" field returns a 204 status, which causes confusion because it doesn't indicate that the field can't be updated.

Solution

If you receive a 204 response during a PATCH update, please check the Swagger documentation (https://<Jira Align Base URL>/rest/align/api/docs/index.html) and scroll to the Schemas section at the bottom.

Look for the endpoint and field you are updating and check to see if the flag "readOnly: true" is present. If it is, this field can't be updated with the API.

Code snippet showing the schema definition of a "manWeeks" field. It's a number (double) type, with specified minimum and maximum values, nullable, and marked as read-only.  The readOnly: true property is highlighted.

Updated on June 23, 2025

Still need help?

The Atlassian Community is here for you.