> 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-workflows-get-all.md).

# List Workflows (Get All)

Get a paginated list of workflows in your workspace, with optional filtering by name.

The **200** body includes `paginationInfo` (`perPage`, `totalPage`, `currentPage`, `totalRecord`) and `data`: an array of **summary** rows (`id`, `name`, `description`, `version`, `status`, `staticUrl`, `checksum`, timestamps, `isLive`). This is **not** the full workflow graph — use **Get workflow by id** for `nodes`, `edges`, `trigger`, `settings`, etc.

## List workflows

> Get a paginated list of workflows in your workspace with optional filtering by name.\
> \
> \*\*Response shape:\*\*\
> \- \`paginationInfo\` — \`perPage\`, \`totalPage\`, \`currentPage\`, \`totalRecord\`\
> \- \`data\` — array of \*\*summary\*\* rows only (\`id\`, \`name\`, \`description\`, \`version\`, \`status\`, \`staticUrl\`, \`checksum\`, timestamps, \`isLive\`). Not the full graph — call \*\*Get workflow by id\*\* for \`nodes\`, \`edges\`, \`trigger\`, \`settings\`, etc.\
> \
> \*\*Canonical response file:\*\* \`Get/GET\_ALL.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":{"ListWorkflowsResponse":{"type":"object","description":"Success response for GET /dev/v1/workflow","properties":{"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"},"data":{"type":"array","items":{"$ref":"#/components/schemas/WorkflowListItem"}},"code":{"type":"string"},"message":{"type":"string"}}},"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"}}},"WorkflowListItem":{"type":"object","description":"Summary row returned by the list endpoint (not the full graph)","properties":{"id":{"type":"string","description":"Workflow entity ID"},"name":{"type":"string"},"description":{"type":"string"},"version":{"type":"string","description":"e.g. `draft` or a published version label"},"status":{"type":"string","description":"e.g. `draft`, `published`"},"staticUrl":{"type":"string","format":"uri","description":"Static URL for this workflow in the Nected console"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string"},"publishedAt":{"type":"string","nullable":true},"testedAt":{"type":"string","nullable":true},"checksum":{"type":"string","description":"Current checksum — use for update/test/publish"},"isLive":{"type":"boolean","description":"Whether the published version is currently live"}}},"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":{"get":{"operationId":"listWorkflows","tags":["Workflow"],"summary":"List workflows","description":"Get a paginated list of workflows in your workspace with optional filtering by name.\n\n**Response shape:**\n- `paginationInfo` — `perPage`, `totalPage`, `currentPage`, `totalRecord`\n- `data` — array of **summary** rows only (`id`, `name`, `description`, `version`, `status`, `staticUrl`, `checksum`, timestamps, `isLive`). Not the full graph — call **Get workflow by id** for `nodes`, `edges`, `trigger`, `settings`, etc.\n\n**Canonical response file:** `Get/GET_ALL.json`","parameters":[{"name":"Nected-Branch","in":"header","required":false,"description":"Branch name (optional)","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"},{"name":"name","in":"query","schema":{"type":"string"},"description":"Filter / search by workflow name"}],"responses":{"200":{"description":"OK — `paginationInfo` + summary `data` rows.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListWorkflowsResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

### Example response (full JSON)

Use the API reference below to try the endpoint.

{% file src="/files/IJH7HIPMrTk0q50iboce" %}