---
title: "Cadastrar/Atualizar Usuários"
method: POST
path: "/users/"
tags: ["Usuário"]
---

# Cadastrar/Atualizar Usuários

`POST /users/`

Cadastra ou atualiza usuários em lote em Gupy Treinamento.

## Query parameters

- `secret` string, required

## Request body

- object[]
  - `nin` string — National Identification Number (CPF para usuários brasileiros) - Não pode ser enviado juntamente com email
  - `email` string — E-mail do usuário - Não pode ser enviado juntamente com nin
  - `name` string, required — Nome completo do usuário
  - `id_number` string — Identity Number (RG para usuários brasileiros), para recuperação de senha em login baseado em CPF, só pode ser enviado juntamente com nin - após ser definido para um usuário ativo não pode ser atualizado
  - `lang` string, required — Língua do usuário - Útil para o disparo do e-mail de cadastro [pt,es,en]
  - `birth_date` string, date — Data de nascimento do usuário no formato 'YYYY-MM-DD' - após ser definido para um usuário ativo não pode ser atualizado
  - `times_allowed` object — Grade de horários permitidos para o uso no aplicativo (pares de horários representando o início e fim do intervalo) - quando 'null' não há restrições
  - `mobile_internet_allowed` boolean — Quando 'false' o aplicativo não utilizará internet móvel do dispositivo
  - `metadata` object — Dados extras no formato chave-valor para esse usuário - as chaves habilitadas para cadastro nesse campo precisam ser previamente registradas pelo Admin
  - `group` integer — Caso seja enviado adiciona o usuário ao grupo de ID especificado

## Response `200`

Requisição aceita. Os usuários serão cadastrados ou atualizados de forma assíncrona. A resposta informa a previsão de conclusão do processamento (ends_in / ends_in_i18n).

- object
  - `ends_in` string — Previsão de conclusão do processamento
  - `ends_in_i18n` string — Previsão de conclusão do processamento em formato local

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/gupy/apis/gupy-public-api.md) · [All operations](https://skmtc.net/gupy/apis/gupy-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gupy/gupy-public-api/revisions/3f26defa2a42/schema)