API

Atualizar um contacto

Uma atualização parcial, nunca um upsert. Um campo que omita mantém o valor guardado e um `null` explícito limpa-o, pelo que `{"notes": null}` esvazia as notas enquanto `{}` não altera nada. Um endereço que não conste do livro dá um `404`.

PATCHapi.openemail.uk/contacts/{email}

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

PATCH /contacts/{email}

Uma atualização parcial, nunca um upsert. Um campo que omita mantém o valor guardado e um null explícito limpa-o, pelo que {"notes": null} esvazia as notas enquanto {} não altera nada. Um endereço que não conste do livro dá um 404.

Exemplo

Requer contacts:write. Codifique o @ em URL.

curl

curl -X PATCH "$OE/contacts/grace%40example.com" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Grace Hopper",  "notes": null}'

Resposta

{  "object": "contact",  "email": "[email protected]",  "name": "Grace Hopper",  "source": "manual",  "notes": null,  "lastSeenAt": null,  "createdAt": "2026-09-18T09:00:00.000Z",  "updatedAt": "2026-09-18T09:04:00.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

O endereço não pode ser alterado aqui. É a identidade, o segmento do caminho e a chave única do livro, pelo que mudar um contacto para um endereço novo é um apagar e um criar.

Um contacto registado automaticamente continua auto depois de lhe dar um nome. Dar-lhe um nome não é a mesma afirmação que alguém o ter guardado.

A pertença a audiências não é tocada. Use as rotas de audiências para isso.