---
title: "Editar Usuário"
method: PUT
path: "/auth/api/v1/users/{id}"
---

# Editar Usuário

`PUT /auth/api/v1/users/{id}`

## Request

- Base URL: `https://apigw.nuvidio.com`
- URL: `https://apigw.nuvidio.com/auth/api/v1/users/{id}`
- Auth: OAuth 2

Atualize o nome e/ou o perfil de um usuário em agreement_dashboard e agreement_manager, na organização autenticada.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string: Novo nome. Não pode ficar vazio depois de remover os espaços das pontas. Não aceita null: o nome não pode ser apagado.
  - `roleIds` object: Perfis a alterar, por aplicação. Chave ausente mantém o perfil atual; id troca o perfil; null remove o acesso à aplicação. Para não alterar uma aplicação, omita a chave; não envie null.
    - `agreement_dashboard` string, uuid, nullable: Id de um perfil de agreement_dashboard (owner, writer ou reader, obtido em GET /auth/api/v1/application/agreement_dashboard/access-roles). Ausente mantém o perfil atual; null remove o acesso à aplicação.
    - `agreement_manager` string, uuid, nullable: Id de um perfil de agreement_manager (owner ou writer, obtido em GET /auth/api/v1/application/agreement_manager/access-roles). Ausente mantém o perfil atual; null remove o acesso à aplicação.

## Response `200`

200

- object
  - `data` object, required
    - `id` string, uuid, required: Identificador do usuário.
    - `name` string, required: Nome do usuário. Vem como string vazia quando não informado.
    - `email` string, nullable, required: E-mail do usuário. É null quando o usuário não tem e-mail, como os usuários de API key.
    - `applications` object, required: Perfil do usuário em cada aplicação. Sempre traz as chaves agreement_dashboard e agreement_manager.
      - `agreement_dashboard` object
        - `roles` object[]: Perfil do usuário em agreement_dashboard (owner, writer ou reader). No máximo um item; vazio quando o usuário não tem acesso à aplicação.
          - `id` string, uuid: Identificador do perfil.
          - `name` string: Nome do perfil.
      - `agreement_manager` object
        - `roles` object[]: Perfil do usuário em agreement_manager (owner ou writer). No máximo um item; vazio quando o usuário não tem acesso à aplicação.
          - `id` string, uuid: Identificador do perfil.
          - `name` string: Nome do perfil.

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404
- `422`: 422
- `500`: 500

---

[API](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2.md) - [All operations](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/nuvidio/apis/gateway-nuvidio-v2/revisions/c488e657f07b?raw)