CategoriesUpdate category name

Update category name

Renames a category for the authenticated company. Only the name field is updated; linked establishments and category type remain unchanged. The new name must be unique among the company’s existing categories.

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": "Electronics"
}'
{
  "id": 1146,
  "createdAt": "2025-03-18T12:11:36.957Z",
  "updatedAt": "2026-06-11T10:00:00.000Z",
  "companyId": "7c61b3f6-7353-46aa-80ef-3e27d95150ab",
  "name": "Electronics",
  "establishments": [],
  "type": {
    "id": 1,
    "createdAt": "2025-03-18T12:11:36.957Z",
    "updatedAt": "2025-03-18T12:11:36.957Z",
    "type": "CUSTOM"
  }
}
PATCH
/categories/v1/categories/{id}
PATCH
Base URLstring

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

Bearer Token
Bearer Tokenstring
Required

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}
path
idinteger
Required

Numeric category ID.

Content-Typestring
Required

The media type of the request body

Options: application/json
namestring
Required

New name for the category.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Bearer token from OAuth 2.0 client credentials. Format: Bearer {token}

Path Parameters

idinteger
Required

Numeric category ID.

Example:
1146

Body

application/json
namestring
Required

New name for the category.

Example:
Electronics

Responses

idinteger
Required

Category numeric ID.

createdAtstring
Required

When the category was created (ISO 8601).

updatedAtstring
Required

When the category was updated (ISO 8601).

companyIdstring
Required

Owning company ID.

namestring
Required

Category display name or accounting code.

establishmentsarray
Required

Establishments linked to this category.

typestring
Required

Category type metadata (e.g. CUSTOM or DEFAULT).