Workflows

List of available workflow template versions

Returns the full version history of the workflow template, sorted by createdAt descending by default.

Each item includes isActive to identify the current active version, and secretsChanged to indicate versions where a secret parameter's value was rewritten.

get/v1/workflow-templates/{id}/versions

Request

  • Base URL
    https://api.emma.ms/external
  • Auth
    HTTP bearer

Path parameters

idinteger required

ID of the workflow template

Response

Successful operation

activeVersionIdinteger nullable

ID of the currently active version of the workflow template — the version used when creating instances from this workflow. A template that has any version has exactly one active version.

null when the template has no versions at all, and content is then an empty array. This is the permanent state of built-in default templates (isDefault = true): they are excluded from versioning and cannot be edited, so a version is never created for them. It is also the state of templates created before versioning was enabled and not yet covered by the one-off backfill.

Example response

{
  "activeVersionId": 123,
  "content": [
    {
      "id": 123,
      "name": "v1",
      "createdAt": "2026-11-26T14:54:11",
      "createdById": 543,
      "createdByName": "Automation User",
      "sequenceNumber": 7,
      "restoredFrom": 123,
      "restoredFromName": "v11"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.