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

署名をほかのアドレスにコピーする

同じ署名をほかのアドレスに置き、そこにある同じ名前の署名を置き換えます。

POST/signatures/{id}/copy

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

POST /signatures/{id}/copy

同じ署名をほかのアドレスに置き、そこにある同じ名前の署名を置き換えます。

例

settings:write が必要です。addresses には 1 から 500 個のアドレスまたはキャッチオールを指定します。

curl
curl -X POST "$OE/signatures/sig_8f2c1a9b7d3e4f60a1b2c3d4/copy" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "addresses": ["[email protected]", "[email protected]"], "isDefault": true }'
レスポンス
{  "object": "list",  "data": [    {      "object": "signature",      "id": "sig_51c0a7e2b94d4c18a3f6e0d2",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": false,      "createdAt": "2026-10-12T09:20:41.902Z",      "updatedAt": "2026-10-12T09:20:41.902Z"    },    {      "object": "signature",      "id": "sig_c9d4e1f07a2b4b6f9e3d5a81",      "address": "[email protected]",      "name": "Short",      "html": "<p>Ada<br />Acme Ltd</p>",      "isDefault": true,      "isReplyDefault": true,      "createdAt": "2026-10-12T09:20:41.955Z",      "updatedAt": "2026-10-12T09:20:41.955Z"    }  ]}

大文字と小文字を区別せずに同じ名前の署名がすでにあるアドレスでは、その HTML が置き換えられるため、編集後にもう一度コピーすれば、すべてのコピーが最新になります。それ以外のアドレスには、その名前の新しい署名が作られます。

isDefault または isReplyDefault が true の場合、コピーはその既定になり、署名が 1 つもなかったアドレスでは両方の既定になります。省略すると、ほかのアドレスの既定はそのまま残ります。その署名がもともとあるアドレスはスキップされます。

それ以降、各コピーは独自の ID を持つ別々の署名になります。コピーは 1 アドレスずつ書き込まれるため、あるアドレスが上限に達していると呼び出しは 422 signature_limit_reached で失敗し、それより前のアドレスにはコピーが残ります。

リファレンス