Role Operations

Credential Warning

Note: Sys Admin or Client Admin account permissions required to execute role operations.

/AppSpiderEnterprise/rest/v1/Role/Roles

Description

Retrieves a list of roles.

Parameters

No parameters

Response Messages

Response Status CodeReasonDescription
200SuccessResponse contains the list of roles

Response example:

{ "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "Roles": { "type": "array", "items": [ { "type": "object", "properties": { "RoleId": { "type": "string" }, "RoleName": { "type": "string" } }, "required": [ "RoleId", "RoleName" ] } ] }, "IsSuccess": { "type": "boolean" }, "Reason": { "type": "null" }, "ErrorMessage": { "type": "null" }, "Links": { "type": "array", "items": [ { "type": "object", "properties": { "Rel": { "type": "string" }, "Href": { "type": "string" } }, "required": [ "Rel", "Href" ] } ] } }, "required": [ "Roles", "IsSuccess", "Reason", "ErrorMessage", "Links" ] }

/AppSpiderEnterprise/rest/v1/Role/GetRole?roleName=<insertRoleName>

Description

Retrieves a roles by role name.

Parameters

NameTypeRequiredDescription
roleNamestringYRole Name

Response Messages

Response Status CodeReasonDescription
200SuccessResponse contains role info
400Required parameters not provided
400NotFoundNo Role Found

Response example:

{ "type": "object", "properties": { "Roles": { "type": "array", "items": [ { "type": "object", "properties": { "RoleId": { "type": "string" }, "RoleName": { "type": "string" } }, "required": [ "RoleId", "RoleName" ] } ] }, "IsSuccess": { "type": "boolean" }, "Reason": { "type": "null" }, "ErrorMessage": { "type": "null" }, "Links": { "type": "array", "items": [ { "type": "object", "properties": { "Rel": { "type": "string" }, "Href": { "type": "string" } }, "required": [ "Rel", "Href" ] } ] } }, "required": [ "Roles", "IsSuccess", "Reason", "ErrorMessage", "Links" ] }

/AppSpiderEnterprise/rest/v1/Role/GetRole?roleId=<insertRoleId>

Description

Retrieves a roles by role id.

Parameters

NameTypeRequiredDescription
roleIdguidYRole Id

Response Messages

Response Status CodeReasonDescription
200SuccessResponse contains role info
400Required parameters not provided
400NotFoundNo Role Found

Response example:

{ "type": "object", "properties": { "Roles": { "type": "array", "items": [ { "type": "object", "properties": { "RoleId": { "type": "string" }, "RoleName": { "type": "string" } }, "required": [ "RoleId", "RoleName" ] } ] }, "IsSuccess": { "type": "boolean" }, "Reason": { "type": "null" }, "ErrorMessage": { "type": "null" }, "Links": { "type": "array", "items": [ { "type": "object", "properties": { "Rel": { "type": "string" }, "Href": { "type": "string" } }, "required": [ "Rel", "Href" ] } ] } }, "required": [ "Roles", "IsSuccess", "Reason", "ErrorMessage", "Links" ] }