Update a service category

patch

/services/rest/connect/v1.4/serviceCategories/{id}

Request

Path Parameters
Body ()
The hierarchical service category that provides an option to group answers and incidents for better organization and refined searching in the knowledge base.
Root Schema : serviceCategories
Type: object
The hierarchical service category that provides an option to group answers and incidents for better organization and refined searching in the knowledge base.
Show Source
Nested Schema : namedIDs-serviceCategories-adminVisibleInterfaces
Type: object
The named ID that can be included in a list.
Show Source
  • Minimum Value: 1
    Maximum Value: 9223372036854776000
    The unique identifier of the object. This is the key for the list entry.
  • Maximum Length: 255
    The name used to look up the object.
Nested Schema : categoryHierarchy
Type: array
The hierarchical service category that provides an option to group answers and incidents for better organization and refined searching in the knowledge base. It is the reference to a resource in 'serviceCategories' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : serviceCategories-descriptions
Type: object
The language-specific string used for localization. Labels are assembled in a list that is associated with a particular text field.
Show Source
Nested Schema : namedIDs-serviceCategories-endUserVisibleInterfaces
Type: object
The named ID that can be included in a list.
Show Source
  • Minimum Value: 1
    Maximum Value: 9223372036854776000
    The unique identifier of the object. This is the key for the list entry.
  • Maximum Length: 255
    The name used to look up the object.
Nested Schema : serviceCategories-names
Type: object
The language-specific strings used for localization of fields. The label text cannot be empty or null. The labels are assembled in a list associated with a particular text field.
Show Source
Nested Schema : items
Type: object
Nested Schema : namedIDs-serviceCategories-descriptions-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-serviceCategories-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Back to Top

Response

Default Response

Back to Top

Examples

Use the PATCH operation with the following syntax to partially update a service category object:

https://your_site_interface/services/rest/connect/version/serviceCategories/
service_category_id

Include the data to be updated in the request body. Only the fields present in the request JSON data are updated. All other fields remain the same.

Request URI example

https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41

Request body example

{
"parent":
    {
    "id":32
    }
}

Response example

The status 200 OK is returned. Then retrieving the data for service category 41:

https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41

returns the following:

{
  "id": 41,
  "lookupName": "Renewals",
  "adminVisibleInterfaces": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41/
         adminVisibleInterfaces"
      }
    ]
  },
  "categoryHierarchy": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41/
         categoryHierarchy"
      }
    ]
  },
  "descriptions": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41/
         descriptions"
      }
    ]
  },
  "displayOrder": 1,
  "endUserVisibleInterfaces": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41/
         endUserVisibleInterfaces"
      }
    ]
  },
  "name": "Renewals",
  "names": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41/names"
      }
    ]
  },
  "parent": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/32"
      },
      {
        "rel": "canonical",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/32"
      },
      {
        "rel": "describedby",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/
         serviceCategories",
        "mediaType": "application/schema+json"
      }
    ]
  },
  "productLinks": {
    "links": [
      {
        "rel": "self",
        "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41/
         productLinks"
      }
    ]
  },
  "links": [
    {
      "rel": "self",
      "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41"
    },
    {
      "rel": "canonical",
      "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceCategories/41"
    },
    {
      "rel": "describedby",
      "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/
         serviceCategories",
      "mediaType": "application/schema+json"
    }
  ]
}

Note:

The parent service category for Renewals is now Account and Billing.
Back to Top