Add Realm Role
A New realm specific role can be created using this API.
Resource Informations
Name | Value |
---|---|
Requires authentication? | Yes |
Rate limited? | No |
Request
Request headers
Name | Value |
---|---|
Authorization | Bearer token |
Content-Type | application/json |
HTTP request URL for SSMS
POST https://{tenantId}.{hostname}/digitanium/v4/role/{rolename}
HTTP request URL for SHIFT
POST https://{hostname}/auth/realms/{tenantId}/v3_role/{rolename}
note
API requests must be made over https. Calls made over plain http will fail.
Parameters
No parameter fields are required.
Request body
No request body fields are required.
Response
Field Name | Type | Description |
---|---|---|
message | String | Message explains result of the API call. Refer Response status Information for details. |
status | String | The status of the API call. Refer Response status Information for details. |
subSystem | Integer | subSystem categorizes the type of API that has been called. Refer Subsystem details for details. |
Sample Response
{
"message": "Role created successfully",
"status": "OK",
"subSystem": 1
}
Response Status Information
Status Code | Status | Message |
---|---|---|
200 | OK | Role created successfully |
401 | Unauthorized | HTTP 401 Unauthorized |
409 | CONFLICT | Role already exists |