API

連絡先を一覧する

ワークスペースのアドレス帳を、直近にやり取りした順で返します。一度もメールを送っていない連絡先は最後です。ワークスペース上のどのキーも同じ行を読むため、あるメンバーが保存した連絡先は、すべてのメンバーとすべてのキーから見える連絡先になります。ページングはキーセット方式です。`limit` は最大 200、既定値は 50 で、`hasMore` が true の間は `nextCursor` を `cursor` として渡し直します。

GETapi.openemail.uk/contacts

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

GET /contacts

ワークスペースのアドレス帳を、直近にやり取りした順で返します。一度もメールを送っていない連絡先は最後です。ワークスペース上のどのキーも同じ行を読むため、あるメンバーが保存した連絡先は、すべてのメンバーとすべてのキーから見える連絡先になります。ページングはキーセット方式です。limit は最大 200、既定値は 50 で、hasMore が true の間は nextCursor を cursor として渡し直します。

例

contacts:read が必要です。

curl

curl "$OE/contacts?limit=50" -H "$AUTH"

レスポンス

{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Ada Lovelace",      "source": "auto",      "notes": null,      "lastSeenAt": "2026-08-29T08:19:08.000Z",      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-29T08:19:08.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

source は、誰かがアプリまたは POST /contacts でアドレスを保存した場合は manual、メンバーがコンポーザーからそのアドレス宛に送信したために記録された場合は auto になります。この 2 つは実質的に異なる主張であり（auto はやり取りの証拠、manual は意図の証拠です）、分岐する価値があります。

並び順は lastSeenAt の降順で null は最後、その次に新しい順です。作成したばかりの連絡先は lastSeenAt を持たないため、先頭ではなく末尾に並びます。

アドレス帳は、行を保存した人ではなくワークスペースに属します。あるアドレスからメールが届いても、何も作成されません。