Use this API to add a role and grant privileges to the role.

Resource Information

Method

URL

Required authentication

POST

/V1/CMDB/Roles

Yes

Parameters

Name

Description

Token*required
(header)

Place the token received from the API Log in to get an authentication token.

Request*required
(body)

The body contains the following parameters:

roleName*(string): the name of the role that you want to add.

description (string): the description of the role.

privileges (string): the privileges that the role owns.

Example:

{
  "roleName""Role Name",
  "description""string",
  "privileges""string"
}

Response

Parameter

Type

Description

Example

statusCode

integer

The returned status code of executing the API.

{
  "statusCode"790200,
  "statusDescription""success"
}

statusDescription

string

The explanation of the status code.