List Node Flows
List the workspace's node flows, paginated, without the graph body.
Returns summaries only. To read nodes and edges, use Get Node Flow. To see the companion call flow IDs, use Get Node Flow too, or List Call Flows and read nodeGraphId on flows with promptType of nodes.
Headers
x-workspace-idstringrequiredWorkspace identifier for the API.
Query Parameters
pagenumberdefault: 1Page number.
limitnumberdefault: 25Items per page.
statusstringOnly return graphs with this status. Leave it out to return all of them.
Results are sorted by updatedAt, newest first.
Errors
| Status | Body | When |
|---|---|---|
400 | {"code": "WORKSPACE_ID_REQUIRED"} | No x-workspace-id |
500 | {"code": "NODE_GRAPH_LIST_FAILED"} | Unexpected server error |
Response Fields
docsarrayThe graphs on this page. Each is the graph document without nodes, edges, draftData, compiled, versions and dataSources. It keeps _id, name, description, status, startNodeId, variables, globals, router, hasDraft, lastDraftSavedAt, publishedAt, publishedVersion, stats, createdAt and updatedAt.
totalDocsnumberTotal graphs matching the query.
limitnumberPage size.
pagenumberCurrent page.
totalPagesnumberNumber of pages.
The response also includes the usual paging fields: pagingCounter, hasPrevPage, hasNextPage, prevPage and nextPage.
curl -X GET "https://api.trillet.ai/v2/api/node-graphs?status=active&limit=10" \
-H "x-api-key: YOUR_API_KEY" \
-H "x-workspace-id: YOUR_WORKSPACE_ID"{
"docs": [
{
"_id": "a1a1a1a1a1a1a1a1a1a1a1a1",
"workspaceId": "c1c1c1c1c1c1c1c1c1c1c1c1",
"name": "Front desk",
"description": "",
"status": "active",
"startNodeId": "start",
"variables": [],
"hasDraft": false,
"publishedVersion": 3,
"publishedAt": "2025-01-05T09:30:00Z",
"createdAt": "2025-01-03T11:00:00Z",
"updatedAt": "2025-01-05T09:30:00Z"
}
],
"totalDocs": 1,
"limit": 10,
"page": 1,
"totalPages": 1,
"pagingCounter": 1,
"hasPrevPage": false,
"hasNextPage": false,
"prevPage": null,
"nextPage": null
}Last updated on