Endpoint
/api/v2/tenants/{tenantId}/changeRequests/categories
Path Parameters
tenantIdstring
parentCategoryobject
(Optional) Create a child category under a parent category. This field is mandatory while creating a subcategory. Use the get categories API to get parent categories of the change request entity type. (A child category is always specific to a parent category.)
Child Parameters
- parentCategory.name
- parentCategory.uniqueId
{
"names": [
"Antivirus",
"Windows Device Policy"
],
"parentCategory": {
"name": "Internal Support",
"uniqueId": "SCAT-7c602980-b15d-4b50-8088-23d49307fb02"
}
}
{
"names": [
"Internal Support",
"Hardware"
]
}
Responses
OK
[
{
"createdBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"createdDate": "2018-02-09T09:47:11+0000",
"name": "Antivirus",
"parentCategory": {
"name": "Internal Support",
"uniqueId": "SCAT-7c602980-b15d-4b50-8088-23d49307fb02"
},
"uniqueId": "SCAT-1373d851-27d9-4f68-bf9f-0d79177a7eb4",
"updatedBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"updatedDate": "2018-02-09T09:47:11+0000"
},
{
"createdBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"createdDate": "2018-02-09T09:47:11+0000",
"name": "Windows Device Policy",
"parentCategory": {
"name": "Internal Support",
"uniqueId": "SCAT-7c602980-b15d-4b50-8088-23d49307fb02"
},
"uniqueId": "SCAT-726d5a73-c00b-41c5-be10-98181aaf1f1a",
"updatedBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"updatedDate": "2018-02-09T09:47:11+0000"
}
]
[
{
"createdBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"createdDate": "2018-02-09T09:40:05+0000",
"name": "Internal Support",
"uniqueId": "SCAT-7c602980-b15d-4b50-8088-23d49307fb02",
"updatedBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"updatedDate": "2018-02-09T09:40:05+0000"
},
{
"createdBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"createdDate": "2018-02-09T09:40:06+0000",
"name": "Hardware",
"uniqueId": "SCAT-6f6646af-2470-46b7-a166-07f5b47717a8",
"updatedBy": {
"email": "james.blake@myorganization.com",
"firstName": "James",
"id": "USR0001202764",
"lastName": "Blake",
"loginName": "James_Blake"
},
"updatedDate": "2018-02-09T09:40:06+0000"
}
]