Create a service product

post

/services/rest/connect/v1.4/serviceProducts

Request

Body ()
The hierarchical service product that provides an option to group answers and incidents for better organization and refined searching in the knowledge base.
Root Schema : serviceProducts
Type: object
The hierarchical service product that provides an option to group answers and incidents for better organization and refined searching in the knowledge base.
Show Source
Nested Schema : namedIDs-serviceProducts-adminVisibleInterfaces
Type: object
The named ID that can be included in a list.
Show Source
Nested Schema : serviceProducts-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-serviceProducts-endUserVisibleInterfaces
Type: object
The named ID that can be included in a list.
Show Source
Nested Schema : serviceProducts-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 : productHierarchy
Type: array
The hierarchical service product 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 'serviceProducts' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : namedIDs-serviceProducts-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-serviceProducts-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
Nested Schema : items
Type: object
Back to Top

Response

Default Response

Body ()
Root Schema : serviceProducts
Type: object
The hierarchical service product that provides an option to group answers and incidents for better organization and refined searching in the knowledge base.
Show Source
Nested Schema : namedIDs-serviceProducts-adminVisibleInterfaces
Type: object
The named ID that can be included in a list.
Show Source
Nested Schema : serviceProducts-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-serviceProducts-endUserVisibleInterfaces
Type: object
The named ID that can be included in a list.
Show Source
Nested Schema : serviceProducts-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 : productHierarchy
Type: array
The hierarchical service product 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 'serviceProducts' collection. Only ID or lookupName can be provided to specify the resources.
Show Source
Nested Schema : namedIDs-serviceProducts-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-serviceProducts-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
Nested Schema : items
Type: object
Back to Top

Examples

Use POST with the following syntax to create a new service product object:

https://your_site_interface/services/rest/connect/version/serviceProducts

Request URI example

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

Request body example

{
"names": [
    {
    "labelText": "Cats",
    "language":
        {
        "id": 1
        }
    }
    ]
}

Note:

The names array is required for service products. It contains a list of names, one for each supported language.

Response body example

{
    "id": 64,
    "lookupName": "Cats",
    "adminVisibleInterfaces": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/
                 adminVisibleInterfaces"
            }
        ]
    },
    "categoryLinks": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/
                 categoryLinks"
            }
        ]
    },
    "descriptions": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/
                 descriptions"
            }
        ]
    },
    "displayOrder": 7,
    "dispositionLinks": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/
                 dispositionLinks"
            }
        ]
    },
    "endUserVisibleInterfaces": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/
                 endUserVisibleInterfaces"
            }
        ]
    },
    "name": "Cats",
    "names": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/names"
            }
        ]
    },
    "parent": null,
    "productHierarchy": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64/
                 productHierarchy"
            }
        ]
    },
    "links": [
        {
            "rel": "self",
            "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64"
        },
        {
            "rel": "canonical",
            "href": "https://mysite.example.com/services/rest/connect/v1.4/serviceProducts/64"
        },
        {
            "rel": "describedby",
            "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/
             serviceProducts",
            "mediaType": "application/schema+json"
        }
    ]
}
Back to Top