Meu Dinheiro · API
Contatos

Exclui um contato

DELETE
/contatos/{id}

Exclui o contato. destino_id leva para outro contato os lançamentos, agendas e regras que o usavam; sem destino, eles ficam sem contato. Contato com proposta comercial não é excluído (422). 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 Contatos. A exclusão é definitiva.

Autenticação

accessToken
headerAuthorizationBearer <token>

Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.

Parâmetros de caminho

id*integer

Parâmetros de consulta

destino_id?integer
Faixa1 <= value

Corpo da resposta

Excluído.

curl -X DELETE "https://example.com/contatos/0"
Vazio

Altera um contato (só os campos enviados) PATCH

Altera somente os campos enviados; os ausentes ficam como estão. Trocar `tipo_pessoa` confere o documento gravado contra o tipo novo. Exige o papel **Editor** ou um papel com permissão de editar Contatos.

Altera um contato (todos os campos) PUT

Troca todos os campos do contrato; nulo limpa. O que está fora do contrato (RG, nascimento, inscrições, observação, campos personalizados, anexos) fica como está. Para alterar só alguns, use `PATCH`. Exige o papel **Editor** ou um papel com permissão de editar Contatos.