Atualizar nome da categoria
Renomeia uma categoria da empresa autenticada. Apenas o campo name é atualizado; os estabelecimentos vinculados e o tipo da categoria permanecem inalterados. O novo nome deve ser único entre as categorias existentes da empresa.
curl -X PATCH "https://api-sandbox.contasimples.com/categories/v1/categories/1146" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"name": "Eletrônicos"
}'
import requests
import json
url = "https://api-sandbox.contasimples.com/categories/v1/categories/1146"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"name": "Eletrônicos"
}
response = requests.patch(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api-sandbox.contasimples.com/categories/v1/categories/1146", {
method: "PATCH",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"name": "Eletrônicos"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"name": "Eletrônicos"
}`)
req, err := http.NewRequest("PATCH", "https://api-sandbox.contasimples.com/categories/v1/categories/1146", 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/categories/v1/categories/1146')
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": "Eletrônicos"
}'
response = http.request(request)
puts response.body
{
"id": 1146,
"createdAt": "2025-03-18T12:11:36.957Z",
"updatedAt": "2026-06-11T10:00:00.000Z",
"companyId": "7c61b3f6-7353-46aa-80ef-3e27d95150ab",
"name": "Eletrônicos",
"establishments": [],
"type": {
"id": 1,
"createdAt": "2025-03-18T12:11:36.957Z",
"updatedAt": "2025-03-18T12:11:36.957Z",
"type": "CUSTOM"
}
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Conflict",
"message": "The request conflicts with the current state of the resource",
"code": 409,
"details": "Resource already exists"
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/categories/v1/categories/{id}Target server for requests. Edit to use your own host.
Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}
Bearer {token}Identificador numérico da categoria.
The media type of the request body
Novo nome da categoria.
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
Body
Responses
Identificador numérico da categoria.
Data e hora de criação da categoria (ISO 8601).
Data e hora da última atualização da categoria (ISO 8601).
Identificador da empresa proprietária da categoria.
Nome completo ou código contábil exibido da categoria.
Lista de estabelecimentos associados a esta categoria, com vínculo e tipo.
Identificador do estabelecimento.
Data e hora de criação do registro do estabelecimento (ISO 8601).
Data e hora da última atualização do registro do estabelecimento (ISO 8601).
Nome exibido do estabelecimento.
Metadados do tipo de classificação aplicável ao estabelecimento.
Identificador da vinculação entre o estabelecimento e a categoria.
Metadados do tipo da categoria (por exemplo, CUSTOM ou DEFAULT).
Body inválido (por exemplo, campo name ausente ou vazio).
Não autorizado. Token ausente, inválido ou expirado.
Categoria não encontrada para a empresa.
Já existe uma categoria com o mesmo nome para a empresa.
Erro interno do servidor. Tente novamente com retry e backoff exponencial.