Skip to content

Remove the email logo

API v2 is in public beta: endpoints and fields can change before general availability. See the changelog

DELETE/account/templates/email_style/logo

Costs 2 rate-limit points · Rate limits

Remove the logo from every STOQ email, as the template editor's Remove logo link does.

Takes no body and returns the email style with logo_url null. Safe to retry: with no logo it still returns 200. logo_size and the fonts are kept, so a logo uploaded later with POST /account/templates/email_style/logo shows at the same width. Emails sent after this have no logo.

Also searched asremove email logodelete email logo

Headers

  • Idempotency-Keystring

    A fresh unique key for every write (a new UUID, say); reuse it only to retry that write. Keys are remembered for 1 hour: the same key and the same request within that hour returns the first result, with Idempotent-Replayed: true, without running again; the same key with a different method, path or body is refused (422 idempotency_key_reused); a retry while the first is still running gets 409 idempotency_key_in_progress. Keys are per store. Server errors and rate limits are not kept, so their retry runs.

Returns

  • font_familystring
    Example: Helvetica Neue, Helvetica, Arial, sans-serif
  • header_font_sizeinteger
    Example: 28
  • description_font_sizeinteger
    Example: 16
  • logo_sizeinteger
    Example: 160
  • logo_urlnull

Errors

409
idempotency_key_in_progress

An earlier request with the same Idempotency-Key is still running. Wait, then resend the same request with the same key.

422
invalid_params

One or more fields failed the action's schema.

422
validation_failed

The request failed validation.

Any request can also fail with auth_invalid (401) or rate_limited (429).

Every error has the same shape: see Errors and the list of error codes.

DELETE/account/templates/email_style/logo
curl -X DELETE "https://app.stoqapp.com/api/v2/external/account/templates/email_style/logo" \
  -H "X-Auth-Token: $STOQ_API_KEY"
Response
{
  "font_family": "Helvetica Neue, Helvetica, Arial, sans-serif",
  "header_font_size": 28,
  "description_font_size": 16,
  "logo_size": 160,
  "logo_url": null
}