Endpoint
/api/v2/tenants/{tenantId}/changeRequests/categories
Path Parameters
tenantId
string

names
array

Unique name for category. A category would be identified with this name.

parentCategory
object

(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.)

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"
  }
]