workflows

Embed

<a href="https://hermeticor.com/docs/ref-workflows"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/27c987c7-83e1-4744-b0ce-54b59acc4526/social-card.svg?v=3e7ae33eec8b" alt="workflows" width="600" height="315"></a>

GEThttps://hermeticor.com/v1/workflows/{id}/ab/report

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/workflows/{id}/ab/report" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "variants": [
    {
      "versionId": "string",
      "n": 0,
      "weight": 0,
      "entered": 0,
      "completed": 0,
      "converted": 0,
      "conversionRate": 0
    }
  ]
}

Schema

variantsobject[]required

Show child parameters

versionIdstringrequired

nintegerrequired

weightintegerrequired

enteredintegerrequired

completedintegerrequired

convertedintegerrequired

conversionRatenumberrequired

4XX Default Response

Example

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

POSThttps://hermeticor.com/v1/workflows/{id}/ab/promote

Parameters

idstringpathrequired

Request body

application/json

versionIdstringrequired

{
  "versionId": "string"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/workflows/{id}/ab/promote" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"versionId":"string"}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "id": "string",
  "name": "string",
  "purpose": "marketing",
  "mode": "journey",
  "status": "draft",
  "publishedVersionId": "string",
  "folder": "string",
  "tags": [
    "string"
  ],
  "color": "string",
  "draftGraph": {},
  "draftTriggers": {},
  "draftSettings": {},
  "ab": {
    "variants": [
      {
        "versionId": "string",
        "weight": 0
      }
    ],
    "startedAt": "2024-01-01T00:00:00Z"
  },
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z"
}

Schema

idstringrequired

namestringrequired

purposestringrequired

marketing | prospecting | transactional | operational

modestringrequired

journey | sequence

statusstringrequired

draft | live | paused | archived

publishedVersionIdstringrequired

folderstringrequired

tagsstring[]required

colorstring

draftGraphrequired

draftTriggersrequired

draftSettingsrequired

abobject

Show child parameters

variantsVariantsItem3[]required

Show child parameters

versionIdstringrequired

weightintegerrequired

startedAtstringrequired

createdAtstringrequired

updatedAtstringrequired

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

POSThttps://hermeticor.com/v1/workflows/{id}/pause

Parameters

idstringpathrequired

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/workflows/{id}/pause" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · POST /v1/workflows/{id}/ab/promote

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

POSThttps://hermeticor.com/v1/workflows/{id}/resume

Parameters

idstringpathrequired

Request body

application/json

policystring

run_now | skip_missed_sends = run_now

