Meu Dinheiro · API
Categorias

Altera uma categoria (todos os campos)

PUT
/categorias/{id}

Troca nome, categoria de cima e status; tipo não muda (400). Categoria de sistema não se altera (422). Para alterar só alguns campos, use PATCH. 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 PUT "https://example.com/categorias/0" \  -H "Content-Type: application/json" \  -d '{    "nome": "string",    "categoria_pai_id": 0,    "status": "active"  }'
{  "id": 1042,  "nome": "Delivery",  "nome_completo": "Alimentação/Delivery",  "tipo": "receita",  "categoria_pai_id": 1001,  "status": "active",  "sistema": true}

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.

Lista os centros de custo GET

Os centros de custo do workspace, que classificam lançamentos por área, setor ou atividade. Inclui os inativos; `status` filtra.