GeneratedMar 11, 2026by|Claim this site
Roles
Create Role
Create a new role in the system (Admin only)
POST
/
api
/
roles
curl -X POST https://api.maqagr.com/api/roles \
-H "Authorization: Bearer ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"role_name": "moderator",
"description": "Moderador del sistema"
}'
{
"success": true,
"message": "Rol creado exitosamente",
"data": {
"role": {
"role_id": 3,
"role_name": "moderator",
"description": "Moderador del sistema",
"status": "active",
"created_at": "2024-03-11T20:00:00.000Z",
"updated_at": "2024-03-11T20:00:00.000Z"
}
}
}
Documentation Index
Fetch the complete documentation index at: https://mintlify.com/David9604/BackMaqagr/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Creates a new role in the system. This endpoint is restricted to administrators only.Admin Access Required: This endpoint requires administrator privileges. Regular users will receive a 403 Forbidden error.
Authentication
Requires JWT authentication token with admin role in the Authorization header.Authorization: Bearer <admin_token>
Request Body
Name of the role. Must be unique and at least 2 characters long.
Description of the role and its permissions.
Response
Indicates if the request was successful.
Success message.
curl -X POST https://api.maqagr.com/api/roles \
-H "Authorization: Bearer ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"role_name": "moderator",
"description": "Moderador del sistema"
}'
{
"success": true,
"message": "Rol creado exitosamente",
"data": {
"role": {
"role_id": 3,
"role_name": "moderator",
"description": "Moderador del sistema",
"status": "active",
"created_at": "2024-03-11T20:00:00.000Z",
"updated_at": "2024-03-11T20:00:00.000Z"
}
}
}
Validation Rules
- role_name must be provided and unique
- role_name must be at least 2 characters long
- User must have administrator role
- Role name is case-sensitive
Source Code Reference
- Route:
src/routes/role.routes.js:179 - Controller:
src/controllers/roleController.js:68 - Middleware:
src/middleware/auth.middleware.js(isAdmin)
⌘I
curl -X POST https://api.maqagr.com/api/roles \
-H "Authorization: Bearer ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"role_name": "moderator",
"description": "Moderador del sistema"
}'
{
"success": true,
"message": "Rol creado exitosamente",
"data": {
"role": {
"role_id": 3,
"role_name": "moderator",
"description": "Moderador del sistema",
"status": "active",
"created_at": "2024-03-11T20:00:00.000Z",
"updated_at": "2024-03-11T20:00:00.000Z"
}
}
}