{
  "policy": "run_now"
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/workflows/{id}/resume" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"policy":"run_now"}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · POST /v1/workflows/{id}/ab/promote

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

POSThttps://hermeticor.com/v1/workflows/{id}/archive

Parameters

idstringpathrequired

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/workflows/{id}/archive" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · POST /v1/workflows/{id}/ab/promote

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

POSThttps://hermeticor.com/v1/workflows/{id}/clone

Parameters

idstringpathrequired

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/workflows/{id}/clone" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Same as 200 · POST /v1/workflows/{id}/ab/promote

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

GEThttps://hermeticor.com/v1/workflows/{id}/export

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/workflows/{id}/export" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "name": "string",
  "purpose": "marketing",
  "mode": "journey",
  "definition": {
    "graph": {
      "start": null,
      "nodes": [
        {
          "id": "string",
          "type": "send_email",
          "config": {
            "templateId": "string",
            "versionId": "string",
            "route": {
              "connectionId": "string",
              "poolId": "string",
              "routePolicyId": "string"
            },
            "topicId": "string",
            "replyToStep": "string",
            "onBlocked": "continue",
            "skipOnFailure": true,
            "skipIfMessagedWithinHours": 0,
            "filter": {
              "type": "group",
              "op": "and",
              "negate": true,
              "children": [
                {}
              ]
            },
            "retries": 0,
            "senderIdentityId": "string",
            "replyTo": "string",
            "oneClickUnsubscribe": true
          },
          "position": {
            "x": 0,
            "y": 0
          },
          "name": "string"
        }
      ],
      "edges": [
        {
          "id": "string",
          "source": "string",
          "sourceHandle": "string",
          "target": "string"
        }
      ]
    },
    "triggers": [
      {
        "type": "profile_created",
        "reentry": {
          "mode": "after_completion"
        }
      }
    ],
    "settings": {
      "purpose": "marketing",
      "mode": "journey",
      "filterCheck": "before_send",
      "filterFailAction": "exit",
      "profileFilter": {
        "type": "group",
        "op": "and",
        "negate": true,
        "children": [
          {}
        ]
      },
      "goal": {
        "kind": "event",
        "eventName": "string",
        "filter": {},
        "definition": {
          "type": "group",
          "op": "and",
          "negate": true,
          "children": [
            {}
          ]
        },
        "windowDays": 30,
        "onReach": "exit"
      },
      "quietHours": "inherit",
      "quietHoursAction": "wait",
      "sendWindow": {
        "startMin": 0,
        "endMin": 0,
        "weekdays": [
          0
        ]
      },
      "smartSending": {
        "skipIfMessagedWithinHours": 0,
        "frequencyCap": {
          "maxSends": 0,
          "windowHours": 0
        }
      },
      "enrollmentCap": {
        "maxTotal": 0,
        "maxConcurrent": 0
      },
      "activeWindow": {
        "from": "2024-01-01T00:00:00Z",
        "until": "2024-01-01T00:00:00Z"
      },
      "failureAlert": {
        "userIds": [],
        "emails": []
      },
      "timezoneSource": "profile",
      "timezone": "UTC",
      "exitOn": {
        "type": "group",
        "op": "and",
        "negate": true,
        "children": [
          {}
        ]
      },
      "sequence": {
        "steps": [],
        "schedule": {
          "weekdays": [
            1,
            2,
            3,
            4,
            5
          ],
          "startMin": 540,
          "endMin": 1020,
          "timezoneSource": "prospect",
          "timezone": "UTC"
        },
        "mailbox": {
          "sticky": true,
          "onUnavailable": "pause"
        },
        "dailyNewLimit": 0,
        "followUpPercent": 0,
        "plainTextOnly": true,
        "trackOpens": true,
        "unsubscribeText": "string",
        "spintaxMode": "random",
        "variables": {},
        "blocklist": {
          "emails": [],
          "domains": []
        },
        "reviewBeforeSend": true,
        "reviewEachMessage": true,
        "stop": {
          "onReply": "human",
          "onAutoReply": "continue",
          "onOoo": "pause_until_return",
          "onCompanyReply": "none"
        },
        "onCategory": [
          {
            "category": "positive",
            "sequenceId": "string",
            "stopCurrent": true
          }
        ],
        "ownerUserId": "string",
        "scheduleId": "string",
        "dedupe": {
          "crossSequence": "skip",
          "contactedWithinDays": 0,
          "domain": false
        },
        "startAt": "2024-01-01T00:00:00Z",
        "minGapMinutes": 0,
        "senderOverrides": {},
        "abm": {
          "maxPerAccount": 5,
          "onAccountReply": "stop"
        }
      }
    }
  }
}

Schema

namestringrequired

purposestringrequired

marketing | prospecting | transactional | operational

modestringrequired

journey | sequence

definitionobjectrequired

Show child parameters

graphobjectrequired

Show child parameters

startstringrequired

= null

nodesNodesItem2[]required

edgesEdgesItem2[]required

triggersTriggersItem2[]required

settingsobjectrequired

Show child parameters

purposestringrequired

marketing | prospecting | transactional | operational = marketing

modestringrequired

journey | sequence = journey

filterCheckstringrequired

entry | every_step | before_send = before_send

filterFailActionstringrequired

exit | skip = exit

profileFilterobject

goalobject

quietHoursstring | Windowrequired

= inherit

quietHoursActionstring

wait | skip | exit

sendWindowobject

smartSendingobject

enrollmentCapobject

activeWindowobject

failureAlertobject

timezoneSourcestringrequired

profile | workspace = profile

timezonestringrequired

= UTC

exitOnobject

sequenceobject

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

GEThttps://hermeticor.com/v1/workflows/{id}/versions

Parameters

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/workflows/{id}/versions" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "workflowId": "string",
      "n": 0,
      "graph": {},
      "trigger": {},
      "settings": {},
      "checksum": "string",
      "publishedAt": "2024-01-01T00:00:00Z",
      "publishedBy": "string"
    }
  ],
  "nextCursor": "string"
}

Schema

itemsVersion2[]required

Show child parameters

idstringrequired

workflowIdstringrequired

nintegerrequired

graphrequired

triggerrequired

settingsrequired

checksumstringrequired

publishedAtstringrequired

publishedBystringrequired

nextCursorstringrequired

4XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

5XX Default Response

Same as 4XX · GET /v1/workflows/{id}/ab/report

Next part

Updated Nov 8, 2026

Was this page helpful?