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 TOKENIdentificador 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.
Metadados do tipo da categoria (por exemplo, CUSTOM ou DEFAULT).