Trillet AI logo

List Node Flows

List the workspace's node flows, paginated, without the graph body.

GEThttps://api.trillet.ai/v2/api/node-graphs

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-idstringrequired

Workspace identifier for the API.

Query Parameters

pagenumberdefault: 1

Page number.

limitnumberdefault: 25

Items per page.

statusstring

Only return graphs with this status. Leave it out to return all of them.

Results are sorted by updatedAt, newest first.

Errors

StatusBodyWhen
400{"code": "WORKSPACE_ID_REQUIRED"}No x-workspace-id
500{"code": "NODE_GRAPH_LIST_FAILED"}Unexpected server error

Response Fields

docsarray

The 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.

totalDocsnumber

Total graphs matching the query.

limitnumber

Page size.

pagenumber

Current page.

totalPagesnumber

Number 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