Skip to content

Atualiza role

PUT/api/profiles/{id}/role

Auth
Requires a token
Who can call it:
owner
admin
finance
SuperAdmin
X-CommunityId
X-CommunityId Send the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

Proteção do owner: só owner ou SuperAdmin muda o papel de um owner (403 `profile.ownerProtected`) ou torna alguém owner (403 `profile.ownerPromotionForbidden`). `finance` (F-32) é um papel lateral, só de leitura do financeiro: lê ledger, saldo, saques, dados bancários/KYC e o painel de vendas, e não altera nada disso. Fora do financeiro, vale como `member`. Só owner, admin ou SuperAdmin atribuem `finance` (403 `profile.financeRoleForbidden`).

Parameters

NameInTypeDescription
idrequiredpathstring (uuid)

Headers

NameTypeDescription
X-CommunityIdoptionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Request body application/json

NameTypeDescription
rolerequiredowner | admin | moderator | member | financeValid role is required

Responses

StatusDescription
200Operação realizada com sucesso.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
404Recurso não encontrado.
500Erro interno do servidor.

curl example

curl -X PUT "https://api.memberfy.net/api/profiles/<id>/role" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"role":"owner"}'