curl --request GET \ --url 'https://app.output.rocks/api/spa/mail-server-configurations?page=1&itemsPerPage=20&order%5Bid%5D=asc&order%5Bidentifier%5D=asc&order%5Bsender%5D=asc&order%5BactiveFrom%5D=asc&order%5Bactive%5D=asc&order%5BcreatedAt%5D=asc&order%5BupdatedAt%5D=asc' \ --header 'X-AUTH-TOKEN: <api-key>'

[ { "id": 123, "identifier": "string", "dsn": "string", "sender": "string", "headers": [ "string" ], "emailProcesses": [ { "id": 123, "description": "", "sender": "string", "emailTo": "user@example.com", "cc": "string", "bcc": "string", "fromName": "Example name", "replyTo": "string", "subject": "string", "body": "string", "text": "string", "metadata": [ "string" ], "externalId": "string", "externalState": "string", "messageId": "string", "fileName": "", "docPath": "string", "sendStatus": "string", "customId": "string", "template": "https://example.com/", "renderData": "https://example.com/", "webhooks": [ { "id": null, "identifier": null, "email": null, "type": null, "priority": null, "data": null, "configuration": null, "createdBy": null, "updatedBy": null, "createdAt": null, "updatedAt": null, "client": null, "subClient": null, "active": null, "activeFrom": null, "versionGroup": null, "versionNumber": null, "supersededAt": null, "changeSummaryDe": null, "changeSummaryEn": null, "summaryStatus": null, "groupIdentifier": null, "groupCondition": null, "subClientDefault": null, "subClientId": null, "subClientDescription": null, "subClientColor": null } ], "mailServerConfiguration": "https://example.com/", "renderingRequest": "https://example.com/", "renderProcesses": [ { "id": null, "format": null, "type": null, "description": null, "fileName": null, "billablePages": null, "documentPages": null, "maxPageViolation": null, "docPath": null, "metadata": null, "billed": null, "externalId": null, "externalState": null, "customId": null, "template": null, "brandIdentifier": null, "brandVersionNumber": null, "brandLayoutPath": null, "renderStartedAt": null, "renderDurationMs": null, "renderData": null, "webhooks": null, "emailProcess": null, "xmlProcess": null, "renderingRequest": null, "failedDataValidators": null, "file": null, "createdBy": null, "updatedBy": null, "createdAt": null, "updatedAt": null, "client": null, "subClient": null, "state": null, "workflowLog": null, "blocked": null, "wfData": null, "batchAction": null, "doneAt": null, "anonymization": null, "anonymized": null, "reviewRequired": null, "reviewedBy": null, "reviewedAt": null, "prefix": null, "eInvoice": null, "renderingRequestOrNull": null, "subClientId": null, "subClientDescription": null, "subClientColor": null, "webhooksToExecute": null, "nextWebhookToExecute": null } ], "emailAttachments": [ { "id": null, "identifier": null, "description": null, "fileName": null, "path": null, "file": null, "createdBy": null, "updatedBy": null, "createdAt": null, "updatedAt": null, "client": null, "subClient": null, "brandIdentifier": null, "active": null, "activeFrom": null, "versionGroup": null, "versionNumber": null, "supersededAt": null, "changeSummaryDe": null, "changeSummaryEn": null, "summaryStatus": null, "groupIdentifier": null, "groupCondition": null, "validationCondition": null, "subClientDefault": null, "subClientId": null, "subClientDescription": null, "subClientColor": null } ], "emailNotification": { "id": null, "origin": null, "messageId": null, "type": null, "eventType": null, "emailProcess": null, "message": null, "metadata": null, "createdBy": null, "updatedBy": null, "createdAt": null, "updatedAt": null, "client": null, "subClient": null, "state": null, "workflowLog": null, "blocked": null, "wfData": null, "batchAction": null, "subClientId": null, "subClientDescription": null, "subClientColor": null }, "emailNotifications": [ { "id": null, "origin": null, "messageId": null, "type": null, "eventType": null, "emailProcess": null, "message": null, "metadata": null, "createdBy": null, "updatedBy": null, "createdAt": null, "updatedAt": null, "client": null, "subClient": null, "state": null, "workflowLog": null, "blocked": null, "wfData": null, "batchAction": null, "subClientId": null, "subClientDescription": null, "subClientColor": null } ], "failedDataValidators": [ { "id": null, "identifier": null, "description": null, "condition": null, "errorMessage": null, "invalidOnTrue": null, "templates": null, "emailTemplates": null, "createdBy": null, "updatedBy": null, "createdAt": null, "updatedAt": null, "client": null, "subClient": null, "active": null, "activeFrom": null, "versionGroup": null, "versionNumber": null, "supersededAt": null, "changeSummaryDe": null, "changeSummaryEn": null, "summaryStatus": null, "subClientDefault": null, "subClientId": null, "subClientDescription": null, "subClientColor": null } ], "client": {}, "subClient": {}, "createdBy": "user1@company.com", "updatedBy": "user1@company.com", "createdAt": "2024-08-23T00:00:00+00:00", "updatedAt": "2024-08-23T00:00:00+00:00", "state": "done", "workflowLog": "[2024-01-01 00:00:00] Rendering set to blocked because of paused Template", "blocked": false, "wfData": [ "string" ], "batchAction": "https://example.com/", "doneAt": "2024-08-23T00:00:00+00:00", "anonymization": "2024-08-23T00:00:00+00:00", "anonymized": false, "reviewRequired": false, "reviewedBy": "string", "reviewedAt": "2024-01-01T00:00:00Z", "prefix": "string", "renderingRequestOrNull": "https://example.com/", "subClientId": 3, "subClientDescription": "Branch Office A", "subClientColor": "#083E5D", "webhooksToExecute": true, "nextWebhookToExecute": "https://example.com/" } ], "client": {}, "subClient": {}, "createdBy": "user1@company.com", "updatedBy": "user1@company.com", "createdAt": "2024-08-23T00:00:00+00:00", "updatedAt": "2024-08-23T00:00:00+00:00", "active": true, "activeFrom": "2024-01-01", "versionGroup": "123e4567-e89b-12d3-a456-426614174000", "versionNumber": 1, "supersededAt": "2024-08-23T00:00:00+00:00", "changeSummaryDe": "string", "changeSummaryEn": "string", "summaryStatus": "pending", "subClientDefault": false, "subClientId": 3, "subClientDescription": "Branch Office A", "subClientColor": "#083E5D" } ]

