Flowchart API

Generate a flowchart on a slide from a structured nodes and edges payload, and delete the shapes and connectors it creates.

Data Center:

⬇ Download OpenAPI Spec

POST Create Flowchart

POST https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart

Required Scopes:

ZohoShow.showdocslist.CREATE

Creates a flowchart on a slide from a structured node and edge graph. Use this endpoint to convert process data, decision trees, or workflow steps into connected shapes on a slide. The request body defines nodes, optional edges, layout direction, and optional title or depth hints. This endpoint only creates the flowchart objects; it does not provide flowchart-specific update or delete operations.

Path parameters

Name	Type	Required	Description
rid	string	Required	Resource id of the presentation. The caller must have the appropriate permission on this presentation.
slide_id	string	Required	Slide id in the presentation. The caller must have the appropriate permission on the presentation.

Request Body

Interactive structure. Expand fields and select optional schema parts.

Schema Catalog

Samples

Request Body

JSON

{
  "payload": {
    "nodes": [
      {
        "node_id": "start"
      },
      {
        "node_id": "end"
      }
    ],
    "edges": [
      {
        "from_node_id": "start",
        "to_node_id": "end"
      }
    ]
  }
}

Responses

200 Flowchart Created

400 Missing Flowchart Spec

400 Missing Nodes

400 Missing Node Id

{
  "data": {
    "nodes_created": "1",
    "connectors_created": "0",
    "inserted_shape_ids": [
      "f6d102d6-dbec-40fb-8191-836346d465cf"
    ],
    "slide_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70",
    "message": "Flowchart created"
  },
  "message": "Flowchart created successfully",
  "request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/54ca442b-63d1-43df-bda9-9f8cd2654e70/flowchart",
  "status": "success"
}

Code Examples

cURL

curl -X POST "https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart" \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "payload": {
    "nodes": [
      {
        "node_id": "start"
      },
      {
        "node_id": "end"
      }
    ],
    "edges": [
      {
        "from_node_id": "start",
        "to_node_id": "end"
      }
    ]
  }
}'

JavaScript

const response = await fetch('https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart', {
  method: 'POST',
  headers: {
    'Authorization': 'Zoho-oauthtoken YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "payload": {
    "nodes": [
      {
        "node_id": "start"
      },
      {
        "node_id": "end"
      }
    ],
    "edges": [
      {
        "from_node_id": "start",
        "to_node_id": "end"
      }
    ]
  }
})
});

const data = await response.json();
// Process the response data
return data;

Node.js

const https = require('https');
const url = require('url');

const options = {
  ...url.parse('https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart'),
  method: 'POST',
  headers: {
    'Authorization': 'Zoho-oauthtoken YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => data += chunk);
  res.on('end', () => {
    const result = JSON.parse(data);
    // Process the response data
  });
});

req.write(JSON.stringify({
  "payload": {
    "nodes": [
      {
        "node_id": "start"
      },
      {
        "node_id": "end"
      }
    ],
    "edges": [
      {
        "from_node_id": "start",
        "to_node_id": "end"
      }
    ]
  }
}));
req.end();

Python

import requests

url = "https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart"
headers = {
    "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

data = {
  "payload": {
    "nodes": [
      {
        "node_id": "start"
      },
      {
        "node_id": "end"
      }
    ],
    "edges": [
      {
        "from_node_id": "start",
        "to_node_id": "end"
      }
    ]
  }
}

response = requests.post(url, headers=headers, json=data)
data = response.json()
print(data)

Java

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import java.time.Duration;

public class ApiClient {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();

        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create("https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart"))
            .header("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .timeout(Duration.ofSeconds(30));

            .header("Content-Type", "application/json")
        String requestBody = "{\"payload\":{\"nodes\":[{\"node_id\":\"start\"},{\"node_id\":\"end\"}],\"edges\":[{\"from_node_id\":\"start\",\"to_node_id\":\"end\"}]}}";
        HttpRequest request = requestBuilder
            .POST(HttpRequest.BodyPublishers.ofString(requestBody))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

Deluge

info "Making API request to: https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart";

headers = Map();
headers.put("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN");
headers.put("Content-Type", "application/json");

requestData = {"payload": {"nodes": {{"node_id": "start"}, {"node_id": "end"}}, "edges": {{"from_node_id": "start", "to_node_id": "end"}}}};

response = invokeurl
[
    url: "https://show.zoho.com/api/v1/presentation/{rid}/slides/{slide_id}/flowchart"
    type: POST
    headers: headers
    parameters: requestData
];

if (response.get("status_code") == 200) {
    info "Request successful";
    responseData = response.get("response");
    info responseData;
} else {
    info "Request failed with status: " + response.get("status_code");
    info response.get("response");
}