Atualizar Usuário
Atualiza parcialmente os dados de um usuário da empresa. Apenas os campos enviados são alterados; campos omitidos permanecem inalterados.
Regras:
nameeroleIdsó podem ser alterados em usuários ativos.- Não é possível alterar o e-mail do usuário.
- Não é possível alterar um usuário com perfil principal (MAIN).
- Não é possível rebaixar o único administrador (RESPONSIBLE) da conta.
- Retorna 404 se o usuário não pertencer à empresa autenticada.
curl -X PATCH "https://api-sandbox.contasimples.com/users/v1/users/550e8400-e29b-41d4-a716-446655440000" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"name": "João Silva",
"roleId": "8a3f1b2c-4e5d-6f7a-8b9c-0d1e2f3a4b5c"
}'
import requests
import json
url = "https://api-sandbox.contasimples.com/users/v1/users/550e8400-e29b-41d4-a716-446655440000"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"name": "João Silva",
"roleId": "8a3f1b2c-4e5d-6f7a-8b9c-0d1e2f3a4b5c"
}
response = requests.patch(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api-sandbox.contasimples.com/users/v1/users/550e8400-e29b-41d4-a716-446655440000", {
method: "PATCH",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"name": "João Silva",
"roleId": "8a3f1b2c-4e5d-6f7a-8b9c-0d1e2f3a4b5c"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"name": "João Silva",
"roleId": "8a3f1b2c-4e5d-6f7a-8b9c-0d1e2f3a4b5c"
}`)
req, err := http.NewRequest("PATCH", "https://api-sandbox.contasimples.com/users/v1/users/550e8400-e29b-41d4-a716-446655440000", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api-sandbox.contasimples.com/users/v1/users/550e8400-e29b-41d4-a716-446655440000')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"name": "João Silva",
"roleId": "8a3f1b2c-4e5d-6f7a-8b9c-0d1e2f3a4b5c"
}'
response = http.request(request)
puts response.body
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "joao.silva@empresa.com.br",
"name": "João Silva",
"phone": "11999999999",
"role": {
"id": "8a3f1b2c-4e5d-6f7a-8b9c-0d1e2f3a4b5c",
"name": "Contador(a)"
},
"active": true
}
{
"error": "Bad Request",
"message": "Um ou mais parâmetros da requisição são inválidos.",
"code": 400,
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"details": [
"O campo exemplo deve ter um valor entre 5 e 100.",
"datas devem estar no formato YYYY-MM-DD."
]
}
{
"error": "Unauthorized",
"message": "Token de acesso inválido ou expirado.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 401
}
{
"error": "Not Found",
"message": "O recurso solicitado não foi encontrado.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 404
}
{
"error": "Internal Server Error",
"message": "Ocorreu um erro inesperado ao processar a solicitação.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 500
}
/users/v1/users/{userId}Target server for requests. Edit to use your own host.
Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}
Bearer {token}ID do usuário (UUID v4) — use o valor do campo id retornado em GET /users/v1/users (ex.: 550e8400-e29b-41d4-a716-446655440000).
The media type of the request body
Nome completo do usuário.
ID do perfil a ser atribuído ao usuário — use GET /users/v1/roles para obter os IDs disponíveis.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}
Path Parameters
ID do usuário (UUID v4) — use o valor do campo id retornado em GET /users/v1/users (ex.: 550e8400-e29b-41d4-a716-446655440000).
Body
Nome completo do usuário.
ID do perfil a ser atribuído ao usuário — use GET /users/v1/roles para obter os IDs disponíveis.
Responses
Identificador único do usuário.
E-mail do usuário.
Nome do usuário.
Telefone do usuário.
Perfil de acesso atribuído ao usuário na empresa.
Identificador único do perfil de acesso.
Nome do perfil de acesso (ex: Contador(a), Administrador).
Indica se o usuário está ativo na empresa.
Breve identificação do tipo de erro (ex.: Bad Request, Not Found).
Descrição breve do erro para o cliente da API.
Código HTTP do erro (corresponde ao status da resposta).
Opcional. Em erros 400, pode ser uma string com um único detalhe ou um array de strings com cada falha de validação.
Breve identificação do tipo de erro (ex.: Bad Request, Not Found).
Descrição breve do erro para o cliente da API.
Código HTTP do erro (corresponde ao status da resposta).
Opcional. Em erros 400, pode ser uma string com um único detalhe ou um array de strings com cada falha de validação.
Breve identificação do tipo de erro (ex.: Bad Request, Not Found).
Descrição breve do erro para o cliente da API.
Código HTTP do erro (corresponde ao status da resposta).
Opcional. Em erros 400, pode ser uma string com um único detalhe ou um array de strings com cada falha de validação.
Breve identificação do tipo de erro (ex.: Bad Request, Not Found).
Descrição breve do erro para o cliente da API.
Código HTTP do erro (corresponde ao status da resposta).
Opcional. Em erros 400, pode ser uma string com um único detalhe ou um array de strings com cada falha de validação.