Atualizar contato

PUT

/api/contacts/{uuid}

Atualiza um contato existente.

Não é um update parcial. Apesar de o PUT sugerir substituição, a validação exige
first_name, last_name, phone e email em toda chamada — omitir qualquer um
retorna 400. Envie sempre o registro completo.

O phone continua precisando ser único na organização (o próprio contato é ignorado
na checagem).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "first_name": "João",
    "last_name": "Silva",
    "phone": "+5511999999999",
    "email": "joao@exemplo.com",
    "group": "fbd899a6-8a66-4f51-a95d-68668de198ae",
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "string",
    "deal_value": 0,
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://titov.com.br/api/contacts/945d8b4f-a580-4743-bdfa-f0095059b37a' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "João",
    "last_name": "Silva",
    "phone": "+5511999999999",
    "email": "joao@exemplo.com",
    "group": "fbd899a6-8a66-4f51-a95d-68668de198ae",
    "street": "string",
    "city": "string",
    "state": "string",
    "zip": "string",
    "country": "string",
    "deal_value": 0,
    "metadata": {
        "property1": "string",
        "property2": "string"
    }
}'

Respostas

🟢200OK

application/json

Operação concluída. O campo id é o uuid do contato, não o ID numérico interno.

Bodyapplication/json

Exemplo

{
    "statusCode": 200,
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "message": "Request processed successfully"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🔴500Erro do Servidor

Modificado em 2026-07-17 11:51:13