Saltar para a documentação
API

Atualizar uma assinatura

Mudar-lhe o nome, reescrever o seu HTML, ou alterar para o que é a predefinida.

PATCH/signatures/{id}

Executa a chamada real no seu espaço de trabalho.

PATCH /signatures/{id}

Mudar-lhe o nome, reescrever o seu HTML, ou alterar para o que é a predefinida.

Exemplo

Requer settings:write. Envie apenas o que muda.

curl
curl -X PATCH "$OE/signatures/sig_8f2c1a9b7d3e4f60a1b2c3d4" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "isDefault": true }'
Resposta
{  "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 torna-a a assinatura do correio novo do seu endereço, em vez da que era. isDefault: false retira-lhe isso quando esta assinatura o tinha, por isso o correio novo do endereço sai sem assinatura até ser escolhida outra. isReplyDefault faz o mesmo para respostas e reencaminhamentos.

Envie qualquer um de name, html, isDefault e isReplyDefault. Um corpo sem nenhum deles é um 422, e um nome novo que outra assinatura do endereço já tem é um 409 signature_name_taken.

Uma mensagem que já está agendada leva o novo HTML quando sai.

Referência