Usuarios
Actualizar Roles de Usuario
Actualizar las asignaciones de roles de un usuario.
PUT /api/user/:id/roles
Actualiza los roles asignados a un usuario específico. El usuario que realiza la llamada debe tener un rol superior al del usuario objetivo.
Auth: Requerida — permiso UPDATE_USER
Encabezados
| Encabezado | Requerido | Valor |
|---|---|---|
Authorization | Sí | Bearer <access_token> |
x-tenant-id | Sí | UUID del tenant |
Parámetros de Ruta
| Parámetro | Tipo | Descripción |
|---|---|---|
id | UUID | ID del usuario a actualizar |
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
roles | string[] | Sí | Nuevo array de nombres de roles |
Ejemplo
curl -X PUT https://api.reten.ai/api/user/550e8400-e29b-41d4-a716-446655440000/roles \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{
"roles": ["ADMIN", "FDE"]
}'const userId = "550e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/user/${userId}/roles`, {
method: "PUT",
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"Content-Type": "application/json",
},
body: JSON.stringify({ roles: ["ADMIN", "FDE"] }),
});
const data = await response.json();import requests
user_id = "550e8400-e29b-41d4-a716-446655440000"
response = requests.put(
f"https://api.reten.ai/api/user/{user_id}/roles",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
json={"roles": ["ADMIN", "FDE"]},
)
data = response.json()Respuesta 200 OK
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"roles": ["ADMIN", "FDE"]
}Respuestas de Error
| Estado | Descripción |
|---|---|
403 | No se pueden modificar los roles de un usuario con el mismo nivel o superior |
404 | Usuario no encontrado |