Templates and content
E-mail templates (HTML or the visual MJML editor), content versions, lint and spam check, footers, unsubscribe pages, saved editor elements, script templates (Twig), SMS templates, landing pages, surveys and the file manager.
Technická referencia je v angličtine (rovnako ako strojovo čitateľný dokument OpenAPI). Celú skupinu pre AI agenta načítate z /api/openapi.json?tag=Templates.
Prihlásenie: Authorization: Bearer pst_... alebo HTTP Basic (e-mail člena firmy a API kľúč).
Operácie
| Metóda | Cesta | Popis |
|---|---|---|
| POST | /api/v1/tenants/{tenant}/content/lint | Check e-mail content (merge tags, links, required parts) |
| POST | /api/v1/tenants/{tenant}/content/spam-check | Antispam check of e-mail content |
| GET | /api/v1/tenants/{tenant}/editor-elements | List saved editor elements |
| POST | /api/v1/tenants/{tenant}/editor-elements | Save an editor element |
| PATCH | /api/v1/tenants/{tenant}/editor-elements/{element_id} | Update a saved editor element |
| DELETE | /api/v1/tenants/{tenant}/editor-elements/{element_id} | Delete a saved editor element |
| GET | /api/v1/tenants/{tenant}/file-folders | List folders of the file manager |
| POST | /api/v1/tenants/{tenant}/file-folders | Create a folder |
| PATCH | /api/v1/tenants/{tenant}/file-folders/{folder_id} | Rename a folder |
| DELETE | /api/v1/tenants/{tenant}/file-folders/{folder_id} | Delete a folder |
| GET | /api/v1/tenants/{tenant}/files | List files of the file manager |
| POST | /api/v1/tenants/{tenant}/files | Upload a file (multipart) |
| POST | /api/v1/tenants/{tenant}/files/stock-photo | Save a stock photo to the file manager |
| POST | /api/v1/tenants/{tenant}/files/video-thumbnail | Create a video thumbnail image |
| GET | /api/v1/tenants/{tenant}/files/{asset_id} | Get a file |
| PATCH | /api/v1/tenants/{tenant}/files/{asset_id} | Rename or move a file |
| DELETE | /api/v1/tenants/{tenant}/files/{asset_id} | Delete a file |
| POST | /api/v1/tenants/{tenant}/files/{asset_id}/picked | Record that a file was used |
| GET | /api/v1/tenants/{tenant}/footers | List footers |
| POST | /api/v1/tenants/{tenant}/footers | Create a footer |
| GET | /api/v1/tenants/{tenant}/footers/{footer_id} | Get a footer |
| PATCH | /api/v1/tenants/{tenant}/footers/{footer_id} | Rename a footer |
| DELETE | /api/v1/tenants/{tenant}/footers/{footer_id} | Delete a footer |
| PUT | /api/v1/tenants/{tenant}/footers/{footer_id}/content | Save the content of a footer |
| POST | /api/v1/tenants/{tenant}/footers/{footer_id}/copy | Copy a footer |
| POST | /api/v1/tenants/{tenant}/footers/{footer_id}/default | Make a footer the default |
| DELETE | /api/v1/tenants/{tenant}/footers/{footer_id}/default | Stop using a footer as the default |
| POST | /api/v1/tenants/{tenant}/footers/{footer_id}/publish | Publish a footer |
| GET | /api/v1/tenants/{tenant}/footers/{footer_id}/versions | List saved versions of a footer |
| GET | /api/v1/tenants/{tenant}/footers/{footer_id}/versions/{version_id} | Get one version of a footer |
| GET | /api/v1/tenants/{tenant}/landing-pages | List landing pages |
| POST | /api/v1/tenants/{tenant}/landing-pages | Create a landing page |
| GET | /api/v1/tenants/{tenant}/landing-pages/{landing_page_id} | Get a landing page |
| PATCH | /api/v1/tenants/{tenant}/landing-pages/{landing_page_id} | Update a landing page |
| DELETE | /api/v1/tenants/{tenant}/landing-pages/{landing_page_id} | Delete a landing page |
| POST | /api/v1/tenants/{tenant}/landing-pages/{landing_page_id}/copy | Copy a landing page |
| GET | /api/v1/tenants/{tenant}/script-templates | List script templates (Twig) |
| POST | /api/v1/tenants/{tenant}/script-templates | Create a script template |
| GET | /api/v1/tenants/{tenant}/script-templates/{script_id} | Get a script template |
| PATCH | /api/v1/tenants/{tenant}/script-templates/{script_id} | Update a script template |
| DELETE | /api/v1/tenants/{tenant}/script-templates/{script_id} | Delete a script template |
| GET | /api/v1/tenants/{tenant}/sms-templates | List SMS templates |
| POST | /api/v1/tenants/{tenant}/sms-templates | Create an SMS template |
| GET | /api/v1/tenants/{tenant}/sms-templates/{sms_template_id} | Get an SMS template |
| PATCH | /api/v1/tenants/{tenant}/sms-templates/{sms_template_id} | Update an SMS template |
| DELETE | /api/v1/tenants/{tenant}/sms-templates/{sms_template_id} | Delete an SMS template |
| POST | /api/v1/tenants/{tenant}/sms-templates/{sms_template_id}/copy | Copy an SMS template |
| GET | /api/v1/tenants/{tenant}/stock-photos | Search stock photos |
| GET | /api/v1/tenants/{tenant}/stock-photos/status | Whether the stock photo search is available |
| GET | /api/v1/tenants/{tenant}/surveys | List surveys |
| POST | /api/v1/tenants/{tenant}/surveys | Create a survey |
| GET | /api/v1/tenants/{tenant}/surveys/{survey_id} | Get a survey |
| PATCH | /api/v1/tenants/{tenant}/surveys/{survey_id} | Update a survey |
| DELETE | /api/v1/tenants/{tenant}/surveys/{survey_id} | Delete a survey |
| POST | /api/v1/tenants/{tenant}/surveys/{survey_id}/copy | Copy a survey |
| GET | /api/v1/tenants/{tenant}/surveys/{survey_id}/responses | List responses of a survey |
| GET | /api/v1/tenants/{tenant}/surveys/{survey_id}/results | Summary results of a survey |
| GET | /api/v1/tenants/{tenant}/templates | List templates |
| POST | /api/v1/tenants/{tenant}/templates | Create a template |
| POST | /api/v1/tenants/{tenant}/templates/tags | Change labels of templates |
| GET | /api/v1/tenants/{tenant}/templates/{template_id} | Get a template with its content |
| PATCH | /api/v1/tenants/{tenant}/templates/{template_id} | Update template settings (name, subject, preheader ...) |
| DELETE | /api/v1/tenants/{tenant}/templates/{template_id} | Delete a template |
| POST | /api/v1/tenants/{tenant}/templates/{template_id}/archive | Archive a template |
| PUT | /api/v1/tenants/{tenant}/templates/{template_id}/content | Save the content of a template |
| POST | /api/v1/tenants/{tenant}/templates/{template_id}/convert-to-visual | Convert an HTML template to the visual editor |
| DELETE | /api/v1/tenants/{tenant}/templates/{template_id}/draft | Discard the unpublished draft of a template |
| POST | /api/v1/tenants/{tenant}/templates/{template_id}/duplicate | Duplicate a template |
| POST | /api/v1/tenants/{tenant}/templates/{template_id}/publish | Publish the draft of a template used by an active automation |
| POST | /api/v1/tenants/{tenant}/templates/{template_id}/test | Send a test e-mail of a template |
| POST | /api/v1/tenants/{tenant}/templates/{template_id}/unarchive | Restore an archived template |
| GET | /api/v1/tenants/{tenant}/templates/{template_id}/versions | List saved content versions of a template |
| GET | /api/v1/tenants/{tenant}/templates/{template_id}/versions/{version_id} | Get one content version of a template |
| GET | /api/v1/tenants/{tenant}/test-recipients | List the test addresses of the company |
| PUT | /api/v1/tenants/{tenant}/test-recipients | Replace the test addresses of the company |
| GET | /api/v1/tenants/{tenant}/unsubscribe-pages | List unsubscribe pages |
| POST | /api/v1/tenants/{tenant}/unsubscribe-pages | Create an unsubscribe page |
| POST | /api/v1/tenants/{tenant}/unsubscribe-pages/preview | Render an unsubscribe page preview |
| GET | /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id} | Get an unsubscribe page |
| PATCH | /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id} | Update an unsubscribe page |
| DELETE | /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id} | Delete an unsubscribe page |
| POST | /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}/copy | Copy an unsubscribe page |
| POST | /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}/default | Make an unsubscribe page the default |
| DELETE | /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}/default | Stop using an unsubscribe page as the default |
Check e-mail content (merge tags, links, required parts)
POST /api/v1/tenants/{tenant}/content/lint
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full · Nástroj MCP: lint_content
Checks e-mail content (merge tags, emoji rules, footer, size, scripts) and answers issue codes.
Body {html, subject, preheader}: {issues: [{code, severity, params}]}, errors first (codes only).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
html | string | áno | |
subject | string | áno | |
preheader | string | áno |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | html, subject |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Antispam check of e-mail content
POST /api/v1/tenants/{tenant}/content/spam-check
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Body {html, subject, preheader}: {score, verdict (ok | spam | blocked), sizeKb, rules: [{code, points, found?}]} of Poštárna's own antispam rules (core/spam_check.py, SmartEmailing's "Antispamová kontrola: X / 5"); found = the phrases, hosts, domains or tags a rule found.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
html | string | áno | |
subject | string | áno | |
preheader | string | áno |
Odpovede
- 200 OK:
application/jsonSpamCheck
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | html, subject |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List saved editor elements
GET /api/v1/tenants/{tenant}/editor-elements
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
{items: [{id, name, category, kind, mjml, createdAt, updatedAt}]} by category, then name.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Save an editor element
POST /api/v1/tenants/{tenant}/editor-elements
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {name, category?, kind, mjml}: 201 with the element; 409 conflict name (taken in the category), 400 validation limit (500 elements per tenant) or the field.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
category | string | nie | |
kind | EditorElementKind | áno | |
mjml | string | áno |
Odpovede
- 201 Created:
application/jsonEditorElement
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update a saved editor element
PATCH /api/v1/tenants/{tenant}/editor-elements/{element_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {name?, category?, mjml?}: the element.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
element_id | path | string | áno | Id of the element (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
category | string | nie | |
mjml | string | nie |
Odpovede
- 200 OK:
application/jsonEditorElement
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a saved editor element
DELETE /api/v1/tenants/{tenant}/editor-elements/{element_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
element_id | path | string | áno | Id of the element (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List folders of the file manager
GET /api/v1/tenants/{tenant}/file-folders
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create a folder
POST /api/v1/tenants/{tenant}/file-folders
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
parentId | string or null | áno |
Odpovede
- 201 Created:
application/jsonFileFolder
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable | storage |
Rename a folder
PATCH /api/v1/tenants/{tenant}/file-folders/{folder_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
folder_id | path | string | áno | Id of the folder (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
parentId | string or null | nie |
Odpovede
- 200 OK:
application/jsonFileFolder
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable | storage |
Delete a folder
DELETE /api/v1/tenants/{tenant}/file-folders/{folder_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
folder_id | path | string | áno | Id of the folder (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable | storage |
List files of the file manager
GET /api/v1/tenants/{tenant}/files
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
?folderId= (empty or missing = the root), ?q= (name contains, all folders), ?sort= name (default), -name, created, -created, size, -size, ?type=image (pictures only), ?recent=1 (files picked into an e-mail, newest pick first, all folders: folderId and sort are ignored), page, pageSize.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
folderId | query | string | nie | |
page | query | integer | nie | Page number, from 1. default 1, min 1 |
pageSize | query | integer | nie | Items per page, 1 to 100. default 25, min 1, max 100 |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
recent | query | string | nie | |
sort | query | string | nie | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
type | query | string | nie |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | recent, sort, type |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable | storage |
Upload a file (multipart)
POST /api/v1/tenants/{tenant}/files
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
multipart/form-data: file (one file), folderId (optional). 201 with the file.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (multipart/form-data)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
file | string (binary) | áno | The file. |
Odpovede
- 201 Created:
application/jsonStoredFile
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | file |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable | storage |
Save a stock photo to the file manager
POST /api/v1/tenants/{tenant}/files/stock-photo
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {id, size?, folderId?}: the picture of the photo bank downloaded into the file manager (no hotlinking), in the root folder Fotobanka unless folderId is given; size large (1280 px, default) or web (640 px). An identical picture stored before is returned instead of a copy. 201 {file, photo: {id, pageUrl, user, userUrl}, existing}.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json): Required by the server: id.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
size | one of: large, web | nie | |
folderId | string or null | nie |
Odpovede
- 201 Created:
application/jsonStockPhotoSaved
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | rate_limited | stock |
| 502 | upstream | stock |
| 503 | unavailable | stock, storage |
Create a video thumbnail image
POST /api/v1/tenants/{tenant}/files/video-thumbnail
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {url, folderId?}: the thumbnail of a YouTube or Vimeo video as a file (core/video_thumbs.py), in the root folder Videa unless folderId is given; an identical picture already stored is returned instead. 201 {file, provider, videoId, videoUrl, title}. 400 validation url (reason unsupported) for another address, 502 upstream url (reason not_found, http_<status>, network, too_large, invalid, host) when the picture cannot be fetched.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json): Required by the server: url.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
url | string | áno | |
folderId | string or null | nie |
Odpovede
- 201 Created:
application/jsonVideoThumbnail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | url |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 502 | upstream | url |
| 503 | unavailable | storage |
Get a file
GET /api/v1/tenants/{tenant}/files/{asset_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
The file and its uses: {templates, campaigns} whose content names its address (shown before a delete).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
asset_id | path | string | áno | Id of the asset (string of digits). |
Odpovede
- 200 OK:
application/jsonStoredFileDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Rename or move a file
PATCH /api/v1/tenants/{tenant}/files/{asset_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {name, folderId} (any of them): the address stays the same.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
asset_id | path | string | áno | Id of the asset (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
folderId | string or null | nie |
Odpovede
- 200 OK:
application/jsonStoredFile
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable | storage |
Delete a file
DELETE /api/v1/tenants/{tenant}/files/{asset_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
asset_id | path | string | áno | Id of the asset (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Record that a file was used
POST /api/v1/tenants/{tenant}/files/{asset_id}/picked
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
The editor picked the file into an e-mail: picked_at = now (the library's recently used tab). The file.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
asset_id | path | string | áno | Id of the asset (string of digits). |
Odpovede
- 200 OK:
application/jsonStoredFile
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List footers
GET /api/v1/tenants/{tenant}/footers
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
?editor=visual|html (default all), ?q= part of the name, ?sort= id, name, default with '-' for descending.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
editor | query | string | nie | |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
sort | query | string | nie | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | editor, sort |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create a footer
POST /api/v1/tenants/{tenant}/footers
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
editor | one of: visual, html | áno | |
html | string | áno | |
design | EmailDesign or null | áno |
Odpovede
- 201 Created:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get a footer
GET /api/v1/tenants/{tenant}/footers/{footer_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Odpovede
- 200 OK:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Rename a footer
PATCH /api/v1/tenants/{tenant}/footers/{footer_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno |
Odpovede
- 200 OK:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a footer
DELETE /api/v1/tenants/{tenant}/footers/{footer_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
204; 409 default for the default footer.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Save the content of a footer
PUT /api/v1/tenants/{tenant}/footers/{footer_id}/content
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
The draft as e-mail content {editor, html, design, baseVersion, saveKind}: EmailContent; 409 version.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
editor | one of: visual, html | áno | |
html | string | áno | |
design | EmailDesign or null | áno | |
baseVersion | number | áno | The version the editor started from; a newer one on the server answers 409 version (saved elsewhere meanwhile). |
saveKind | one of: manual, auto, restore | nie | History entry kind: auto (autosave, journaled), manual (Uložit), restore (a version taken back). Default auto. |
Odpovede
- 200 OK:
application/jsonEmailContent
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Copy a footer
POST /api/v1/tenants/{tenant}/footers/{footer_id}/copy
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Kopírovat patičku: body {suffix} (the word after the name, from the client's language, default 'kopie').
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
suffix | string | áno |
Odpovede
- 201 Created:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Make a footer the default
POST /api/v1/tenants/{tenant}/footers/{footer_id}/default
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Nastavit jako výchozí: 409 published for a footer that was never published.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Telo požiadavky (application/json)
object
Odpovede
- 200 OK:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Stop using a footer as the default
DELETE /api/v1/tenants/{tenant}/footers/{footer_id}/default
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Odpovede
- 200 OK:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Publish a footer
POST /api/v1/tenants/{tenant}/footers/{footer_id}/publish
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Publikovat: 409 incomplete with {gaps: [link, sender, loop, empty]}.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
Telo požiadavky (application/json)
object
Odpovede
- 200 OK:
application/jsonFooterDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List saved versions of a footer
GET /api/v1/tenants/{tenant}/footers/{footer_id}/versions
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
before | query | string | nie | |
limit | query | string | nie |
Odpovede
- 200 OK:
application/jsonContentVersionList
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get one version of a footer
GET /api/v1/tenants/{tenant}/footers/{footer_id}/versions/{version_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
footer_id | path | string | áno | Id of the footer (string of digits). |
version_id | path | string | áno | Id of the version (string of digits). |
Odpovede
- 200 OK:
application/jsonContentVersionDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List landing pages
GET /api/v1/tenants/{tenant}/landing-pages
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
{items: LandingPageSummary[]} without the HTML.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
sort | query | string | nie | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | sort |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create a landing page
POST /api/v1/tenants/{tenant}/landing-pages
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
active | boolean | áno | |
html | string | áno |
Odpovede
- 201 Created:
application/jsonLandingPage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get a landing page
GET /api/v1/tenants/{tenant}/landing-pages/{landing_page_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
landing_page_id | path | string | áno | Id of the landing page (string of digits). |
Odpovede
- 200 OK:
application/jsonLandingPage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update a landing page
PATCH /api/v1/tenants/{tenant}/landing-pages/{landing_page_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
landing_page_id | path | string | áno | Id of the landing page (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
active | boolean | nie | |
html | string | nie |
Odpovede
- 200 OK:
application/jsonLandingPage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a landing page
DELETE /api/v1/tenants/{tenant}/landing-pages/{landing_page_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
landing_page_id | path | string | áno | Id of the landing page (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Copy a landing page
POST /api/v1/tenants/{tenant}/landing-pages/{landing_page_id}/copy
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
landing_page_id | path | string | áno | Id of the landing page (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
suffix | string | áno |
Odpovede
- 201 Created:
application/jsonLandingPage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List script templates (Twig)
GET /api/v1/tenants/{tenant}/script-templates
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
{items: [{id, name, content, parses, createdAt, updatedAt}]}; ?q= (name or content contains), ?sort= id, name, content, createdAt, updatedAt with a leading '-' for descending (default -createdAt, SmartEmailing's grid).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
sort | query | string | nie | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | sort |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create a script template
POST /api/v1/tenants/{tenant}/script-templates
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {name, content}: 201 with the template; 409 conflict name, 400 validation (field or limit).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
content | string | áno |
Odpovede
- 201 Created:
application/jsonScriptTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get a script template
GET /api/v1/tenants/{tenant}/script-templates/{script_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
script_id | path | string | áno | Id of the script (string of digits). |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update a script template
PATCH /api/v1/tenants/{tenant}/script-templates/{script_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {name?, content?}: the template.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
script_id | path | string | áno | Id of the script (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
content | string | nie |
Odpovede
- 200 OK:
application/jsonScriptTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a script template
DELETE /api/v1/tenants/{tenant}/script-templates/{script_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
script_id | path | string | áno | Id of the script (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List SMS templates
GET /api/v1/tenants/{tenant}/sms-templates
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
sort | query | string | nie | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | sort |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create an SMS template
POST /api/v1/tenants/{tenant}/sms-templates
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
body | string | áno | |
stripDiacritics | boolean | áno | Odeslat bez diakritiky: the text goes without accents (GSM 7-bit). |
Odpovede
- 201 Created:
application/jsonSmsTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get an SMS template
GET /api/v1/tenants/{tenant}/sms-templates/{sms_template_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
sms_template_id | path | string | áno | Id of the sms template (string of digits). |
Odpovede
- 200 OK:
application/jsonSmsTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update an SMS template
PATCH /api/v1/tenants/{tenant}/sms-templates/{sms_template_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
sms_template_id | path | string | áno | Id of the sms template (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
body | string | nie | |
stripDiacritics | boolean | nie | Odeslat bez diakritiky: the text goes without accents (GSM 7-bit). |
Odpovede
- 200 OK:
application/jsonSmsTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete an SMS template
DELETE /api/v1/tenants/{tenant}/sms-templates/{sms_template_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
sms_template_id | path | string | áno | Id of the sms template (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Copy an SMS template
POST /api/v1/tenants/{tenant}/sms-templates/{sms_template_id}/copy
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
sms_template_id | path | string | áno | Id of the sms template (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
suffix | string | áno |
Odpovede
- 201 Created:
application/jsonSmsTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Search stock photos
GET /api/v1/tenants/{tenant}/stock-photos
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Search of the photo bank (core/stock_photos.search_params): ?q, lang (cs, sk, en ...), imageType (all, photo, illustration, vector), orientation (all, horizontal, vertical), category, colors (comma separated), order (popular, latest), minWidth, minHeight, editorsChoice, page, perPage (3 to 200; at most 500 results). safesearch is always on. {total, totalHits, page, perPage, hits, source, sourceUrl}; the answers are cached for 24 hours.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
category | query | string | nie | |
colors | query | string | nie | |
editorsChoice | query | string | nie | |
imageType | query | string | nie | |
lang | query | string | nie | |
minHeight | query | string | nie | |
minWidth | query | string | nie | |
order | query | string | nie | |
orientation | query | string | nie | |
page | query | integer | nie | Page number, from 1. default 1, min 1 |
perPage | query | string | nie | |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
Odpovede
- 200 OK:
application/jsonStockResult
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | rate_limited | stock |
| 502 | upstream | stock |
| 503 | unavailable | stock |
Whether the stock photo search is available
GET /api/v1/tenants/{tenant}/stock-photos/status
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
{configured, source}: whether the photo bank has its key (the tab says it is not set up otherwise).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Odpovede
- 200 OK:
application/jsonStockStatus
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List surveys
GET /api/v1/tenants/{tenant}/surveys
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
q | query | string | nie | Search text (case and diacritics insensitive). max 200 chars |
sort | query | string | nie | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | sort |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create a survey
POST /api/v1/tenants/{tenant}/surveys
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
active | boolean | nie | An inactive survey answers 404. |
title | string | nie | |
intro | string | nie | |
pages | array of SurveyPage | nie | |
thanksHtml | string | nie | |
afterUrl | string | nie | Address after the last page instead of the thank-you text. |
oneResponse | boolean | nie | One contact answers once (the recipient's link). |
Odpovede
- 201 Created:
application/jsonSurvey
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get a survey
GET /api/v1/tenants/{tenant}/surveys/{survey_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
survey_id | path | string | áno | Id of the survey (string of digits). |
Odpovede
- 200 OK:
application/jsonSurvey
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update a survey
PATCH /api/v1/tenants/{tenant}/surveys/{survey_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
survey_id | path | string | áno | Id of the survey (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
active | boolean | nie | An inactive survey answers 404. |
title | string | nie | |
intro | string | nie | |
pages | array of SurveyPage | nie | |
thanksHtml | string | nie | |
afterUrl | string | nie | Address after the last page instead of the thank-you text. |
oneResponse | boolean | nie | One contact answers once (the recipient's link). |
Odpovede
- 200 OK:
application/jsonSurvey
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a survey
DELETE /api/v1/tenants/{tenant}/surveys/{survey_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
survey_id | path | string | áno | Id of the survey (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Copy a survey
POST /api/v1/tenants/{tenant}/surveys/{survey_id}/copy
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
survey_id | path | string | áno | Id of the survey (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
suffix | string | áno |
Odpovede
- 201 Created:
application/jsonSurvey
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List responses of a survey
GET /api/v1/tenants/{tenant}/surveys/{survey_id}/responses
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
?page=, ?pageSize= (at most 100): {items: [{id, contactId, email, answers, submittedAt}], total, page, pageSize}, newest first; email '' for an anonymous answer.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
survey_id | path | string | áno | Id of the survey (string of digits). |
page | query | integer | nie | Page number, from 1. default 1, min 1 |
pageSize | query | integer | nie | Items per page, 1 to 100. default 25, min 1, max 100 |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | page |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Summary results of a survey
GET /api/v1/tenants/{tenant}/surveys/{survey_id}/results
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
survey_id | path | string | áno | Id of the survey (string of digits). |
Odpovede
- 200 OK:
application/jsonSurveyResults
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List templates
GET /api/v1/tenants/{tenant}/templates
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full · Nástroj MCP: list_templates
E-mail templates (status active, archived or all) with size, usage and the stored content check.
?status=active (default), archived or all.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
status | query | one of: active, archived, all | nie | Status filter. |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | status |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create a template
POST /api/v1/tenants/{tenant}/templates
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: create_template
Creates a template with content {editor: html|visual, html, design}.
Body {name, subject, preheader, tags, content, saveKind?}: 201 with the template; its first content goes to the save history with saveKind (default auto).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
subject | string | áno | |
preheader | string | áno | |
tags | array of string | nie | |
content | object | áno | A copy of a design: a starter, a campaign or another template. |
Odpovede
- 201 Created:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | saveKind |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Change labels of templates
POST /api/v1/tenants/{tenant}/templates/tags
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Štítky of e-mail templates (SE ⋮ "Nastavit štítky", bulk "Přiřadit štítky").
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json): Required by the server: ids.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ids | array of string | áno | |
add | array of string | nie | |
remove | array of string | nie | |
tags | array of string | nie |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | ids |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get a template with its content
GET /api/v1/tenants/{tenant}/templates/{template_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full · Nástroj MCP: get_template
One template with its content (editor, html, design, version).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Odpovede
- 200 OK:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update template settings (name, subject, preheader ...)
PATCH /api/v1/tenants/{tenant}/templates/{template_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: update_template (cez MCP len s náhľadom a potvrdením)
Changes name, subject, preheader or tags.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
tags | array of string | nie | |
subject | string | nie | |
preheader | string | nie | |
linkParams | array of CampaignLinkParam | nie | Google Analytics parameters added to links of the e-shop (as a campaign's linkParams). |
headers | array of CampaignHeader | nie | Own e-mail headers (X-...). |
unsubscribePageId | string or null | nie | Null = the default unsubscribe page. |
footerId | string or null | nie | Null = the default footer of the editor. |
Odpovede
- 200 OK:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a template
DELETE /api/v1/tenants/{tenant}/templates/{template_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: delete_template (cez MCP len s náhľadom a potvrdením)
Deletes a template (campaigns keep their own copy of the content).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Archive a template
POST /api/v1/tenants/{tenant}/templates/{template_id}/archive
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: archive_template
Archives a template.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
object
Odpovede
- 200 OK:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Save the content of a template
PUT /api/v1/tenants/{tenant}/templates/{template_id}/content
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: save_template_content (cez MCP len s náhľadom a potvrdením)
Saves the HTML or MJML content of a template. baseVersion = the version you read (conflict when someone saved since).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
editor | one of: visual, html | áno | |
html | string | áno | |
design | EmailDesign or null | áno | |
baseVersion | number | áno | The version the editor started from; a newer one on the server answers 409 version (saved elsewhere meanwhile). |
saveKind | one of: manual, auto, restore | nie | History entry kind: auto (autosave, journaled), manual (Uložit), restore (a version taken back). Default auto. |
Odpovede
- 200 OK:
application/jsonEmailContent
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Convert an HTML template to the visual editor
POST /api/v1/tenants/{tenant}/templates/{template_id}/convert-to-visual
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: convert_template_to_visual
Creates a NEW visual (block) template converted from an HTML template; the original stays. Answers the template and conversion {quality: clean|partial|raw, stats}.
Body {name} (optional, default "<name> (vizuální)"): a NEW visual template converted from an HTML template (core/html_to_mjml.py), 201 with the template and conversion {quality, stats}; the original stays as it is. 409 editor (not an HTML template), 409 content (nothing to convert), 409 name, 400 lint (banned hosts).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno |
Odpovede
- 201 Created:
application/jsonConvertedTemplate
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Discard the unpublished draft of a template
DELETE /api/v1/tenants/{tenant}/templates/{template_id}/draft
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Zahodit změny: the draft goes, the published content stays (409 draft without one). Answers the template.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Odpovede
- 200 OK:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Duplicate a template
POST /api/v1/tenants/{tenant}/templates/{template_id}/duplicate
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: duplicate_template
Copies a template under a new name.
Body {name}: the copy (active, writable), 201.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
object
Odpovede
- 201 Created:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Publish the draft of a template used by an active automation
POST /api/v1/tenants/{tenant}/templates/{template_id}/publish
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Body {password} (a person with a password) or {confirm: <template name>} (Google sign-in, API key): the draft of a template becomes the content its e-mails send (SE "Uložit a publikovat změny", a dangerous action that asks for the password). 401 invalid_credentials (wrong password, counted like a sign-in), 429 after too many, 400 confirm, 409 draft (nothing to publish), 400 lint (hard checks). Answers the template.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
Odpovede
- 200 OK:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | confirm |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Send a test e-mail of a template
POST /api/v1/tenants/{tenant}/templates/{template_id}/test
Oprávnenie: modul content, úroveň full; kľúč s prístupom full · Nástroj MCP: send_template_test
Sends a test e-mail of a template to the account's test addresses only (list_test_recipients), with [TEST] in the subject.
Body {shopId, to}: the shop gives the sender and the footer.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
shopId | string | áno | |
to | string | áno |
Odpovede
- 200 OK:
application/jsonTestSendResult
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. | |
| 503 | unavailable |
Restore an archived template
POST /api/v1/tenants/{tenant}/templates/{template_id}/unarchive
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
409 read_only for archive copies of imported originals, 409 lint (codes, hosts) for banned addresses.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
Odpovede
- 200 OK:
application/jsonTemplateDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List saved content versions of a template
GET /api/v1/tenants/{tenant}/templates/{template_id}/versions
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
?before=<snapshot id>&limit=1..100 (default 50): {items: [{id, version, kind, createdAt, createdBy}], more}, newest first; createdBy = the saver's name or e-mail, null when not known.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
before | query | string | nie | |
limit | query | string | nie |
Odpovede
- 200 OK:
application/jsonContentVersionList
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get one content version of a template
GET /api/v1/tenants/{tenant}/templates/{template_id}/versions/{version_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
One snapshot with content {editor, html, design}.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
template_id | path | string | áno | Id of the template (string of digits). |
version_id | path | string | áno | Id of the version (string of digits). |
Odpovede
- 200 OK:
application/jsonContentVersionDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List the test addresses of the company
GET /api/v1/tenants/{tenant}/test-recipients
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full · Nástroj MCP: list_test_recipients
Addresses that may receive test e-mails.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Replace the test addresses of the company
PUT /api/v1/tenants/{tenant}/test-recipients
Oprávnenie: modul settings, úroveň full; kľúč s prístupom full
Body {items: [e-mail, ...]} (at most 20): the addresses test e-mails may go to (Nastavení › Odesílání).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json): Required by the server: items.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
items | array of string | áno |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List unsubscribe pages
GET /api/v1/tenants/{tenant}/unsubscribe-pages
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Create an unsubscribe page
POST /api/v1/tenants/{tenant}/unsubscribe-pages
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
active | boolean | nie | Active pages may be the default; an active page cannot be deleted. |
mode | one of: page, redirect | nie | page = Zobrazit odhlašovací stránku; redirect = skip it, unsubscribe and go to redirectUrl. |
redirectUrl | string | nie | |
logoUrl | string | nie | |
videoUrl | string | nie | YouTube only. |
language | one of: cs, sk, auto, en, pl, de, hu, it, ro, uk | nie | |
customHtml | string | nie | |
questionEnabled | boolean | nie | |
question | string | nie | |
answers | array of string | nie | |
afterUrl | string | nie | Přesměrování po odhlášení ('' = the thank-you page); merge tags of the contact allowed. |
Odpovede
- 201 Created:
application/jsonUnsubscribePage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Render an unsubscribe page preview
POST /api/v1/tenants/{tenant}/unsubscribe-pages/preview
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
The page of unsaved settings ({name, ... as a create}) as HTML with sample values.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
active | boolean | nie | Active pages may be the default; an active page cannot be deleted. |
mode | one of: page, redirect | nie | page = Zobrazit odhlašovací stránku; redirect = skip it, unsubscribe and go to redirectUrl. |
redirectUrl | string | nie | |
logoUrl | string | nie | |
videoUrl | string | nie | YouTube only. |
language | one of: cs, sk, auto, en, pl, de, hu, it, ro, uk | nie | |
customHtml | string | nie | |
questionEnabled | boolean | nie | |
question | string | nie | |
answers | array of string | nie | |
afterUrl | string | nie | Přesměrování po odhlášení ('' = the thank-you page); merge tags of the contact allowed. |
Odpovede
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Get an unsubscribe page
GET /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}
Oprávnenie: modul content, úroveň read; kľúč s prístupom read alebo full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
unsub_page_id | path | string | áno | Id of the unsub page (string of digits). |
Odpovede
- 200 OK:
application/jsonUnsubscribePage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Update an unsubscribe page
PATCH /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
409 default when the default page would stop being active.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
unsub_page_id | path | string | áno | Id of the unsub page (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
active | boolean | nie | Active pages may be the default; an active page cannot be deleted. |
mode | one of: page, redirect | nie | page = Zobrazit odhlašovací stránku; redirect = skip it, unsubscribe and go to redirectUrl. |
redirectUrl | string | nie | |
logoUrl | string | nie | |
videoUrl | string | nie | YouTube only. |
language | one of: cs, sk, auto, en, pl, de, hu, it, ro, uk | nie | |
customHtml | string | nie | |
questionEnabled | boolean | nie | |
question | string | nie | |
answers | array of string | nie | |
afterUrl | string | nie | Přesměrování po odhlášení ('' = the thank-you page); merge tags of the contact allowed. |
Odpovede
- 200 OK:
application/jsonUnsubscribePage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete an unsubscribe page
DELETE /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
204; 409 active for an active page (deactivate it first).
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
unsub_page_id | path | string | áno | Id of the unsub page (string of digits). |
Odpovede
- 204 No content
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Copy an unsubscribe page
POST /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}/copy
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
An inactive copy; body {suffix} (default 'kopie').
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
unsub_page_id | path | string | áno | Id of the unsub page (string of digits). |
Telo požiadavky (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
suffix | string | áno |
Odpovede
- 201 Created:
application/jsonUnsubscribePage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Make an unsubscribe page the default
POST /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}/default
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
409 active for an inactive page.
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
unsub_page_id | path | string | áno | Id of the unsub page (string of digits). |
Telo požiadavky (application/json)
object
Odpovede
- 200 OK:
application/jsonUnsubscribePage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Stop using an unsubscribe page as the default
DELETE /api/v1/tenants/{tenant}/unsubscribe-pages/{unsub_page_id}/default
Oprávnenie: modul content, úroveň full; kľúč s prístupom full
Parametre
| Názov | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | áno | Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page. |
unsub_page_id | path | string | áno | Id of the unsub page (string of digits). |
Odpovede
- 200 OK:
application/jsonUnsubscribePage
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | |
| 401 | 401 unauthorized: missing, unknown, revoked, expired or idle API key. | |
| 403 | 403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack. | |
| 404 | not_found | |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Schémy
BoxPadding
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
top | number | áno | |
right | number | áno | |
bottom | number | áno | |
left | number | áno |
CampaignHeader
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
value | string | áno |
CampaignLinkParam
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
value | string | áno |
ContentVersion
One entry of the content history (Historie uložení).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
version | number | áno | |
kind | one of: manual, auto, restore | áno | |
createdAt | string | áno | |
createdBy | string or null | áno | Name or e-mail of the user; null for the API or unknown. |
ContentVersionDetail
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
content | object | áno | |
id | string | áno | |
version | number | áno | |
kind | one of: manual, auto, restore | áno | |
createdAt | string | áno | |
createdBy | string or null | áno | Name or e-mail of the user; null for the API or unknown. |
ContentVersionList
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
items | array of ContentVersion | áno | |
more | boolean | áno |
ConvertedTemplate
Result of POST /templates/{id}/convert-to-visual: the new template and how much of it became blocks.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
conversion | object | áno | |
content | EmailContent | áno | What the editor opens: the draft of a template in use, else the published content. |
settings | TemplateSettings | áno | |
draft | object | áno | A template that active automations send keeps its published content; the editor saves a draft until it is published with the password (POST /templates/{id}/publish) or thrown away (DELETE /templates/{id}/draft). |
activeUses | TemplateActiveUses | áno | |
publicUrl | string | áno | Veřejný náhled: a public page with the content (merge tags unfilled). |
id | string | áno | |
name | string | áno | |
subject | string | áno | |
preheader | string | áno | |
editor | one of: visual, html | áno | |
createdAt | string | áno | |
updatedAt | string | áno | |
tags | array of string | áno | |
size | number | áno | Size of the HTML in bytes (Gmail clips messages over 102 kB). |
archived | boolean | áno | Archived templates are not offered for new campaigns; they can be duplicated or restored. |
archivedAt | string or null | áno | |
readOnly | boolean | áno | Archive copy of an imported SmartEmailing original: content, name and tags never change, no delete or restore. |
usage | object | áno | Campaigns made from the template and e-mail nodes of automations naming it. |
lastUsedAt | string or null | áno | Newest such campaign or automation e-mail. |
check | TemplateCheck | áno |
EditorElement
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
category | string | áno | |
kind | EditorElementKind | áno | |
mjml | string | áno | |
createdAt | string | áno | |
updatedAt | string | áno |
EditorElementInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
category | string | nie | |
kind | EditorElementKind | áno | |
mjml | string | áno |
EditorElementKind
one of: text, image, button, row, feed, logo, video, divider, spacer, section
EmailContent
E-mail content of a template or a campaign.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
editor | one of: visual, html | áno | |
html | string | áno | HTML with merge tags left in place (compiled from the design, or written by hand); the core personalises and sends it. |
design | EmailDesign or null | áno | Visual editor only. |
version | number | áno | 0 = no content yet; every save adds one. |
updatedAt | string or null | áno |
EmailContentInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
editor | one of: visual, html | áno | |
html | string | áno | |
design | EmailDesign or null | áno | |
baseVersion | number | áno | The version the editor started from; a newer one on the server answers 409 version (saved elsewhere meanwhile). |
saveKind | one of: manual, auto, restore | nie | History entry kind: auto (autosave, journaled), manual (Uložit), restore (a version taken back). Default auto. |
EmailDesign
Source of a visual design: MJML plus the global styles, so the editor reopens it exactly.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
format | mjml-1 | áno | Format version; a later editor migrates older designs. |
mjml | string | áno | |
styles | EmailStyles | áno |
EmailStyles
Global look of a visual design. The editor writes it as MJML attributes; every element can override it.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
fontFamily | string | áno | One of EMAIL_FONTS (web-safe stacks; recipients' clients have no web fonts by default). |
headingFontFamily | string | áno | |
fontSize | number | áno | Base text size in px (12 to 20). |
textColor | string | áno | |
headingColor | string | áno | |
linkColor | string | áno | |
buttonColor | string | áno | |
buttonTextColor | string | áno | |
backgroundColor | string | áno | Around the e-mail. |
contentColor | string | áno | Body of the e-mail. |
width | number | áno | Width of the e-mail in px (480 to 800). |
magic | MagicStyles | nie | Settings of the Magic editor (e-mail paddings, text styles, dark mode, element defaults); the server keeps the object as it is (bounded JSON, API-CONTRACT.md). Absent in designs saved before it. |
Error
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
error | object | áno |
{
"error": {
"code": "validation",
"message": "email"
}
}FileFolder
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
parentId | string or null | áno | null = the root. |
files | number | áno | Files directly in the folder. |
createdAt | string | áno |
FileSource
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
author | string | áno | |
authorUrl | string | áno | |
pageUrl | string | áno |
FooterDetail
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
content | EmailContent | áno | |
publishedHtml | string | áno | The copy e-mails end with ('' before the first Publikovat); the Magic editor shows it (PA-01). |
id | string | áno | |
name | string | áno | |
editor | one of: visual, html | áno | visual = Magic Editor list, html = Smart Editor list. |
isDefault | boolean | áno | E-mails of this editor end with it (instead of the e-shop's standard footer); at most one per editor. |
published | boolean | áno | E-mails use only the published copy (Publikovat). |
publishedAt | string or null | áno | |
unpublishedChanges | boolean | áno | The draft differs from the published copy (or was never published). |
gaps | array of FooterGap | áno | |
createdAt | string | áno | |
updatedAt | string | áno | |
contentUpdatedAt | string or null | áno | |
publicUrl | string | áno | Public preview of the draft (Zkopírovat veřejný odkaz). |
FooterGap
one of: link, sender, loop, empty
FooterInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
editor | one of: visual, html | áno | |
html | string | áno | |
design | EmailDesign or null | áno |
FooterSummary
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
editor | one of: visual, html | áno | visual = Magic Editor list, html = Smart Editor list. |
isDefault | boolean | áno | E-mails of this editor end with it (instead of the e-shop's standard footer); at most one per editor. |
published | boolean | áno | E-mails use only the published copy (Publikovat). |
publishedAt | string or null | áno | |
unpublishedChanges | boolean | áno | The draft differs from the published copy (or was never published). |
gaps | array of FooterGap | áno | |
createdAt | string | áno | |
updatedAt | string | áno | |
contentUpdatedAt | string or null | áno | |
publicUrl | string | áno | Public preview of the draft (Zkopírovat veřejný odkaz). |
GridTagsInput
Bulk label change: add and remove, or tags = the new labels of every row.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ids | array of string | áno | |
add | array of string | nie | |
remove | array of string | nie | |
tags | array of string | nie |
LandingPage
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
html | string | áno | |
id | string | áno | |
name | string | áno | |
active | boolean | áno | An inactive page answers 404 on its address. |
url | string | áno | The public address on the link domain. |
createdAt | string | áno | |
updatedAt | string | áno |
LandingPageInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
active | boolean | áno | |
html | string | áno |
LandingPageSummary
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
active | boolean | áno | An inactive page answers 404 on its address. |
url | string | áno | The public address on the link domain. |
createdAt | string | áno | |
updatedAt | string | áno |
LintIssue
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
code | one of: subject_missing, subject_too_long, content_empty, unknown_tag, foreign_tag, script_tag, script_error, unsupported_filter, bad_fallback, emoji, forbidden_word, image_placeholder, image_data_uri, banned_host, html_too_large, no_unsubscribe, footer_incomplete, subject_long, img_without_alt, insecure_image, image_too_large, image_foreign_host, text_image_ratio | áno | |
severity | LintSeverity | áno | Errors block the approval of a campaign; warnings do not. |
params | map of string or number | áno |
LintRequest
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
html | string | áno | |
subject | string | áno | |
preheader | string | áno |
LintSeverity
one of: error, warning
MagicBackground
A background of the Magic editor: a plain colour, a linear gradient or a picture (https).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
type | one of: color, gradient, image | áno | |
from | string | nie | |
to | string | nie | |
angle | number | nie | Gradient direction in degrees (180 = top to bottom). |
image | string | nie | |
fit | one of: cover, repeat, original | nie | Picture: cover the area, tile, or the original size once. |
MagicStyles
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
padding | BoxPadding | nie | Space around the e-mail body, desktop and mobile. |
paddingMobile | BoxPadding | nie | |
darkMode | boolean | nie | Dark mode in the recipient's app (prefers-color-scheme) with its colours. |
darkBackgroundColor | string | nie | |
darkContentColor | string | nie | |
darkTextColor | string | nie | |
darkHeadingColor | string | nie | |
darkLinkColor | string | nie | |
darkButtonColor | string | nie | Dark mode colours of the buttons and the divider (SE: every colour has its "(tmavé schéma)" variant). |
darkButtonTextColor | string | nie | |
darkButton2Color | string | nie | |
darkButton2TextColor | string | nie | |
darkDividerColor | string | nie | |
background | MagicBackground | nie | SE "Typ pozadí" of the e-mail (around the body) and of the body: a gradient or a picture over the colour (backgroundColor / contentColor stay the fallback of clients without head styles). |
bodyBackground | MagicBackground | nie | |
button2Color | string | nie | Secondary button and divider colours. |
button2TextColor | string | nie | |
button2BorderColor | string | nie | |
buttonBorderColor | string | nie | |
dividerColor | string | nie | |
footerDefault | boolean | nie | System footer (SmartEmailing "Patička"): its own default look instead of the e-mail's, and no background. |
footerTransparent | boolean | nie | |
text | object | nie | Text styles per kind; missing keys = defaults. Mobile values override desktop ones under 480 px. |
textMobile | object | nie | |
defaults | object | nie | Defaults of new elements (SmartEmailing "Prvky"). |
ScriptTemplate
A script template (SmartEmailing "Šablony skriptů"): a reusable piece of template script.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
content | string | áno | |
parses | boolean | áno | The piece is a complete script by itself (half of a pair is allowed too). |
createdAt | string | áno | |
updatedAt | string | áno |
ScriptTemplateInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
content | string | áno |
SmsTemplate
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
length | number | áno | The counter of the server (screens/sms/smsModel.ts gives the same). |
parts | number | áno | |
capacity | number | áno | |
encoding | one of: gsm, ucs2 | áno | |
createdAt | string | áno | |
updatedAt | string | áno | |
name | string | áno | |
body | string | áno | |
stripDiacritics | boolean | áno | Odeslat bez diakritiky: the text goes without accents (GSM 7-bit). |
SmsTemplateInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
body | string | áno | |
stripDiacritics | boolean | áno | Odeslat bez diakritiky: the text goes without accents (GSM 7-bit). |
SpamCheck
POST /content/spam-check: Poštárna's own antispam rules (SmartEmailing's "Antispamová kontrola: X / 5").
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
score | number | áno | |
verdict | one of: ok, spam, blocked | áno | |
sizeKb | number | áno | |
rules | array of object | áno | found = what the rule found in the content (phrases, hosts, domains, HTML tags), at most 5. |
StockPhoto
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
pageUrl | string | áno | |
tags | string | áno | |
type | string | áno | |
previewUrl | string | áno | |
previewWidth | number | áno | |
previewHeight | number | áno | |
webformatUrl | string | áno | |
webformatWidth | number | áno | |
webformatHeight | number | áno | |
largeImageUrl | string | áno | |
imageWidth | number | áno | |
imageHeight | number | áno | |
views | number | áno | |
downloads | number | áno | |
likes | number | áno | |
user | string | áno | |
userUrl | string | áno |
StockPhotoSaved
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
file | StoredFile | áno | |
photo | object | áno | |
existing | boolean | áno |
StockResult
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
total | number | áno | |
totalHits | number | áno | |
page | number | áno | |
perPage | number | áno | |
hits | array of StockPhoto | áno | |
source | string | áno | |
sourceUrl | string | áno |
StockStatus
Fotobanka of the image library (Pixabay through Poštárna's server, one platform key).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
configured | boolean | áno | |
source | string | áno | |
sourceUrl | string | áno |
StoredFile
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
folderId | string or null | áno | |
contentType | string | áno | |
size | number | áno | |
width | number or null | áno | Pictures only. |
height | number or null | áno | |
url | string | áno | Stable public address on the link domain: renaming or moving the file keeps it. |
createdAt | string | áno | |
pickedAt | string or null | nie | Last time the editor chose it (Zvolit obrázek); null = never. |
source | FileSource or null | nie | Where a picture of the photo bank comes from (Pixabay, its page and author); null for own files. |
StoredFileDetail
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
usage | object | áno | Templates and draft campaigns whose content names the address (shown before a delete). |
id | string | áno | |
name | string | áno | |
folderId | string or null | áno | |
contentType | string | áno | |
size | number | áno | |
width | number or null | áno | Pictures only. |
height | number or null | áno | |
url | string | áno | Stable public address on the link domain: renaming or moving the file keeps it. |
createdAt | string | áno | |
pickedAt | string or null | nie | Last time the editor chose it (Zvolit obrázek); null = never. |
source | FileSource or null | nie | Where a picture of the photo bank comes from (Pixabay, its page and author); null for own files. |
Survey
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
active | boolean | áno | An inactive survey answers 404. |
url | string | áno | Anonymous public page. |
linkTag | string | áno | {{surveylink_<id>}}: each recipient's own link in an e-mail. |
questions | number | áno | |
responses | number | nie | |
createdAt | string | áno | |
updatedAt | string | áno | |
title | string | áno | |
intro | string | áno | |
pages | array of SurveyPage | áno | |
thanksHtml | string | áno | |
afterUrl | string | áno | Address after the last page instead of the thank-you text. |
oneResponse | boolean | áno | One contact answers once (the recipient's link). |
SurveyPage
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
questions | array of SurveyQuestion | áno |
SurveyQuestion
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | 'q' + digits, stable: the answers are kept under it. |
type | one of: number, date, short_text, long_text, single, multiple, dropdown, scale, stars | áno | |
label | string | áno | |
help | string | áno | |
required | boolean | áno | |
options | array of string | nie | single, multiple, dropdown. |
min | number or null | nie | scale (0 or 1 to 3..10), stars (1 to 5), number (optional range). |
max | number or null | nie | |
minLabel | string | nie | |
maxLabel | string | nie |
SurveyResponse
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
contactId | string or null | áno | |
email | string | áno | |
answers | map of string or number or array of string | áno | |
submittedAt | string | áno |
SurveyResults
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
total | number | áno | |
questions | array of object | áno |
SurveySummary
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
active | boolean | áno | |
url | string | áno | Anonymous public page. |
linkTag | string | áno | {{surveylink_<id>}}: each recipient's own link in an e-mail. |
questions | number | áno | |
responses | number | nie | |
createdAt | string | áno | |
updatedAt | string | áno |
TemplateActiveUses
SE "Kryjeme vám záda": active automations (and their e-mails) sending the template, running campaigns made of it.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
automations | number | áno | |
emails | number | áno | |
campaigns | number | áno |
TemplateCheck
Result of the content check stored with every save (server rules with the tenant's).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
errors | array of one of: subject_missing, subject_too_long, content_empty, unknown_tag, foreign_tag, script_tag, script_error, unsupported_filter, bad_fallback, emoji, forbidden_word, image_placeholder, image_data_uri, banned_host, html_too_large, no_unsubscribe, footer_incomplete, subject_long, img_without_alt, insecure_image, image_too_large, image_foreign_host, text_image_ratio | áno | |
warnings | array of one of: subject_missing, subject_too_long, content_empty, unknown_tag, foreign_tag, script_tag, script_error, unsupported_filter, bad_fallback, emoji, forbidden_word, image_placeholder, image_data_uri, banned_host, html_too_large, no_unsubscribe, footer_incomplete, subject_long, img_without_alt, insecure_image, image_too_large, image_foreign_host, text_image_ratio | áno | |
checkedAt | string or null | áno |
TemplateDetail
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
content | EmailContent | áno | What the editor opens: the draft of a template in use, else the published content. |
settings | TemplateSettings | áno | |
draft | object | áno | A template that active automations send keeps its published content; the editor saves a draft until it is published with the password (POST /templates/{id}/publish) or thrown away (DELETE /templates/{id}/draft). |
activeUses | TemplateActiveUses | áno | |
publicUrl | string | áno | Veřejný náhled: a public page with the content (merge tags unfilled). |
id | string | áno | |
name | string | áno | |
subject | string | áno | |
preheader | string | áno | |
editor | one of: visual, html | áno | |
createdAt | string | áno | |
updatedAt | string | áno | |
tags | array of string | áno | |
size | number | áno | Size of the HTML in bytes (Gmail clips messages over 102 kB). |
archived | boolean | áno | Archived templates are not offered for new campaigns; they can be duplicated or restored. |
archivedAt | string or null | áno | |
readOnly | boolean | áno | Archive copy of an imported SmartEmailing original: content, name and tags never change, no delete or restore. |
usage | object | áno | Campaigns made from the template and e-mail nodes of automations naming it. |
lastUsedAt | string or null | áno | Newest such campaign or automation e-mail. |
check | TemplateCheck | áno |
TemplateInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | áno | |
subject | string | áno | |
preheader | string | áno | |
tags | array of string | nie | |
content | object | áno | A copy of a design: a starter, a campaign or another template. |
TemplatePatch
PATCH /templates/{id}: name, subject, preheader, tags and the e-mail settings (any of them).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | nie | |
tags | array of string | nie | |
subject | string | nie | |
preheader | string | nie | |
linkParams | array of CampaignLinkParam | nie | Google Analytics parameters added to links of the e-shop (as a campaign's linkParams). |
headers | array of CampaignHeader | nie | Own e-mail headers (X-...). |
unsubscribePageId | string or null | nie | Null = the default unsubscribe page. |
footerId | string or null | nie | Null = the default footer of the editor. |
TemplatePublishInput
object
TemplateSettings
Nastavení e-mailu of a template (migration 0231): Data a statistiky, the unsubscribe page and the footer.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
linkParams | array of CampaignLinkParam | áno | Google Analytics parameters added to links of the e-shop (as a campaign's linkParams). |
headers | array of CampaignHeader | áno | Own e-mail headers (X-...). |
unsubscribePageId | string or null | áno | Null = the default unsubscribe page. |
footerId | string or null | áno | Null = the default footer of the editor. |
TemplateSummary
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
name | string | áno | |
subject | string | áno | |
preheader | string | áno | |
editor | one of: visual, html | áno | |
createdAt | string | áno | |
updatedAt | string | áno | |
tags | array of string | áno | |
size | number | áno | Size of the HTML in bytes (Gmail clips messages over 102 kB). |
archived | boolean | áno | Archived templates are not offered for new campaigns; they can be duplicated or restored. |
archivedAt | string or null | áno | |
readOnly | boolean | áno | Archive copy of an imported SmartEmailing original: content, name and tags never change, no delete or restore. |
usage | object | áno | Campaigns made from the template and e-mail nodes of automations naming it. |
lastUsedAt | string or null | áno | Newest such campaign or automation e-mail. |
check | TemplateCheck | áno |
TestSendResult
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
to | string | áno | |
sentAt | string | áno |
UnsubscribePage
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | áno | |
isDefault | boolean | áno | Serves every unsubscribe link of the tenant (Poštárna; without one the standard page). |
createdAt | string | áno | |
updatedAt | string | áno | |
name | string | áno | |
active | boolean | áno | Active pages may be the default; an active page cannot be deleted. |
mode | one of: page, redirect | áno | page = Zobrazit odhlašovací stránku; redirect = skip it, unsubscribe and go to redirectUrl. |
redirectUrl | string | áno | |
logoUrl | string | áno | |
videoUrl | string | áno | YouTube only. |
language | one of: cs, sk, auto, en, pl, de, hu, it, ro, uk | áno | |
customHtml | string | áno | |
questionEnabled | boolean | áno | |
question | string | áno | |
answers | array of string | áno | |
afterUrl | string | áno | Přesměrování po odhlášení ('' = the thank-you page); merge tags of the contact allowed. |
VideoThumbnail
POST .../files/video-thumbnail: the preview picture of a YouTube or Vimeo video, kept in the file manager.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
file | StoredFile | áno | |
provider | one of: youtube, vimeo | áno | |
videoId | string | áno | |
videoUrl | string | áno | |
title | string | áno |