URL
POST https://{api-url}/api/v2/tenants/{tenantId}/problems/categories/{uniqueId}
Provide the unique ID of the category you would like to update. Use the get categories API to retrieve the list of categories of the problem entity type.
Sample URLs
To update a category for partners:
https://{api-url}/api/v2/tenants/msp_3/problems/categories/SCAT-09b10785-060a-4178-9c82-eb3b39eb8dbe
To update a category for clients:
https://{api-url}/api/v2/tenants/client_4/problems/categories/SCAT-09b10785-060a-4178-9c82-eb3b39eb8dbe
In this API, the following actions can be performed on a category:
- Rename a category
- Assign child categories to a parent category
- Change the status of a parent category to a child category
A child category cannot be changed to a parent category using this API.
Do the following to change the status:
- Log into OpsRamp.
- On the left-hand side panel. Select Service Desk and then Categories.
- Select entity select Change from the drop-down.
- Click on the category name to view the category page.
- Click Edit, select category type Parent, and then click Update.
- The category is now updated as a parent category.
Parameters
Field | Data Type | Description |
---|---|---|
name | String | (Optional) Category name. |
parentCategory | String | Parent category details. This field is required while assigning a child category to a parent category. |
Status code
200 OK
Sample request
{
"name": "Routers",
"parentCategory": {
"uniqueId": "SCAT-8d55d25d-b6e1-4609-a001-17c441c02a0a",
"name": "Network"
}
}
Sample response
{
"uniqueId": "SCAT-09b10785-060a-4178-9c82-eb3b39eb8dbe",
"name": "Routers",
"parentCategory": {
"uniqueId": "SCAT-8d55d25d-b6e1-4609-a001-17c441c02a0a",
"name": "Network"
},
"createdBy": {
"id": "USR0000000047",
"loginName": "John_Smith",
"lastName": "Smith",
"firstName": "John",
"email": "john.smith@myorganization.com",
"phoneNumber": ""
},
"updatedBy": {
"id": "USR0000000047",
"loginName": "John_Smith",
"lastName": "Smith",
"firstName": "John",
"email": "john.smith@myorganization.com"
},
"createdDate": "2018-02-09T09:14:15+0000",
"updatedDate": "2018-02-12T10:37:34+0000"
}