تخطَّ إلى المستندات
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 الجديد حين تخرج.

المرجع