Get Roles

Retrieve a list of all available roles in the system. Roles define user permissions and access levels within your platform.

​

Request Headers

​

Response

​

Role Types

1. Built-in Roles:

• administrator: Full system access
• manager: Can manage users and content
• expert: Can create and assess content
• learner: Basic access to assigned content

2. Custom Roles:

• Identified by numeric alias
• Have custom display names
• Permissions configured in web interface

​

Usage Notes

1. Role Assignment:

• Roles are required when creating users
• Users can only have one role
• Role changes require user re-authentication

2. Best Practices:

• Audit role assignments regularly
• Use least-privilege principle
• Document custom role configurations

curl --request GET \
--url 'https://YOURSITE.konstant.ly/openapi/v1/roles' \
--header 'X-API-KEY: 1qaz2wsx3edc4rfv1qaz2wsx3edc4rfv'

{
    "roles": [
{
    "alias": "administrator",
    "name": "Administrator"
},
{
    "alias": "manager",
    "name": "Manager"
},
{
    "alias": "expert",
    "name": "Expert"
},
{
    "alias": "learner",
    "name": "Learner"
},
{
    "alias": "1",
    "name": "Custom Role Title"
}
    ]
}