List published versions by id

List all published versions of a workflow for the given entity ID. Results are paginated.

The data array contains version metadata rows (id, version, title, description, publishedAt, checksum) — not the full workflow graph.

List published versions

get

List all published versions of a workflow in reverse chronological order (most recent first). Results are paginated.

Each item in data includes: id, version, title, description, publishedAt, checksum.

To retrieve the full graph for a specific version, call GET /dev/v1/workflow/{entity-id}?version=v1.

Canonical response file: examples/list_versions_200.json

Authorizations

DevAuth

Nected-API-KeystringRequired

Your Nected API key. Obtain from your workspace settings.

Path parameters

entity-idstringRequired

The workflow entity ID

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Query parameters

pageNointegerOptional

Page number (1-based)

Default: 1

pageSizeintegerOptional

Items per page

Default: 10

Header parameters

Nected-BranchstringOptional

Branch name (optional)

Responses

200

OK — list of published versions.

application/json

Standard API response wrapper

codestringOptional

dataanyOptional

Response payload — shape varies by endpoint

messagestringOptional

pageNointegerOptional

pageSizeintegerOptional

totalCountintegerOptional

totalPagesintegerOptional

400

Bad Request

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/dev/v1/workflow/{entity-id}/version

HTTPcURLJavaScriptPython

GET /dev/v1/workflow/{entity-id}/version HTTP/1.1
Host: api.nected.ai
Nected-API-Key: YOUR_API_KEY
Accept: */*

{
  "paginationInfo": {
    "perPage": 10,
    "totalPage": 1,
    "currentPage": 1,
    "totalRecord": 2
  },
  "data": [
    {
      "id": "ver_001",
      "version": "v2",
      "title": "Platinum tier added",
      "description": "Added platinum tier at 20% discount.",
      "publishedAt": "2026-05-31T10:00:00.000Z",
      "checksum": "4e8b1f2a9d3c7e0b5a6f2d9c1e4b8a3f"
    },
    {
      "id": "ver_000",
      "version": "v1",
      "title": "Initial release",
      "description": "Gold/silver/standard discount tiers.",
      "publishedAt": "2026-03-01T08:00:00.000Z",
      "checksum": "7f3d2a1b9c8e4f6a0d5b2c7e1a9f3d8c"
    }
  ],
  "code": "success",
  "message": "Success."
}