Meu Dinheiro · API
Categorias

Altera uma categoria (só os campos enviados)

PATCH
/categorias/{id}

Altera somente os campos enviados; categoria_pai_id nulo leva a categoria ao primeiro nível. Inativar a que tem subcategoria ativa, ou pôr sob outra a que tem subcategorias, é 422. Exige o papel Editor ou um papel com permissão de editar Categorias.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de caminho

id*integer

Corpo da requisição

application/json
  1. body
nome?string
Tamanholength <= 200
categoria_pai_id?|

Nulo leva a categoria ao primeiro nível.

status?StatusCadastro

inactive: desativado no app, segue nos lançamentos antigos.

Valores"active""inactive"

Corpo da resposta

A categoria alterada.

application/json
  1. response
id*integer
nome*string
nome_completo*string

Com a categoria de cima, separada por /.

tipo*TipoCategoria
Valores"receita""despesa""transferencia"
categoria_pai_id*|

A categoria de cima; nulo na categoria de primeiro nível.

status*string

Inativa foi desligada no workspace, mas segue nos lançamentos antigos.

Valores"active""inactive"
sistema*boolean

Criada pelo Meu Dinheiro e usada por funções do app; não pode ser excluída.

curl -X PATCH "https://example.com/categorias/0" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": 1042,  "nome": "Delivery",  "nome_completo": "Alimentação/Delivery",  "tipo": "receita",  "categoria_pai_id": 1001,  "status": "active",  "sistema": true}

Uma categoria GET

Anterior

Exclui uma categoria DELETE

Exclui a categoria e leva para `destino_id`, **obrigatório**, os lançamentos, agendas e regras que a usavam: lançamento não fica sem categoria. O destino deve ser outra categoria do mesmo workspace e do mesmo tipo (inativa ou subcategoria também serve). As metas de orçamento da categoria são apagadas. Categoria de sistema e categoria com subcategorias não se excluem. Exige o papel **Editor** ou um papel com permissão de excluir Categorias. A exclusão é definitiva.