Centros de CustoAtualizar Centro de Custo

Atualizar Centro de Custo

Atualiza o nome de um centro de custo existente. Use este endpoint para corrigir erros de digitação ou para refletir uma reorganização interna — por exemplo, renomear "Marketing" para "Marketing Digital".

Regras:

  • O campo name é obrigatório e não pode ser vazio.
  • Não é possível atualizar para um nome já utilizado por outro centro de custo da empresa.
  • Retorna 404 se o centro de custo não for encontrado.
curl -X PATCH "https://api-sandbox.contasimples.com/cost-centers/v1/cost-centers/fdafbfa7-5eeb-4d96-84aa-82b7c2e1b0ff" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "name": "Marketing Atualizado"
}'
{
  "id": "fdafbfa7-5eeb-4d96-84aa-82b7c2e1b0ff",
  "companyId": "7c61b3f6-7353-46aa-80ef-3e27d95150ab",
  "name": "Marketing Atualizado"
}
PATCH
/cost-centers/v1/cost-centers/{id}
PATCH
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}
path
idstring
Required

Identificador único (UUID) do centro de custo.

Format: uuid
Content-Typestring
Required

The media type of the request body

Options: application/json
namestring
Required

Novo nome do centro de custo. Deve ser único por empresa.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer {token}

Path Parameters

idstring
Required

Identificador único (UUID) do centro de custo.

Example:
fdafbfa7-5eeb-4d96-84aa-82b7c2e1b0ff

Body

application/json
namestring
Required

Novo nome do centro de custo. Deve ser único por empresa.

Example:
Marketing Atualizado

Responses

idstring
Required

Identificador único do centro de custo.

companyIdstring
Required

Identificador da empresa proprietária do centro de custo.

namestring
Required

Nome do centro de custo.