List signatures

GET

/mail/signatures

const url = 'https://mail.work.optidata.cloud/api/mail/signatures';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://mail.work.optidata.cloud/api/mail/signatures \
  --header 'Authorization: Bearer <token>'

The signatures belonging to the authenticated user. hash is the stable identifier used to update one.

Authorizations

bearerAuth

Responses

200

The user’s signatures.

application/json

Array<object>

A signature block appended to outgoing mail.

object

integer

user_id

integer

hash

Stable identifier, used to address the signature.

string

name

string | null

content

HTML content.

string

created_at

string

updated_at

string

Examples

one

[
  {
    "id": 79,
    "user_id": 83,
    "hash": "39922fe6-7060-4932-bc32-eaf484adfd7a",
    "name": "Work",
    "content": "<div>Jane Doe — Acme</div>",
    "created_at": "2025-12-03T20:01:41.000000Z",
    "updated_at": "2026-07-10T12:35:17.000000Z"
  }
]

401

Missing, malformed or expired authentication key.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

missing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

429

Rate limit exceeded. Retry after the window resets.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

throttled

{
  "message": "Too Many Attempts."
}