Projetos
Cria um projeto
POST
Cria um projeto ativo. Exige o papel Editor ou um papel com permissão de
editar Projetos. A resposta tem o mesmo formato do GET /projetos/{id}.
accessTokenheader
AuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
application/json- body
nome*stringTamanho
length <= 200cor?stringHexadecimal #RRGGBB; padrão #F2F2F2.
Padrão (regex)
^#[0-9A-Fa-f]{6}$inicio?|Entre 1900 e 2100.
Formato
datefim?|Não pode ser antes do início (422).
Formato
datemeta_receita?|0 ou nulo remove a meta.
Faixa
0 <= valuemeta_despesa?|Positiva; 0 ou nulo remove a meta.
Faixa
0 <= valueO projeto criado.
application/json- response
id*integernome*stringcor*|Hexadecimal #RRGGBB.
status*StatusCadastroinactive: desativado no app, segue nos lançamentos antigos.
Valores
"active""inactive"inicio*|Formato
datefim*|Formato
datemeta_receita*|Receita prevista para o projeto inteiro; nula quando não há meta.
meta_despesa*|Despesa prevista, positiva. O resultado previsto é meta_receita - meta_despesa.
curl -X POST "https://example.com/projetos" \ -H "Content-Type: application/json" \ -d '{ "nome": "string" }'{ "id": 512, "nome": "Obra Centro", "cor": "#A4C2F4", "status": "active", "inicio": "2026-01-15", "fim": "2026-06-30", "meta_receita": 120000, "meta_despesa": 85000.5}