Atualizar Funções do Usuário

PUT /api/user/:id/roles

Substitui as funções de um usuário do tenant ativo: o usuário fica exatamente com as funções enviadas. O usuário que faz a chamada deve ter uma função superior à do usuário-alvo, e só pode atribuir funções abaixo da sua.

Auth: Obrigatória — permissão user:update

Headers

Header	Obrigatório	Valor
`Authorization`	Sim	`Bearer <access_token>`
`x-tenant-id`	Sim	UUID do tenant

Parâmetros de Rota

Parâmetro	Tipo	Descrição
`id`	UUID	ID do usuário a atualizar

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`roles`	string[]	Sim	Valores das funções que substituem as funções atuais do usuário, pelo menos um: `admin`, `fde`, `supervisor`, `operator`, `viewer` (veja Funções e Permissões)

Exemplo

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": ["supervisor"]
  }'

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: ["supervisor"] }),
});
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": ["supervisor"]},
)
data = response.json()

Resposta `200 OK`

{
  "message": "User roles updated successfully"
}

Respostas de Erro

Status	Descrição
`400`	Erro de validação — `roles` está vazio (`At least one role is required`) ou contém um valor que não é uma função
`403`	Falta a permissão — `Required permissions: user:update`
`403`	O alvo é o próprio usuário atual — `Cannot modify your own roles`
`403`	O usuário-alvo não pertence ao tenant ativo — `Cannot modify roles for user outside your active tenant`
`403`	A função do usuário-alvo é igual ou superior à do usuário atual — `Cannot modify roles for user with equal or higher role`
`403`	Uma função solicitada é igual ou superior à do usuário atual — `Cannot assign role <role> - you can only assign roles lower than your own`
`404`	`User not found`