Endpoint
/api/v2/tenants/{tenantId}/serviceRequests/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 Problem entity type. (A child category is always specific to a parent category.)

parentCategory.name
parentCategory.uniqueId
{
  "names": [
    "Email",
    "License"
  ],
  "parentCategory": {
    "name": "Software",
    "uniqueId": "SCAT-2b53c303-9374-4df1-848a-664d0d65235d"
  }
}
{
  "names": [
    "Software"
  ]
}

Responses

OK

[
  {
    "createdBy": {
      "email": "james.blake@myorganization.com",
      "firstName": "James",
      "id": "USR0001202764",
      "lastName": "Blake",
      "loginName": "James_Blake"
    },
    "createdDate": "2018-02-09T07:13:09+0000",
    "name": "Email",
    "parentCategory": {
      "name": "Software",
      "uniqueId": "SCAT-2b53c303-9374-4df1-848a-664d0d65235d"
    },
    "uniqueId": "SCAT-279e9528-13b0-4cd7-839b-7d20513b2c32",
    "updatedBy": {
      "email": "james.blake@myorganization.com",
      "firstName": "James",
      "id": "USR0001202764",
      "lastName": "Blake",
      "loginName": "James_Blake"
    },
    "updatedDate": "2018-02-09T07:13:09+0000"
  },
  {
    "createdBy": {
      "email": "james.blake@myorganization.com",
      "firstName": "James",
      "id": "USR0001202764",
      "lastName": "Blake",
      "loginName": "James_Blake"
    },
    "createdDate": "2018-02-09T07:13:10+0000",
    "name": "License",
    "parentCategory": {
      "name": "Software",
      "uniqueId": "SCAT-2b53c303-9374-4df1-848a-664d0d65235d"
    },
    "uniqueId": "SCAT-d244eacf-5932-4026-876f-88807725cf17",
    "updatedBy": {
      "email": "james.blake@myorganization.com",
      "firstName": "James",
      "id": "USR0001202764",
      "lastName": "Blake",
      "loginName": "James_Blake"
    },
    "updatedDate": "2018-02-09T07:13:10+0000"
  }
]
[
  {
    "createdBy": {
      "email": "james.blake@myorganization.com",
      "firstName": "James",
      "id": "USR0001202764",
      "lastName": "Blake",
      "loginName": "James_Blake"
    },
    "createdDate": "2018-02-09T07:03:34+0000",
    "name": "Software",
    "uniqueId": "SCAT-2b53c303-9374-4df1-848a-664d0d65235d",
    "updatedBy": {
      "email": "james.blake@myorganization.com",
      "firstName": "James",
      "id": "USR0001202764",
      "lastName": "Blake",
      "loginName": "James_Blake"
    },
    "updatedDate": "2018-02-09T07:03:34+0000"
  }
]