<aside> <img src="/icons/map-pin_blue.svg" alt="/icons/map-pin_blue.svg" width="40px" />

Índice de páginas

Core AI Docs

Versões

1.2

1.1

1.0

</aside>

Resumo

Este endpoint permite atualizar a função (role) associada a um usuário já cadastrado no sistema. A operação é útil para alterar permissões de acesso administrativas, promovendo ou restringindo o escopo de atuação de um usuário.

⚠️ O usuário deve já existir no sistema. Se o e-mail não estiver registrado, a requisição resultará em erro.

URL do Endpoint

https://{BASE_URL}/users/update_role

Método HTTP

Headers Necessários

Exemplo de Requisição (cURL)

Request:

curl --location 'https://{BASE_URL}/users/update_role' 
--header 'version: v1' \\
--header 'Authorization: Bearer eyJhbGciOiJSUzI1wefdfdsfsdfpZCI6ImEwODewrwdfdsfvddfA2N2Q4M2YwY2Y5rwerwerwerZhNWI2YTNlMDkiLCJ0eXAiOiJKV1QifQ.eyJpc3MiOiJodHRwczovL3NlY3VyZXRva2VuLmdvbhrthdfdvrhrhdffb2dsZS5jb20vY29yZS1zYW5kYm94LWhpZ2hncm91bmQiLCJhdWQiOiJjb3JlLXNhbmRib3gtaGlnaGdyb3VuZCIsImF1dGhfdGltZSI6MTc0MjIzNjg5MywidXNlcl9pZCI6Iko3OURrOURMZ2VPQkd2ZXM1N29xb21ldm0yOTIiLCJzdWIiOiJKNzlEazlETGdlT0JHdmVzNTdvcW9tZXZtMjkyIiwiaWF0IjoxNzQyMjM2ODkzLCJleHAiOjE3NDIyNDA0OTMsImVtYWlsIjoia2luZ0Bjb3JlLWFpLnRlY2giLCJlbWFpbF92ZXJpZmllZCI6ZmFsc2UsImZpcmViYXNlIjp7ImlkZW50aXRpZXMiOnsiZW1haWwiOlsia2luZ0Bjb3JlLWFpLnRlY2giXX0sInNpZ25faW5fcHJvdmlkZXIiOiJwYXNzd29yZCJ9fQ.UpxoUisPZd0iPfKF4pYFRoGXCC5miysLFwzopRBHB6LNMhOZXbquxCfJJQuMPddJ3bz7GIAbAnD9RXJAJ66FOUtLOv0-VZBpcJm5bsl3CkJC4v6zoBGFIkOyvpOaD4HF3P8jNjhsQLDgYaBy8q4IWPvSJQi28uEYyM8PYInE6rCNNH06EI-HaADqyyn9X4NHD9hOmHbWqlyV7uRbi1iv-9ELLerethergtPzFUOUUOX6W_zdN1BzMpx-1SwraArJkh_3k78KAVa7MKoQGjD5QfEYjFdAayxyz4cI_YEqVp1uwmiHBZ_jICT2MSMwOAY504VG7eRobv52LyfwUt0TKR7nNw_8AEQ'
--data-raw '{
    "email": "[email protected]",
    "role_name": "saas_viewer"
}'
Campo Tipo Obrigatório Observação
email String 🟢 E-mail do usuário cuja função será atualizada. Deve ser um usuário já existente.
role_name Enum 🟢 Nova função a ser atribuída ao usuário. Deve ser um dos valores válidos registrados no sistema (saas_admin, saas_viewer, etc).

Resposta Esperada

Em caso de sucesso, a resposta terá o seguinte formato:

Response OK:

{
    "message": "Role updated successfully"
}