Перейти к документации
API

Список подписей

Все подписи рабочего пространства или подписи одного адреса.

GET/signatures

Выполняет настоящий запрос в вашем рабочем пространстве.

GET /signatures

Все подписи рабочего пространства или подписи одного адреса.

Пример

Требуется settings:read. Адрес хранит список подписей с названиями. Без address список содержит все адреса, отсортированные по адресу, а затем от старых к новым. С ним в списке только подписи этого адреса или catch-all, записанного как *@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 ту, которую несут его ответы и пересылки. Каждая из этих отметок может быть не более чем у одной подписи адреса, одна подпись может иметь обе, а у адреса может не быть ни одной.

Список листается с помощью limit и cursor, как любой список. Адрес, у которого была только единственная подпись из прежних версий, показывает её как одну подпись с названием Signature, по умолчанию для обоих случаев.

Ключ или приложение, ограниченные отдельными адресами или доменами, достают только до подписей доступных им адресов, а до подписей catch-all только тогда, когда им доступен весь домен.

Справочник