SPA Mail Server Configurations

SPA: List mail server configurations

Returns a paginated list of mail server configurations for the authenticated client.

GET/api/spa/mail-server-configurations

SPA: List mail server configurations

curl --request GET \
  --url 'https://app.output.rocks/api/spa/mail-server-configurations?page=1&itemsPerPage=20&order%5Bid%5D=asc&order%5Bidentifier%5D=asc&order%5Bsender%5D=asc&order%5BactiveFrom%5D=asc&order%5Bactive%5D=asc&order%5BcreatedAt%5D=asc&order%5BupdatedAt%5D=asc' \
  --header 'X-AUTH-TOKEN: <api-key>'

200

application/json

[
  {
    "id": 123,
    "identifier": "string",
    "dsn": "string",
    "sender": "string",
    "headers": [
      "string"
    ],
    "emailProcesses": [
      {
        "id": 123,
        "description": "",
        "sender": "string",
        "emailTo": "user@example.com",
        "cc": "string",
        "bcc": "string",
        "fromName": "Example name",
        "replyTo": "string",
        "subject": "string",
        "body": "string",
        "text": "string",
        "metadata": [
          "string"
        ],
        "externalId": "string",
        "externalState": "string",
        "messageId": "string",
        "fileName": "",
        "docPath": "string",
        "sendStatus": "string",
        "customId": "string",
        "template": "https://example.com/",
        "renderData": "https://example.com/",
        "webhooks": [
          {
            "id": null,
            "identifier": null,
            "email": null,
            "type": null,
            "priority": null,
            "data": null,
            "configuration": null,
            "createdBy": null,
            "updatedBy": null,
            "createdAt": null,
            "updatedAt": null,
            "client": null,
            "subClient": null,
            "active": null,
            "activeFrom": null,
            "versionGroup": null,
            "versionNumber": null,
            "supersededAt": null,
            "changeSummaryDe": null,
            "changeSummaryEn": null,
            "summaryStatus": null,
            "groupIdentifier": null,
            "groupCondition": null,
            "subClientDefault": null,
            "subClientId": null,
            "subClientDescription": null,
            "subClientColor": null
          }
        ],
        "mailServerConfiguration": "https://example.com/",
        "renderingRequest": "https://example.com/",
        "renderProcesses": [
          {
            "id": null,
            "format": null,
            "type": null,
            "description": null,
            "fileName": null,
            "billablePages": null,
            "documentPages": null,
            "maxPageViolation": null,
            "docPath": null,
            "metadata": null,
            "billed": null,
            "externalId": null,
            "externalState": null,
            "customId": null,
            "template": null,
            "brandIdentifier": null,
            "brandVersionNumber": null,
            "brandLayoutPath": null,
            "renderStartedAt": null,
            "renderDurationMs": null,
            "renderData": null,
            "webhooks": null,
            "emailProcess": null,
            "xmlProcess": null,
            "renderingRequest": null,
            "failedDataValidators": null,
            "file": null,
            "createdBy": null,
            "updatedBy": null,
            "createdAt": null,
            "updatedAt": null,
            "client": null,
            "subClient": null,
            "state": null,
            "workflowLog": null,
            "blocked": null,
            "wfData": null,
            "batchAction": null,
            "doneAt": null,
            "anonymization": null,
            "anonymized": null,
            "reviewRequired": null,
            "reviewedBy": null,
            "reviewedAt": null,
            "prefix": null,
            "eInvoice": null,
            "renderingRequestOrNull": null,
            "subClientId": null,
            "subClientDescription": null,
            "subClientColor": null,
            "webhooksToExecute": null,
            "nextWebhookToExecute": null
          }
        ],
        "emailAttachments": [
          {
            "id": null,
            "identifier": null,
            "description": null,
            "fileName": null,
            "path": null,
            "file": null,
            "createdBy": null,
            "updatedBy": null,
            "createdAt": null,
            "updatedAt": null,
            "client": null,
            "subClient": null,
            "brandIdentifier": null,
            "active": null,
            "activeFrom": null,
            "versionGroup": null,
            "versionNumber": null,
            "supersededAt": null,
            "changeSummaryDe": null,
            "changeSummaryEn": null,
            "summaryStatus": null,
            "groupIdentifier": null,
            "groupCondition": null,
            "validationCondition": null,
            "subClientDefault": null,
            "subClientId": null,
            "subClientDescription": null,
            "subClientColor": null
          }
        ],
        "emailNotification": {
          "id": null,
          "origin": null,
          "messageId": null,
          "type": null,
          "eventType": null,
          "emailProcess": null,
          "message": null,
          "metadata": null,
          "createdBy": null,
          "updatedBy": null,
          "createdAt": null,
          "updatedAt": null,
          "client": null,
          "subClient": null,
          "state": null,
          "workflowLog": null,
          "blocked": null,
          "wfData": null,
          "batchAction": null,
          "subClientId": null,
          "subClientDescription": null,
          "subClientColor": null
        },
        "emailNotifications": [
          {
            "id": null,
            "origin": null,
            "messageId": null,
            "type": null,
            "eventType": null,
            "emailProcess": null,
            "message": null,
            "metadata": null,
            "createdBy": null,
            "updatedBy": null,
            "createdAt": null,
            "updatedAt": null,
            "client": null,
            "subClient": null,
            "state": null,
            "workflowLog": null,
            "blocked": null,
            "wfData": null,
            "batchAction": null,
            "subClientId": null,
            "subClientDescription": null,
            "subClientColor": null
          }
        ],
        "failedDataValidators": [
          {
            "id": null,
            "identifier": null,
            "description": null,
            "condition": null,
            "errorMessage": null,
            "invalidOnTrue": null,
            "templates": null,
            "emailTemplates": null,
            "createdBy": null,
            "updatedBy": null,
            "createdAt": null,
            "updatedAt": null,
            "client": null,
            "subClient": null,
            "active": null,
            "activeFrom": null,
            "versionGroup": null,
            "versionNumber": null,
            "supersededAt": null,
            "changeSummaryDe": null,
            "changeSummaryEn": null,
            "summaryStatus": null,
            "subClientDefault": null,
            "subClientId": null,
            "subClientDescription": null,
            "subClientColor": null
          }
        ],
        "client": {},
        "subClient": {},
        "createdBy": "user1@company.com",
        "updatedBy": "user1@company.com",
        "createdAt": "2024-08-23T00:00:00+00:00",
        "updatedAt": "2024-08-23T00:00:00+00:00",
        "state": "done",
        "workflowLog": "[2024-01-01 00:00:00] Rendering set to blocked because of paused Template",
        "blocked": false,
        "wfData": [
          "string"
        ],
        "batchAction": "https://example.com/",
        "doneAt": "2024-08-23T00:00:00+00:00",
        "anonymization": "2024-08-23T00:00:00+00:00",
        "anonymized": false,
        "reviewRequired": false,
        "reviewedBy": "string",
        "reviewedAt": "2024-01-01T00:00:00Z",
        "prefix": "string",
        "renderingRequestOrNull": "https://example.com/",
        "subClientId": 3,
        "subClientDescription": "Branch Office A",
        "subClientColor": "#083E5D",
        "webhooksToExecute": true,
        "nextWebhookToExecute": "https://example.com/"
      }
    ],
    "client": {},
    "subClient": {},
    "createdBy": "user1@company.com",
    "updatedBy": "user1@company.com",
    "createdAt": "2024-08-23T00:00:00+00:00",
    "updatedAt": "2024-08-23T00:00:00+00:00",
    "active": true,
    "activeFrom": "2024-01-01",
    "versionGroup": "123e4567-e89b-12d3-a456-426614174000",
    "versionNumber": 1,
    "supersededAt": "2024-08-23T00:00:00+00:00",
    "changeSummaryDe": "string",
    "changeSummaryEn": "string",
    "summaryStatus": "pending",
    "subClientDefault": false,
    "subClientId": 3,
    "subClientDescription": "Branch Office A",
    "subClientColor": "#083E5D"
  }
]

