Meu Dinheiro · API
Projetos

Altera um projeto (todos os campos)

PUT
/projetos/{id}

Troca todos os campos; inicio, fim e as metas aceitam nulo. Para alterar só alguns, use PATCH. Exige o papel Editor ou um papel com permissão de editar Projetos.

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
cor*string

Hexadecimal #RRGGBB.

Padrão (regex)^#[0-9A-Fa-f]{6}$
inicio*|

Entre 1900 e 2100.

Formatodate
fim*|

Não pode ser antes do início (422).

Formatodate
meta_receita*|

0 ou nulo remove a meta.

Faixa0 <= value
meta_despesa*|

Positiva; 0 ou nulo remove a meta.

Faixa0 <= value
status*StatusCadastro

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

Valores"active""inactive"

Corpo da resposta

O projeto alterado.

application/json
  1. response
id*integer
nome*string
cor*|

Hexadecimal #RRGGBB.

status*StatusCadastro

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

Valores"active""inactive"
inicio*|
Formatodate
fim*|
Formatodate
meta_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 PUT "https://example.com/projetos/0" \  -H "Content-Type: application/json" \  -d '{    "nome": "string",    "cor": "string",    "inicio": "2019-08-24",    "fim": "2019-08-24",    "meta_receita": 0,    "meta_despesa": 0,    "status": "active"  }'
{  "id": 512,  "nome": "Obra Centro",  "cor": "#A4C2F4",  "status": "active",  "inicio": "2026-01-15",  "fim": "2026-06-30",  "meta_receita": 120000,  "meta_despesa": 85000.5}

Exclui um projeto DELETE

Exclui o projeto. `destino_id` leva para outro projeto os lançamentos, agendas e regras que o usavam; sem destino, eles ficam sem projeto. As metas por categoria do projeto são apagadas nos dois casos. O destino deve pertencer ao mesmo workspace e ser diferente do excluído. Exige o papel **Editor** ou um papel com permissão de excluir Projetos. A exclusão é definitiva.

Lista os contatos GET

Os clientes e fornecedores do workspace, com documento, e-mail, telefones e endereço. Inclui os inativos. `tipo_contato=cliente` traz também quem é cliente **e** fornecedor (`ambos`); o mesmo vale para `fornecedor`.