API

연락처 수정

부분 업데이트이며 절대 upsert가 아닙니다. 생략한 필드는 저장된 값을 유지하고 명시적인 `null`은 값을 비우므로, `{"notes": null}`은 메모를 비우고 `{}`는 아무것도 바꾸지 않습니다. 주소록에 없는 주소는 `404`입니다.

PATCHapi.openemail.uk/contacts/{email}

본인 키로 워크스페이스에 실제 호출을 실행합니다.

PATCH /contacts/{email}

부분 업데이트이며 절대 upsert가 아닙니다. 생략한 필드는 저장된 값을 유지하고 명시적인 null은 값을 비우므로, {"notes": null}은 메모를 비우고 {}는 아무것도 바꾸지 않습니다. 주소록에 없는 주소는 404입니다.

예시

contacts:write가 필요합니다. @는 URL 인코딩하세요.

curl

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

응답

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

여기서 주소는 바꿀 수 없습니다. 주소는 식별자이자 경로 세그먼트이자 주소록의 고유 키이므로, 연락처를 새 주소로 옮기는 일은 삭제와 생성입니다.

자동으로 기록된 연락처는 이름을 붙여 준 뒤에도 auto로 남습니다. 이름을 붙이는 것은 누군가 저장했다는 것과 같은 주장이 아닙니다.

오디언스 멤버십은 건드리지 않습니다. 그 용도로는 오디언스 라우트를 사용하세요.