Authorizations

X-AUTH-TOKEN

stringheaderrequired

Value for the X-AUTH-TOKEN header parameter.

Query Parameters

page

integerdefault:1

The collection page number

itemsPerPage

integerdefault:20

The number of items per page

pagination

boolean

Enable or disable pagination

order[id]

stringdefault:asc

No description provided.

order[identifier]

stringdefault:asc

No description provided.

order[sender]

stringdefault:asc

No description provided.

order[activeFrom]

stringdefault:asc

No description provided.

order[active]

stringdefault:asc

No description provided.

order[createdAt]

stringdefault:asc

No description provided.

order[updatedAt]

stringdefault:asc

No description provided.

identifier

string

No description provided.

string

Search across multiple fields (id, identifier, dsn, sender, activeFrom, active, createdAt, updatedAt, subClient.description) using OR logic with partial matching.

active

boolean

No description provided.

activeFrom[before]

string

No description provided.

activeFrom[strictly_before]

string

No description provided.

activeFrom[after]

string

No description provided.

activeFrom[strictly_after]

string

No description provided.

Response

200application/json

MailServerConfiguration collection

integer

identifier

stringrequired

dsn

stringrequired

sender

string<email>required

headers

string | null[]required

emailProcesses

object[]

client

object

subClient

object

