ドキュメント本文へスキップ
API

署名を一覧する

ワークスペースのすべての署名、または 1 つのアドレスの署名。

GET/signatures

実際の呼び出しをワークスペースに対して実行します。

GET /signatures

ワークスペースのすべての署名、または 1 つのアドレスの署名。

例

settings:read が必要です。アドレスは名前付きの署名の一覧を持ちます。address を指定しない場合、一覧にはすべてのアドレスの署名が入り、アドレス順、次に古い順に並びます。指定した場合は、そのアドレスの署名、または *@acme.com と書いたキャッチオールの署名だけが入ります。

curl
curl "$OE/[email protected]" -H "$AUTH"
レスポンス
{  "object": "list",  "data": [    {      "object": "signature",      "id": "sig_2b7e9c41d0a54f3e8c6d1a90",      "address": "[email protected]",      "name": "Work",      "html": "<p>Ada Lovelace<br />Head of Research, Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": false,      "createdAt": "2026-09-02T08:14:03.117Z",      "updatedAt": "2026-10-01T10:05:12.031Z"    },    {      "object": "signature",      "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": false,      "isReplyDefault": true,      "createdAt": "2026-10-12T09:14:03.117Z",      "updatedAt": "2026-10-12T09:14:03.117Z"    }  ],  "hasMore": false,  "nextCursor": null}

isDefault はそのアドレスからの新規メールに付く署名を示し、isReplyDefault は返信と転送に付く署名を示します。それぞれを持てる署名は 1 つのアドレスにつき最大 1 つで、1 つの署名が両方を持つこともでき、アドレスがどちらも持たないこともあります。

一覧は、ほかのすべての一覧と同じく limit と cursor でページングします。以前のバージョンの単一の署名しか持ったことのないアドレスでは、それが Signature という名前の 1 つの署名として表示され、両方の既定になります。

特定のアドレスやドメインに限定されたキーやアプリが届くのは、自分が持つアドレスの署名だけで、キャッチオールの署名にはドメイン全体を持つ場合にだけ届きます。

リファレンス