Format the payload to update Assets Custom Fields via REST API

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

Summary

Learn how to format the payload to update Jira Assets fields via API. Its format is differs from updating other Jira fields viaREST API.

Solution

How do I format the request?

The below payload can be used with the same API endpoint to update the Asset custom field.

REST API:

1 2 3 4 5 curl --request PUT \ --url 'https://your-domain.atlassian.net/rest/api/3/issue/{issueIdOrKey}' \ --user 'email@example.com:<api_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \

Payload:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "update": { "customfield_XXXXX": [ { "set": [ { "workspaceId": "workspaceId ot the Object", "id": "GlobalId ot the Object (workspaceId:objectId)", "objectId": "Id of the Object" } ] } ] } }

Workspace ID

The Jira Service Management REST API uses the workspaceId to identify your individual instance of Assets. You must include the workspaceId to make any calls to the REST API.

Us the following endpoint to find your workspaceId:

1 https://<JSM Premium Site Name>.atlassian.net/rest/servicedeskapi/assets/workspace

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.