GeneratedMar 11, 2026by|Claim this site
Authentication
User Profile
Get or update the authenticated user profile
GET
/
api
/
auth
/
profile
User Profile
curl --request GET \
--url https://api.example.com/api/auth/profile{
"success": true,
"message": "<string>",
"data": {
"user": {
"user_id": 123,
"name": "<string>",
"email": "<string>",
"role_id": 123,
"status": "<string>",
"registration_date": "<string>",
"last_session": "<string>"
}
}
}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.
Get Profile
This endpoint requires authentication. Include the JWT token in the Authorization header.
GET /api/auth/profile
Returns the complete profile data of the authenticated user (without password).Authentication
Required: Bearer token in Authorization headerAuthorization: Bearer {your_jwt_token}
Response
Indicates if the request was successful
Human-readable response message
Response data containing user profile
Show data properties
Show data properties
Complete user profile information
Show user properties
Show user properties
Unique user identifier
User’s full name
User’s email address
User’s role identifier
User’s role name (e.g., “admin”, “user”)
User account status (e.g., “active”, “inactive”, “suspended”)
ISO 8601 timestamp of registration
ISO 8601 timestamp of last login
Example Request
cURL
curl -X GET https://api.maqagr.com/api/auth/profile \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
JavaScript
const response = await fetch('https://api.maqagr.com/api/auth/profile', {
headers: {
'Authorization': `Bearer ${token}`
}
});
const data = await response.json();
Python
import requests
response = requests.get(
'https://api.maqagr.com/api/auth/profile',
headers={'Authorization': f'Bearer {token}'}
)
data = response.json()
Success Response (200)
{
"success": true,
"message": "Perfil obtenido exitosamente",
"data": {
"user": {
"user_id": 1,
"name": "Juan Pérez",
"email": "juan@example.com",
"role_id": 2,
"role_name": "user",
"status": "active",
"registration_date": "2026-02-13T10:00:00.000Z",
"last_session": "2026-03-11T08:30:00.000Z"
}
}
}
Error Responses
401 - Unauthorized (No Token){
"success": false,
"message": "Token no proporcionado o inválido"
}
{
"success": false,
"message": "Usuario no encontrado"
}
Update Profile
This endpoint requires authentication. Include the JWT token in the Authorization header.
PUT /api/auth/profile
Allows updating the name and/or email of the authenticated user. Does not allow changing role or status. At least one field must be provided. If updating email, it verifies that it’s not in use by another user.Authentication
Required: Bearer token in Authorization headerAuthorization: Bearer {your_jwt_token}
Request Body
User’s new full name (optional if email is provided)
User’s new email address (optional if name is provided, must be valid format)
At least one field (name or email) must be provided
Response
Indicates if the request was successful
Human-readable response message
Response data containing updated user profile
Show data properties
Show data properties
Updated user profile information
Show user properties
Show user properties
Example Request
cURL
curl -X PUT https://api.maqagr.com/api/auth/profile \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
-H "Content-Type: application/json" \
-d '{
"name": "Juan Pérez Actualizado",
"email": "nuevo@example.com"
}'
JavaScript
const response = await fetch('https://api.maqagr.com/api/auth/profile', {
method: 'PUT',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Juan Pérez Actualizado',
email: 'nuevo@example.com'
})
});
const data = await response.json();
Python
import requests
response = requests.put(
'https://api.maqagr.com/api/auth/profile',
headers={'Authorization': f'Bearer {token}'},
json={
'name': 'Juan Pérez Actualizado',
'email': 'nuevo@example.com'
}
)
data = response.json()
Success Response (200)
{
"success": true,
"message": "Perfil actualizado exitosamente",
"data": {
"user": {
"user_id": 1,
"name": "Juan Pérez Actualizado",
"email": "nuevo@example.com",
"role_id": 2,
"status": "active",
"registration_date": "2026-02-13T10:00:00.000Z",
"last_session": "2026-03-11T08:30:00.000Z"
}
}
}
Error Responses
400 - No Fields Provided{
"success": false,
"message": "Debe proporcionar al menos nombre o email para actualizar"
}
{
"success": false,
"message": "Formato de email inválido"
}
{
"success": false,
"message": "Token no proporcionado o inválido"
}
{
"success": false,
"message": "El email ya está en uso por otro usuario"
}
{
"success": false,
"message": "Error interno del servidor"
}
⌘I
User Profile
curl --request GET \
--url https://api.example.com/api/auth/profile{
"success": true,
"message": "<string>",
"data": {
"user": {
"user_id": 123,
"name": "<string>",
"email": "<string>",
"role_id": 123,
"status": "<string>",
"registration_date": "<string>",
"last_session": "<string>"
}
}
}