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

署名を更新する

名前の変更、HTML の書き直し、または何の既定にするかの変更。

PATCH/signatures/{id}

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

PATCH /signatures/{id}

名前の変更、HTML の書き直し、または何の既定にするかの変更。

例

settings:write が必要です。変更する項目だけを送ります。

curl
curl -X PATCH "$OE/signatures/sig_8f2c1a9b7d3e4f60a1b2c3d4" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "isDefault": true }'
レスポンス
{  "object": "signature",  "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4",  "address": "[email protected]",  "name": "Short",  "html": "<p>Ada<br />Acme Ltd</p>",  "isDefault": true,  "isReplyDefault": true,  "createdAt": "2026-10-12T09:14:03.117Z",  "updatedAt": "2026-10-12T09:14:03.117Z"}

isDefault: true は、それまでの署名に代わって、この署名をそのアドレスからの新規メールの署名にします。isDefault: false は、この署名がその役割を持っていた場合にそれを外すため、別の署名を選ぶまで、そのアドレスからの新規メールは署名なしで送られます。isReplyDefault は返信と転送について同じ働きをします。

name、html、isDefault、isReplyDefault のうち必要なものを送ります。どれもない本文は 422 になり、そのアドレスの別の署名がすでに持つ新しい名前は 409 signature_name_taken になります。

すでに予約されているメッセージは、送信されるときに新しい HTML を使います。

リファレンス