# Retrieve Roles

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

Endpoint: GET /roles
Version: 1.5
Security: ApiKeyAuth, BasicAuth

## Header parameters:

  - `X-API-Key` (string, required)
    Customer-specific API key required to invoke API.

  - `Authorization` (string, required)
    Provided by Authentication Token creation operation

## Response 200 fields (application/json):

  - `id` (string, required)
    The Tenovos unique identifier assigned to the Role
    Example: "e171b93a-9f42-4a78-8845-b60f3e783c3c"

  - `name` (string, required)
    The user provided label/name of the Role.
    Example: "Creative Producer"

## Response 401 fields (application/json):

  - `message` (string)

  - `detail` (string)

## Response 403 fields (application/json):

  - `message` (string)

  - `detail` (string)