Jump to

• Request
• Response

Create, Update, or Delete Service Types

post

/api/CXIPlatformService/{version}/CXIReferenceEntity/serviceType

Create, update or delete one ore more Service Type records.

Request

Path Parameters

• version(required): string
  API version. Example: v1

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Match One Schema

Show Source

• object serviceTypeRequest

{
    "oneOf":[
        {
            "$ref":"#/components/schemas/serviceTypeRequest"
        }
    ]
}

Nested Schema : serviceTypeRequest

Type: object

Show Source

• items(required): array items

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "type":"object",
                "required":[
                    "operation",
                    "data"
                ],
                "properties":{
                    "data":{
                        "$ref":"#/components/schemas/serviceType"
                    },
                    "operation":{
                        "type":"string",
                        "description":"The field specifies the mode of operation. Supported operations: create,update or delete"
                    }
                }
            },
            "x-cardinality":"1"
        }
    },
    "required":[
        "items"
    ]
}

Nested Schema : items

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "required":[
            "operation",
            "data"
        ],
        "properties":{
            "data":{
                "$ref":"#/components/schemas/serviceType"
            },
            "operation":{
                "type":"string",
                "description":"The field specifies the mode of operation. Supported operations: create,update or delete"
            }
        }
    },
    "x-cardinality":"1"
}

Nested Schema : items

Type: object

Show Source

• data(required): object serviceType
• operation(required): string
  The field specifies the mode of operation. Supported operations: create,update or delete

{
    "type":"object",
    "required":[
        "operation",
        "data"
    ],
    "properties":{
        "data":{
            "$ref":"#/components/schemas/serviceType"
        },
        "operation":{
            "type":"string",
            "description":"The field specifies the mode of operation. Supported operations: create,update or delete"
        }
    }
}

Nested Schema : serviceType

Type: object

Show Source

• active: boolean
  Boolean that is true if active, false if inactive.
• code(required): string
  Code for the Service Type.
• color: string
  Color used in graphs.
• description(required): string
  Description
• icon: string
  Icon displayed in User Interfaces.
• id(required): string
  Id for the record.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Code for the Service Type."
        },
        "color":{
            "type":"string",
            "description":"Color used in graphs."
        },
        "icon":{
            "type":"string",
            "description":"Icon displayed in User Interfaces."
        },
        "active":{
            "type":"boolean",
            "description":"Boolean that is true if active, false if inactive."
        },
        "description":{
            "type":"string",
            "description":"Description"
        },
        "id":{
            "type":"string",
            "description":"Id for the record."
        }
    },
    "required":[
        "id",
        "code",
        "description"
    ]
}

Examples

Select an example serviceType

Back to Top

Response

Supported Media Types

• application/json

200 Response

The resource was updated successfully.

Body ()

Root Schema : schema

Match One Schema

Show Source

• object serviceType

{
    "oneOf":[
        {
            "$ref":"#/components/schemas/serviceType"
        }
    ]
}

Nested Schema : serviceType

Type: object

Show Source

• active: boolean
  Boolean that is true if active, false if inactive.
• code(required): string
  Code for the Service Type.
• color: string
  Color used in graphs.
• description(required): string
  Description
• icon: string
  Icon displayed in User Interfaces.
• id(required): string
  Id for the record.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Code for the Service Type."
        },
        "color":{
            "type":"string",
            "description":"Color used in graphs."
        },
        "icon":{
            "type":"string",
            "description":"Icon displayed in User Interfaces."
        },
        "active":{
            "type":"boolean",
            "description":"Boolean that is true if active, false if inactive."
        },
        "description":{
            "type":"string",
            "description":"Description"
        },
        "id":{
            "type":"string",
            "description":"Id for the record."
        }
    },
    "required":[
        "id",
        "code",
        "description"
    ]
}

Examples

Select an example serviceType

204 Response

The resource was updated successfully, but a failure in returning the updated resource back

400 Response

An error is encountered due to an invalid request

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Application relevant detail, defined in the API or a common list.
• message: string
  More details and corrective actions related to the error which can be shown to a client user.
• referenceError: string (uri)
  URI of documentation describing the error.
• status: string
  HTTP Error code extension

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common\nlist."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which\ncan be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP Error code extension"
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        }
    }
}

500 Response

An internal server error is encountered, due to an unknown reason

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Application relevant detail, defined in the API or a common list.
• message: string
  More details and corrective actions related to the error which can be shown to a client user.
• referenceError: string (uri)
  URI of documentation describing the error.
• status: string
  HTTP Error code extension

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "description":"Application relevant detail, defined in the API or a common\nlist."
        },
        "message":{
            "type":"string",
            "description":"More details and corrective actions related to the error which\ncan be shown to a client user."
        },
        "status":{
            "type":"string",
            "description":"HTTP Error code extension"
        },
        "referenceError":{
            "type":"string",
            "description":"URI of documentation describing the error.",
            "format":"uri"
        }
    }
}

Back to Top