dinzo.api
Referência da APICategorias

Criar 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.

POST
/v1/categories

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

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

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

GETListar categorias

Retorna todas as categorias visíveis ao usuário (próprias e públicas do sistema) como uma árvore plana ligada por parent_id, ordenadas por título. O campo archived reflete se a categoria está arquivada para o usuário.

PATCHAtualizar 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.