v1

latestOpenAPI 3.0.0Cognigy Proprietary License2026-07-2239524.1 MB
Nodes

Get Nodes

Gets Nodes from a Flow. By default, 25 Nodes are returned. Use the limit query parameter to change this value.

get/v2.0/flows/{flowId}/chart/nodes

Path parameters

flowIdstring required

The unique identifier for the Flow.

Query parameters

filterstring

The label or comment of the Node to filter the records.

limitinteger

The maximum number of items to return. Use this parameter to control page size. The default value is 25, and the maximum permitted value is 100.

skipinteger

The number of items to skip before returning the results. Use this parameter with limit for offset-based pagination. The default value is 0.

sortstring

The order in which results are returned. Set a sorting rule in the format field:direction, where direction can be asc for ascending order or desc for descending order. For example, name:asc sorts by name in ascending order.

nextstring

The cursor that points to the next page of results. Use the nextCursor value returned in a previous response to request the next set of items.

previousstring

The cursor that points to the previous page of results. Use the previousCursor value returned in a previous response to request the previous set of items.

preferredLocaleIdstring

The unique identifier for the Locale for the response.

Headers

Accept'application/json' | 'application/hal+json' | 'application/xml' | 'text/xml' | 'text/csv'

The Accept header specifies the media type that the client expects in the response. Available options: application/json, application/hal+json, application/xml, text/xml, text/csv. The default value is application/json.

Response

Returns array of Node Nodes

totalinteger
nextCursorstring nullable
previousCursorstring nullable

Example response

{
  "items": [
    {
      "type": "if",
      "extension": "@cognigy/basic-nodes",
      "label": "A new Node",
      "comment": "this is a very important node",
      "commentColor": "#ff8a80",
      "config": {
        "condition": {
          "type": "rule",
          "condition": "",
          "rule": {
            "left": "1",
            "operand": "gt",
            "right": "2"
          }
        }
      },
      "localeReference": "63bd8ebb648e6e739f1bbd82",
      "analyticsLabel": "condition",
      "mock": {
        "code": "console.log('Hello, world!');"
      }
    }
  ],
  "total": 1
}