List Workflow Versions

List every version of a workflow.

Versions are immutable. Each row captures what the workflow looked like between updates: graph topology, metadata, and timestamps. Returns newest-first by default. Cursor pagination via startingAfter / endingBefore over versionNum.

Authorization

API Key

x-api-key<token>

Authenticate using API Key in request header

In: header

Path Parameters

workflowName*string

Query Parameters

limit?integer

Default50

Range1 <= value <= 100

sortOrder?string

Default"asc"

Value in"asc" | "desc"

startingAfter?integer

endingBefore?integer

Response Body

`application/json`

curl -X GET "https://api.bem.ai/v3/workflows/string/versions"

{
  "versions": [
    {
      "id": "string",
      "name": "string",
      "versionNum": 0,
      "displayName": "string",
      "emailAddress": "string",
      "tags": [
        "string"
      ],
      "mainNodeName": "string",
      "nodes": [
        {
          "name": "string",
          "function": {
            "id": "string",
            "name": "string",
            "versionNum": 0
          },
          "metadata": {}
        }
      ],
      "edges": [
        {
          "sourceNodeName": "string",
          "destinationName": "string",
          "destinationNodeName": "string",
          "metadata": {}
        }
      ],
      "connectors": [
        {
          "connectorID": "string",
          "name": "string",
          "type": "paragon",
          "paragon": {
            "integration": "string",
            "configuration": {},
            "syncID": "string"
          }
        }
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "audit": {
        "workflowCreatedBy": {
          "userActionID": "string",
          "userID": "string",
          "userEmail": "string",
          "apiKeyName": "string",
          "emailAddress": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        },
        "workflowLastUpdatedBy": {
          "userActionID": "string",
          "userID": "string",
          "userEmail": "string",
          "apiKeyName": "string",
          "emailAddress": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        },
        "versionCreatedBy": {
          "userActionID": "string",
          "userID": "string",
          "userEmail": "string",
          "apiKeyName": "string",
          "emailAddress": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        }
      }
    }
  ],
  "totalCount": 0,
  "error": "string"
}