Cria uma categoria
Cria uma categoria ativa de receita ou despesa; com categoria_pai_id, uma subcategoria
(um nível só, do mesmo tipo da de cima, que deve estar ativa). Transferência é do Meu
Dinheiro e não se cria. As linhas do DRE e do DFC não fazem parte da API: a categoria
nasce sem elas, e quem usa os demonstrativos as liga pelo app. Exige o papel
Editor ou um papel com permissão de editar Categorias. A resposta tem o mesmo
formato do GET /categorias/{id}.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
application/json- body
nome*stringSem o nome da categoria de cima.
length <= 200tipo*stringIgual ao da categoria de cima, quando houver; não muda depois.
"receita""despesa"categoria_pai_id?|Categoria de primeiro nível, ativa e do mesmo tipo.
A categoria criada.
application/json- response
id*integernome*stringnome_completo*stringCom a categoria de cima, separada por /.
tipo*TipoCategoria"receita""despesa""transferencia"categoria_pai_id*|A categoria de cima; nulo na categoria de primeiro nível.
status*stringInativa foi desligada no workspace, mas segue nos lançamentos antigos.
"active""inactive"sistema*booleanCriada pelo Meu Dinheiro e usada por funções do app; não pode ser excluída.
curl -X POST "https://example.com/categorias" \ -H "Content-Type: application/json" \ -d '{ "nome": "string", "tipo": "receita" }'{ "id": 1042, "nome": "Delivery", "nome_completo": "Alimentação/Delivery", "tipo": "receita", "categoria_pai_id": 1001, "status": "active", "sistema": true}