Usuarios
Registrar Usuario
Crear un nuevo usuario con asignaciones de roles.
POST /api/auth/register
Crea un nuevo usuario y asigna roles. Solo los usuarios con el permiso CREATE_USER pueden registrar nuevos usuarios.
Auth: Requerida — permiso CREATE_USER
Encabezados
| Encabezado | Requerido | Valor |
|---|---|---|
Authorization | Sí | Bearer <access_token> |
x-tenant-id | Sí | UUID del tenant |
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
email | string | Sí | Correo electrónico del usuario (debe ser único) |
password | string | Sí | Contraseña del usuario |
firstName | string | Sí | Nombre |
lastName | string | Sí | Apellido |
roles | string[] | Sí | Array de nombres de roles a asignar |
Ejemplo
curl -X POST https://api.reten.ai/api/auth/register \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>" \
-H "Content-Type: application/json" \
-d '{
"email": "newuser@example.com",
"password": "SecurePass123!",
"firstName": "Jane",
"lastName": "Doe",
"roles": ["FDE"]
}'const response = await fetch("https://api.reten.ai/api/auth/register", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
"Content-Type": "application/json",
},
body: JSON.stringify({
email: "newuser@example.com",
password: "SecurePass123!",
firstName: "Jane",
lastName: "Doe",
roles: ["FDE"],
}),
});
const user = await response.json();import requests
response = requests.post(
"https://api.reten.ai/api/auth/register",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
json={
"email": "newuser@example.com",
"password": "SecurePass123!",
"firstName": "Jane",
"lastName": "Doe",
"roles": ["FDE"],
},
)
user = response.json()Respuesta 201 Created
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"email": "newuser@example.com",
"firstName": "Jane",
"lastName": "Doe"
}Respuestas de Error
| Estado | Descripción |
|---|---|
400 | Error de validación |
403 | Permisos insuficientes o intento de asignar un rol superior |
409 | El correo electrónico ya existe |