Update the Organizations field on a Work Item using the Jira Service Management API

Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.

Summary

This article provides guidance on how to update the Organizations field on an issue using the Jira API. By following these steps, you can successfully update the Organizations field on issues using a PUT request to the Edit issue API endpoint.

This method provides a workaround until a dedicated API endpoint is available for this purpose, as detailed on the suggestion ticket:

Solution

To update the Organizations field on an issue, follow these steps:

1. Obtain the Organization ID: 

We can use the Get organizations API endpoint to retrieve the ID of the Organization you wish to update.

Before calling the Edit issue API, identify the Organization ID and the custom field ID for the Organizations field. The example values in this article are illustrative; readers must use the IDs from their own site.

2. Identify the Custom Field ID:

Determine the custom field ID associated with the Organizations field in your Jira instance. You can use the below link for steps on how to get the custom field ID:

3. Use the Edit Issue API Endpoint:

With the Organization ID and the custom field ID, perform a PUT request to the Edit issue API endpoint to update the Organizations field. An example request is shown below:

Request:

https://{your_site}.atlassian.net/rest/api/2/issue/{issueIdOrKey}

Request Body:

{ "update": { "customfield_10002": [4] } }

In this example, the custom field ID is 10002, and the Organization ID is 4. Verify the payload against your own work item key and organization ID.

Updated on October 9, 2026

Still need help?

The Atlassian Community is here for you.