createdBy

string

User, created this entry

Example: "user1@company.com"

updatedBy

string

User, updated this entry

Example: "user1@company.com"

createdAt

string<date-time>

UTC date time of entry creation

Example: "2024-08-23T00:00:00+00:00"

updatedAt

string<date-time>

UTC date time of last entry update

Example: "2024-08-23T00:00:00+00:00"

active

boolean

Active flag. Default: true

Available options: truefalse

Example: true

activeFrom

string<date-time>

Date to activate the entry. Default: today

Example: "2024-01-01"

versionGroup

string<uuid>

Immutable lineage key shared by all versions of this configuration entry.

versionNumber

integer

Monotonic version counter within the version group. Display/audit only, not part of resolution.

Example: 1

supersededAt

string<date-time>

Moment from which this version is superseded by a newer version of the same version group. Null while the version is (or is scheduled to become) the current one.

changeSummaryDe

string

AI generated German summary of the changes introduced by this version.

changeSummaryEn

string

AI generated English summary of the changes introduced by this version.

summaryStatus

enum<string>

Generation status of the AI change summary.

Available options: pendingdonefailed

subClientDefault

boolean

Default for environmental tenants (sub-clients)

Available options: truefalse

Example: false

subClientId

integer

SubClient ID. Provided on instances with enabled sub-client module only.

Example: 3

subClientDescription

string

SubClient description. Provided on instances with enabled sub-client module only.

Example: "Branch Office A"

subClientColor

string

SubClient display colour. Provided on instances with enabled sub-client module only.

Example: "#083E5D"