API

Aktualizace kontaktu

Částečná aktualizace, nikdy upsert. Pole, které vynecháte, si ponechá uloženou hodnotu, a explicitní `null` ho vymaže, takže `{"notes": null}` vyprázdní poznámky, zatímco `{}` nezmění nic. Adresa, která v adresáři není, vrátí `404`.

PATCHapi.openemail.uk/contacts/{email}

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

PATCH /contacts/{email}

Částečná aktualizace, nikdy upsert. Pole, které vynecháte, si ponechá uloženou hodnotu, a explicitní null ho vymaže, takže {"notes": null} vyprázdní poznámky, zatímco {} nezmění nic. Adresa, která v adresáři není, vrátí 404.

Příklad

Vyžaduje contacts:write. Znak @ zakódujte do URL.

curl

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

Odpověď

{  "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" }  ]}

Adresu zde změnit nelze. Je to identita, segment cesty i unikátní klíč adresáře, takže přesun kontaktu na novou adresu znamená smazání a vytvoření.

Kontakt zaznamenaný automaticky zůstává auto i poté, co mu dáte jméno. Pojmenování není totéž tvrzení jako to, že ho někdo uložil.

Členství v publicích zůstává nedotčeno. Na to použijte cesty pro publika.