# SECURITY

Invoke the Metadata API to retrieve Security Template information to be applied to Assets during Asset creation or edit.

## Retrieve Roles

 - [GET /roles](https://api.tenovos.com/openapi/v1.5/security/getroles.md): Response provides an array of the security Roles that are configured in Tenovos.  The items returned are limited to the Roles available to the user making the API call.

API User credentials must have administrative rights to the User Management privilege.

Average Response Time: 274ms

## (NEW!) Retrieve Role Privileges

 - [GET /roles/privileges](https://api.tenovos.com/openapi/v1.5/security/getprivileges.md): Response will include a list of all role privileges available in the system. The user making the request must have the 'Security Template Management' role privilege. All role privileges will be returned by default. User can pass 'enabled' or 'disabled' as a path parameter to return only enabled or disabled role privileges. 
The user making the request must have Role Management privilege. 

Average Response Time: 188ms

## Retrieve Security Templates

 - [GET /security/template](https://api.tenovos.com/openapi/v1.5/security/getsecuritytemplates.md): User will get the list of Security Templates available to him.

The user submitting the request must have administrator rights to view Security Templates.

In response user will get a list, containing template names and their corresponding template id.

Average Response Time: 243ms

## Retrieve Security Groups

 - [GET /security/groups](https://api.tenovos.com/openapi/v1.5/security/getsecuritygroups.md): User will get the list of Security Groups available in the system.

The user submitting the request must have administrator rights to User Management.

In response user will get a list, containing group names and their corresponding group id.

Average Response Time: 189ms

## (NEW!) Retrieve Security Permissions

 - [GET /security/permissions](https://api.tenovos.com/openapi/v1.5/security/getsecuritypermissions.md): Response will include a list of all security permissions available in the system. The user making the request must 
have the Security Template Management role privilege.

Average Response Time: 231ms