VolundOS
Referência da APIPessoas

Trocar o perfil de uma pessoa

Atribui um perfil de acesso (ver `GET /v1/profiles`). Exige `members.assign_profile` de quem é dono da chave; o banco recusa escalada (perfil maior que o seu, alvo que pode mais, dono só por dono). Exige o escopo members:write.

Atualizado em 17 de outubro de 2026
PATCH
/v1/members/{userId}

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

Path Parameters

userId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/members/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8"  }'
{}

Listar pessoas da organização

Pessoas da organização da chave, com perfil, cargo e suspensão. Motivo e autor da suspensão só saem para quem tem `members.suspend` ou `org.audit.view`. Filtro opcional `status`. Exige o escopo members:read.

Remover pessoa da organização

Tira a pessoa desta organização. Exige `members.remove`. Último dono e a identidade de sistema não saem. A remoção fica na trilha de auditoria. Exige o escopo members:write.