dinzo.api
Referência da APICategorias

Atualizar categoria

Atualiza título, categoria pai, ícone ou cor, e/ou arquiva/desarquiva a categoria (campo archived). Retorna a categoria atualizada; responde 404 se o id não for visível ao usuário.

PATCH
/v1/categories/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Chave de API no cabeçalho Authorization: Bearer dz_live_...

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://example.com/v1/categories/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "9b3f0a21-5d6e-4c77-a1b2-8e9f0c1d2e34",  "title": "Academia e Saúde",  "parent_id": null,  "icon_id": "b2c3d4e5-1111-2222-3333-444455556666",  "color_hex": "#16A34A",  "system": false,  "archived": true,  "created_at": "2026-08-24T12:05:33.000Z"}

POSTCriar categoria

Cria uma categoria do usuário e retorna a categoria criada. Aceita parent_id para aninhar sob outra categoria e ícone por icon_id ou icon_name.

DELETEExcluir categoria

Exclui a categoria. Categorias públicas do sistema são apenas arquivadas para o usuário; categorias próprias são removidas em cascata. Não retorna corpo (204); responde 404 se a categoria não for encontrada.