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:

  1. Log into OpsRamp.
  2. On the left-hand side panel. Select Service Desk and then Categories.
  3. Select entity select Change from the drop-down.
  4. Click on the category name to view the category page.
  5. Click Edit, select category type Parent, and then click Update.
  6. The category is now updated as a parent category.

Parameters

FieldData TypeDescription
nameString(Optional) Category name.
parentCategoryStringParent 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"
}