Ves a la documentació
API

Actualitzar un contacte

Una actualització parcial, mai un upsert. Un camp que ometis manté el valor desat i un `null` explícit el buida, de manera que `{"notes": null}` buida les notes mentre que `{}` no canvia res. Una adreça que no és a la llibreta és un `404`.

PATCHapi.openemail.uk/contacts/{email}

Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.

PATCH /contacts/{email}

Una actualització parcial, mai un upsert. Un camp que ometis manté el valor desat i un null explícit el buida, de manera que {"notes": null} buida les notes mentre que {} no canvia res. Una adreça que no és a la llibreta és un 404.

Exemple

Requereix contacts:write. Codifica la @ per a 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" }  ]}

L'adreça no es pot canviar aquí. És la identitat, el segment del camí i la clau única de la llibreta, de manera que moure un contacte a una adreça nova és una eliminació i una creació.

Un contacte registrat automàticament continua sent auto després de posar-li un nom. Posar-li nom no és la mateixa afirmació que el fet que algú l'hagi desat.

La pertinença a audiències no es toca. Fes servir les rutes d'audiència per a això.