---
title: "Criar Usuário"
method: POST
path: "/auth/api/v1/users"
---

# Criar Usuário

`POST /auth/api/v1/users`

## Request

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

Crie um usuário na organização autenticada, com perfil em agreement_dashboard, agreement_manager ou nas duas, e envie o convite para ele definir a senha.

## Request body

- object
  - `name` string, required: Nome do usuário. Não pode ficar vazio depois de remover os espaços das pontas.
  - `email` string, email, required: E-mail do usuário, que recebe o convite. Espaços nas pontas são removidos.
  - `roleIds` object, required: Perfil do usuário em cada aplicação: a chave é a aplicação e o valor é o id de um perfil dela. Um perfil por aplicação. Envie pelo menos uma aplicação; a que não for enviada (ou vier null) fica sem acesso.
    - `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 ou null: sem 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 ou null: sem acesso à aplicação.

## Response `201`

201

- 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
- `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)