Altera uma conta (todos os campos)
Troca todos os campos graváveis da conta; para alterar só alguns, use PATCH. Exige o papel
Editor ou um papel com permissão de editar Contas. O tipo não muda depois de criada:
tipo e id no corpo respondem 400.
Nesta versão a API altera só os tipos que ela cria; cartao_credito (que se altera em
/cartoes) e aplicacao_financeira respondem 422. Em contas_a_pagar a finalidade também é exigida. Em conta de passivo e
de patrimônio líquido o saldo inicial é gravado negativo, como na criação.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
id*integerapplication/json- body
Em contas_a_pagar a finalidade também é obrigatória; nos outros tipos ela responde 400.
nome*stringlength <= 200moeda*stringCódigo ISO 4217. Conta com operações de investimento não troca de moeda; poupança só existe em BRL.
banco*|Código da instituição no catálogo (o banco.codigo das contas); nulo tira o banco.
length <= 20agencia*|length <= 20numero_conta*|length <= 20saldo_inicial*numberEm conta de passivo e de patrimônio líquido, gravado negativo.
data_saldo_inicial*stringAAAA-MM-DD. Nunca no futuro; poupança e imóvel aceitam no máximo ontem.
datestatus*StatusContaactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"finalidade?FinalidadeContaO grupo do passivo no balanço em que a conta a pagar entra.
"custos_operacionais""despesas_variaveis""despesas_fixas""lucros""impostos""impostos_sobre_lucro"A conta alterada, no formato do GET /contas/{id}.
application/json- response
id*integernome*stringtipo*TipoContaO tipo da conta como o app mostra. A carteira de investimentos, que o Meu Dinheiro cria
para os investimentos, não aparece na API; contas_a_receber, contas_a_pagar, outros_ativos_imobilizados e capital_social
existem só em workspace de pessoa jurídica.
"conta_corrente""dinheiro""cartao_credito""carteira_ativos""poupanca""aplicacao_financeira""imovel""contas_a_receber""contas_a_pagar""emprestimo_concedido""emprestimo_contratado""outros_ativos""outros_ativos_imobilizados""outros_passivos""capital_social"status*StatusContaactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"moeda*stringCódigo ISO 4217.
banco*|A instituição da conta. Nulo quando não há, ou quando o ícone escolhido para a conta é genérico (uma casa, um carro…), e não um banco.
agencia*string|nullnumero_conta*string|nullfinalidade*|O grupo do passivo no balanço (FinalidadeConta); só em contas_a_pagar, nulo nos outros tipos.
"custos_operacionais""despesas_variaveis""despesas_fixas""lucros""impostos""impostos_sobre_lucro"nullcurl -X PUT "https://example.com/contas/0" \ -H "Content-Type: application/json" \ -d '{ "nome": "Itaú PJ", "moeda": "BRL", "banco": "341", "agencia": "1234", "numero_conta": "99999-0", "saldo_inicial": 400, "data_saldo_inicial": "2026-10-01", "status": "active" }'{ "id": 2051, "nome": "Inter PJ", "tipo": "conta_corrente", "status": "active", "moeda": "BRL", "banco": { "codigo": "077", "nome": "Banco Inter S.A." }, "agencia": "0001", "numero_conta": "12345-6", "finalidade": "custos_operacionais"}Exclui uma conta DELETE
Exclui a conta e o saldo inicial dela. Exige o papel **Editor** ou um papel com permissão de excluir Contas. A exclusão é definitiva. Conta com lançamentos, com operações de investimento ou que paga um cartão de crédito não é excluída, nem a última conta do workspace: a resposta é 422, e a saída que guarda o histórico é encerrar a conta (`PATCH` com `status: closed`). Os tipos que a API não cria respondem 422.
Lista os cartões de crédito GET
Os cartões do workspace com limite, vencimento, fechamento, a conta que paga a fatura e os plásticos. Inclui os inativos e os encerrados; filtre com `status=active` para só os que estão em uso. Cartão **oculto** para a credencial não aparece.