> For the complete documentation index, see [llms.txt](https://docs.nected.ai/nected-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nected.ai/nected-docs/management-api/workflow/list-published-versions-by-id.md).

# 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

> 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\`

```json
{"openapi":"3.0.3","info":{"title":"Nected Workflow API (Dev V1)","version":"1.0"},"tags":[{"name":"Workflow","description":"List, create, read, update, test, and publish workflows."}],"servers":[{"url":"https://api.nected.ai","description":"Production"}],"security":[{"DevAuth":[]}],"components":{"securitySchemes":{"DevAuth":{"type":"apiKey","in":"header","name":"Nected-API-Key","description":"Your Nected API key. Obtain from your workspace settings."}},"schemas":{"Response":{"type":"object","description":"Standard API response wrapper","properties":{"code":{"type":"string"},"data":{"description":"Response payload — shape varies by endpoint"},"message":{"type":"string"},"pageNo":{"type":"integer"},"pageSize":{"type":"integer"},"totalCount":{"type":"integer"},"totalPages":{"type":"integer"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}},"PaginationInfo":{"type":"object","description":"Pagination metadata returned on list endpoints","properties":{"perPage":{"type":"integer","description":"Items per page"},"totalPage":{"type":"integer","description":"Total number of pages"},"currentPage":{"type":"integer","description":"Current page number (1-based)"},"totalRecord":{"type":"integer","description":"Total number of records across all pages"}}},"ErrorResponse":{"type":"object","description":"Error response wrapper","properties":{"code":{"type":"string"},"message":{"type":"string","description":"Human-readable error message"},"data":{"nullable":true}}}}},"paths":{"/dev/v1/workflow/{entity-id}/version":{"get":{"operationId":"listWorkflowVersions","tags":["Workflow"],"summary":"List published versions","description":"List all published versions of a workflow in reverse chronological order (most recent first). Results are paginated.\n\nEach item in `data` includes: `id`, `version`, `title`, `description`, `publishedAt`, `checksum`.\n\nTo retrieve the **full graph** for a specific version, call `GET /dev/v1/workflow/{entity-id}?version=v1`.\n\n**Canonical response file:** `examples/list_versions_200.json`","parameters":[{"name":"Nected-Branch","in":"header","required":false,"description":"Branch name (optional)","schema":{"type":"string"}},{"name":"entity-id","in":"path","required":true,"description":"The workflow entity ID","schema":{"type":"string"}},{"name":"pageNo","in":"query","schema":{"type":"integer","default":1},"description":"Page number (1-based)"},{"name":"pageSize","in":"query","schema":{"type":"integer","default":10},"description":"Items per page"}],"responses":{"200":{"description":"OK — list of published versions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```