Altera uma conta (só os campos enviados)
Altera só os campos enviados; os demais ficam como estão. Nulo limpa banco, agencia e
numero_conta. As regras são as do PUT. Para tirar a conta de uso sem perder o histórico,
mude o status para closed (encerrada) ou inactive.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
id*integerapplication/json- body
Os campos do ContaAlteracao, todos opcionais.
nome?stringlength <= 200moeda?stringbanco?|length <= 20agencia?|length <= 20numero_conta?|length <= 20saldo_inicial?numberdata_saldo_inicial?stringdatestatus?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 PATCH "https://example.com/contas/0" \ -H "Content-Type: application/json" \ -d '{}'{ "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"}Uma conta GET
Conta de outro workspace, inexistente ou oculta para a credencial responde 404.
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.