Summary

There is a scenario where the admin needs to create an Asset object via REST API. In Assets Cloud REST API documentation, have a list of APIs available. However, it didn't give the example of a JSON template for a certain scenarios. For this article, I will give you the list of JSON templates to create a new object based on each attribute type. Using the same JSON template you can use it to update Asset object using REST API too.

Environment

JSM Assets

Scenario

Admin needs to create a new object using REST API, and the object type has multiple attribute type.

Solution

Follow the steps by steps to create a new object using REST API :-

1. Generate an API token for your account to execute the REST API using Basic Authentication :-
   1. Go to https://id.atlassian.com/manage/api-tokens
   2. Click Create API Token 
   3. Set a Label and click Create 
   4. Save the Token somewhere safe to use it for later.
2. Get the workspace id  for your site :-

   1. Run the API below :- 

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

   2. From the response, save the workspace id 

3. Then, use the POST object API to create the new object. The API is as below , make sure to update the workspace ID:- 

   POST https://api.atlassian.com/jsm/insight/workspace/{workspaceId}/v1/object/create

4. Now to structure the JSON template, the basic template is as below:- 

   {
     "objectTypeId": "250",
     "attributes": [
       {
         "objectTypeAttributeId": "2797",
         "objectAttributeValues": [
           {
             "value": "Test"
           }
         ]
       },
       {
         "objectTypeAttributeId": "2807",
         "objectAttributeValues": [
           {
             "value": "Testing"
           }
         ]
       }
     ]
   }

   ObjectTypeID : You can get it from the Object Type configuration page. For example as per the screenshot below:-

   ObjectTypeAttributeID : You can get it from the Object Type attribute configuration page. For example as per the screenshot below:-
5. Below is the detailed template for each attribute :-

Tips : For easier way to get the correct JSON template for your REST API , try to create or update the object from the UI. While doing it , open the Developer Tool > Network  and look for the create request and click Payload . It will look like as per the screenshot below :-

Click View Source  for the raw data :-

For Postman users , the request will look as per screenshot below :-