Connectors API

Manage connector elements on a slide, master, or layout. Insert, list, update, and delete connectors that link shapes.

Data Center:

GET List Connectors

GET https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors

Required Scopes:

ZohoShow.showdocslist.READ

Returns connector objects from a slide, master, or layout. Use this endpoint to inspect lines, elbows, curves, endpoint bindings, arrow markers, and connector labels before updating or deleting them. Omit ids to list all connectors in the container, or pass comma-separated connector UUIDs to fetch selected connectors. Use returned endpoint data to understand which shapes each connector links.

Path parameters

Name	Type	Required	Description
rid	string	Required	Resource id of the presentation. The caller must have the appropriate permission on this presentation.
container	string	Required	Container type that owns the object. Allowed values: slides, masters, layouts.
container_id	string	Required	Id of the selected container. Provide slide_id when container is slides, master_id when container is masters, or layout_id when container is layouts.

Query parameters

Name	Type	Required	Description
ids	string	Optional	Comma-separated connector object ids to fetch. Omit this parameter to list all connector objects in the selected presentation or container.
from	integer	Optional	Zero-based offset for pagination.
count	integer	Optional	Maximum number of records to return. Allowed range: 1-99.

Samples

Responses

200 Connectors Retrieved

400 Invalid Count

400 Invalid Ids

400 Invalid From

{
  "data": {
    "objects": [
      {
        "object_id": "61002e49-d910-49b0-bb03-ea3ee7e8ab5b",
        "content": {
          "connector": {
            "connected": {
              "first": {
                "side": "EAST",
                "shape_id": "4d6435df-0fb6-4bfa-97bb-f0e759feaf02"
              },
              "second": {
                "side": "WEST",
                "shape_id": "d990e909-996c-4447-9ca5-11c0897f57aa"
              }
            },
            "type": "LINE",
            "stroke": {
              "width": 1,
              "fill": {
                "solid": {
                  "color": {
                    "rgb": {}
                  }
                }
              }
            }
          },
          "id": "61002e49-d910-49b0-bb03-ea3ee7e8ab5b"
        }
      },
      {
        "object_id": "3688a479-9342-4b01-9ddc-3c11a1ca66b9",
        "content": {
          "connector": {
            "connected": {
              "first": {
                "side": "EAST",
                "shape_id": "4d6435df-0fb6-4bfa-97bb-f0e759feaf02"
              },
              "second": {
                "side": "WEST",
                "shape_id": "d990e909-996c-4447-9ca5-11c0897f57aa"
              }
            },
            "type": "LINE",
            "stroke": {
              "width": 1,
              "fill": {
                "solid": {
                  "color": {
                    "rgb": {}
                  }
                }
              }
            }
          },
          "id": "3688a479-9342-4b01-9ddc-3c11a1ca66b9"
        }
      },
      {
        "object_id": "f2d2b0b0-7101-4344-9d12-f8822383fb1f",
        "content": {
          "connector": {
            "connected": {
              "first": {
                "shape_id": "4d6435df-0fb6-4bfa-97bb-f0e759feaf02"
              },
              "second": {
                "shape_id": "d990e909-996c-4447-9ca5-11c0897f57aa"
              }
            },
            "type": "ELBOW",
            "stroke": {
              "width": 1,
              "fill": {
                "solid": {
                  "color": {
                    "rgb": {}
                  }
                }
              }
            }
          },
          "id": "f2d2b0b0-7101-4344-9d12-f8822383fb1f"
        }
      },
      {
        "object_id": "b6c62aeb-e519-452b-bf54-137ad602ecea",
        "content": {
          "connector": {
            "connected": {
              "first": {
                "side": "SOUTH",
                "marker": "CLASSIC",
                "shape_id": "4d6435df-0fb6-4bfa-97bb-f0e759feaf02"
              },
              "second": {
                "side": "NORTH",
                "marker": "OPEN",
                "shape_id": "d990e909-996c-4447-9ca5-11c0897f57aa"
              }
            },
            "type": "CURVE",
            "stroke": {
              "captype": "CAPROUND",
              "width": 2,
              "fill": {
                "solid": {
                  "color": {
                    "rgb": {
                      "green": 90,
                      "blue": 200
                    }
                  }
                }
              }
            }
          },
          "id": "b6c62aeb-e519-452b-bf54-137ad602ecea"
        }
      },
      {
        "object_id": "2e2fd4c3-bf76-4340-b808-5e1efa442eb5",
        "content": {
          "connector": {
            "connected": {
              "first": {
                "side": "EAST",
                "shape_id": "4d6435df-0fb6-4bfa-97bb-f0e759feaf02"
              },
              "second": {
                "side": "WEST",
                "marker": "BLOCK",
                "shape_id": "d990e909-996c-4447-9ca5-11c0897f57aa"
              }
            },
            "text": {
              "paragraphs": [
                {
                  "style": {
                    "halign": "CENTER"
                  },
                  "id": "9f029895-2163-5075-9483-aac797745583",
                  "portions": [
                    {
                      "style": {
                        "fontweight": "NORMAL"
                      },
                      "text": "depends on"
                    }
                  ]
                }
              ],
              "properties": {}
            },
            "type": "LINE",
            "stroke": {
              "jointype": "MITER",
              "fill": {
                "solid": {
                  "color": {
                    "rgb": {}
                  }
                }
              }
            }
          },
          "id": "2e2fd4c3-bf76-4340-b808-5e1efa442eb5"
        }
      }
    ],
    "container_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70"
  },
  "message": "Connector(s) content retrieved successfully",
  "request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/54ca442b-63d1-43df-bda9-9f8cd2654e70/connectors",
  "status": "success"
}

Code Examples

cURL

curl -X GET "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20" \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

JavaScript

const response = await fetch('https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20', {
  method: 'GET',
  headers: {
    'Authorization': 'Zoho-oauthtoken YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  }
});

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}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20'),
  method: 'GET',
  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.end();

Python

import requests

url = "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20"
headers = {
    "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
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}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20"))
            .header("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .timeout(Duration.ofSeconds(30));

            .header("Content-Type", "application/json")
        HttpRequest request = requestBuilder
            .GET(HttpRequest.BodyPublishers.noBody())
            .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}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20";

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

response = invokeurl
[
    url: "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids=a0000000-0000-4000-8000-000000000001,a0000000-0000-4000-8000-000000000002&from=0&count=20"
    type: GET
    headers: headers
];

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");
}

POST Insert Connectors

POST https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors

Required Scopes:

ZohoShow.showdocslist.CREATE

Creates one or more connector objects in a slide, master, or layout. Use this endpoint to draw relationships between shapes, such as process flows, dependency lines, or labeled arrows. Each element uses the connector branch of the GraphicObject model. A connector can attach to shapes by id and side, or use explicit points. Include stroke and text fields when you need line styling or labels.

Path parameters

Name	Type	Required	Description
rid	string	Required	Resource id of the presentation. The caller must have the appropriate permission on this presentation.
container	string	Required	Container type that owns the object. Allowed values: slides, masters, layouts.
container_id	string	Required	Id of the selected container. Provide slide_id when container is slides, master_id when container is masters, or layout_id when container is layouts.

Request Body

Interactive structure. Expand fields and select optional schema parts.

Schema Catalog

Samples

Request Body

JSON

{
  "elements": [
    {
      "name": "Flow A->B",
      "connector": {
        "type": "LINE",
        "connected": {
          "first": {
            "shape_id": "a0000000-0000-4000-8000-000000000101",
            "side": "EAST"
          },
          "second": {
            "shape_id": "a0000000-0000-4000-8000-000000000102",
            "side": "WEST"
          }
        }
      }
    }
  ]
}

Responses

200 Connectors Inserted

400 Missing Elements

{
  "data": {
    "success_count": "1",
    "failure_count": "0",
    "results": [
      {
        "insert_object": {
          "final_index": "131",
          "object": {
            "slide_object": {
              "slide_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70",
              "object_id": "f2d2b0b0-7101-4344-9d12-f8822383fb1f"
            }
          }
        }
      }
    ]
  },
  "message": "Connector(s) added successfully",
  "request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/54ca442b-63d1-43df-bda9-9f8cd2654e70/connectors",
  "status": "success"
}

Code Examples

cURL

curl -X POST "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors" \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "elements": [
    {
      "name": "Flow A->B",
      "connector": {
        "type": "LINE",
        "connected": {
          "first": {
            "shape_id": "a0000000-0000-4000-8000-000000000101",
            "side": "EAST"
          },
          "second": {
            "shape_id": "a0000000-0000-4000-8000-000000000102",
            "side": "WEST"
          }
        }
      }
    }
  ]
}'

JavaScript

const response = await fetch('https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors', {
  method: 'POST',
  headers: {
    'Authorization': 'Zoho-oauthtoken YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "elements": [
    {
      "name": "Flow A->B",
      "connector": {
        "type": "LINE",
        "connected": {
          "first": {
            "shape_id": "a0000000-0000-4000-8000-000000000101",
            "side": "EAST"
          },
          "second": {
            "shape_id": "a0000000-0000-4000-8000-000000000102",
            "side": "WEST"
          }
        }
      }
    }
  ]
})
});

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}/{container}/{container_id}/connectors'),
  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({
  "elements": [
    {
      "name": "Flow A->B",
      "connector": {
        "type": "LINE",
        "connected": {
          "first": {
            "shape_id": "a0000000-0000-4000-8000-000000000101",
            "side": "EAST"
          },
          "second": {
            "shape_id": "a0000000-0000-4000-8000-000000000102",
            "side": "WEST"
          }
        }
      }
    }
  ]
}));
req.end();

Python

import requests

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

data = {
  "elements": [
    {
      "name": "Flow A->B",
      "connector": {
        "type": "LINE",
        "connected": {
          "first": {
            "shape_id": "a0000000-0000-4000-8000-000000000101",
            "side": "EAST"
          },
          "second": {
            "shape_id": "a0000000-0000-4000-8000-000000000102",
            "side": "WEST"
          }
        }
      }
    }
  ]
}

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}/{container}/{container_id}/connectors"))
            .header("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .timeout(Duration.ofSeconds(30));

            .header("Content-Type", "application/json")
        String requestBody = "{\"elements\":[{\"name\":\"Flow A->B\",\"connector\":{\"type\":\"LINE\",\"connected\":{\"first\":{\"shape_id\":\"a0000000-0000-4000-8000-000000000101\",\"side\":\"EAST\"},\"second\":{\"shape_id\":\"a0000000-0000-4000-8000-000000000102\",\"side\":\"WEST\"}}}}]}";
        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}/{container}/{container_id}/connectors";

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

requestData = {"elements": {{"name": "Flow A->B", "connector": {"type": "LINE", "connected": {"first": {"shape_id": "a0000000-0000-4000-8000-000000000101", "side": "EAST"}, "second": {"shape_id": "a0000000-0000-4000-8000-000000000102", "side": "WEST"}}}}}};

response = invokeurl
[
    url: "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors"
    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");
}

PUT Update Connectors

PUT https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors

Required Scopes:

ZohoShow.showdocslist.UPDATE

Updates existing connector objects. Use this endpoint to change connector stroke, endpoints, markers, routing type, or label text and styling. Each element must include the connector id. Connector property patches are route-specific, so send connector stroke or text facets rather than a full shape payload. Omitted fields remain unchanged.

Path parameters

Name	Type	Required	Description
rid	string	Required	Resource id of the presentation. The caller must have the appropriate permission on this presentation.
container	string	Required	Container type that owns the object. Allowed values: slides, masters, layouts.
container_id	string	Required	Id of the selected container. Provide slide_id when container is slides, master_id when container is masters, or layout_id when container is layouts.

Request Body

Interactive structure. Expand fields and select optional schema parts.

Schema Catalog

Samples

Request Body

JSON

{
  "elements": [
    {
      "id": "b0000000-0000-4000-8000-000000000201",
      "properties": {
        "type": "SOLID",
        "width": 3,
        "position": "CENTER",
        "captype": "FLAT",
        "jointype": "MITER",
        "fill": {
          "solid": {
            "color": {
              "rgb": {
                "red": 200,
                "green": 0,
                "blue": 0
              }
            }
          }
        }
      }
    }
  ]
}

Responses

200 Connectors Updated

400 Missing Elements

400 Missing Id

404 Object Not Found

{
  "data": {
    "success_count": "1",
    "failure_count": "0",
    "results": [
      {
        "text_mutations": [
          {
            "result": {
              "applied_range": {
                "start_index": "0",
                "end_index": "8"
              }
            },
            "mutation": {
              "new_revision_id": "1"
            },
            "object": {
              "zone_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70",
              "object_id": "c1abd4bb-1c70-43f3-a7c2-46071cdda318",
              "frame_id": "54ca442b-63d1-43df-bda9-9f8cd2654e70"
            }
          }
        ],
        "id": "c1abd4bb-1c70-43f3-a7c2-46071cdda318"
      }
    ]
  },
  "message": "Connector(s) updated successfully",
  "request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/54ca442b-63d1-43df-bda9-9f8cd2654e70/connectors",
  "status": "success"
}

Code Examples

cURL

curl -X PUT "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors" \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "elements": [
    {
      "id": "b0000000-0000-4000-8000-000000000201",
      "properties": {
        "type": "SOLID",
        "width": 3,
        "position": "CENTER",
        "captype": "FLAT",
        "jointype": "MITER",
        "fill": {
          "solid": {
            "color": {
              "rgb": {
                "red": 200,
                "green": 0,
                "blue": 0
              }
            }
          }
        }
      }
    }
  ]
}'

JavaScript

const response = await fetch('https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors', {
  method: 'PUT',
  headers: {
    'Authorization': 'Zoho-oauthtoken YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "elements": [
    {
      "id": "b0000000-0000-4000-8000-000000000201",
      "properties": {
        "type": "SOLID",
        "width": 3,
        "position": "CENTER",
        "captype": "FLAT",
        "jointype": "MITER",
        "fill": {
          "solid": {
            "color": {
              "rgb": {
                "red": 200,
                "green": 0,
                "blue": 0
              }
            }
          }
        }
      }
    }
  ]
})
});

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}/{container}/{container_id}/connectors'),
  method: 'PUT',
  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({
  "elements": [
    {
      "id": "b0000000-0000-4000-8000-000000000201",
      "properties": {
        "type": "SOLID",
        "width": 3,
        "position": "CENTER",
        "captype": "FLAT",
        "jointype": "MITER",
        "fill": {
          "solid": {
            "color": {
              "rgb": {
                "red": 200,
                "green": 0,
                "blue": 0
              }
            }
          }
        }
      }
    }
  ]
}));
req.end();

Python

import requests

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

data = {
  "elements": [
    {
      "id": "b0000000-0000-4000-8000-000000000201",
      "properties": {
        "type": "SOLID",
        "width": 3,
        "position": "CENTER",
        "captype": "FLAT",
        "jointype": "MITER",
        "fill": {
          "solid": {
            "color": {
              "rgb": {
                "red": 200,
                "green": 0,
                "blue": 0
              }
            }
          }
        }
      }
    }
  ]
}

response = requests.put(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}/{container}/{container_id}/connectors"))
            .header("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .timeout(Duration.ofSeconds(30));

            .header("Content-Type", "application/json")
        String requestBody = "{\"elements\":[{\"id\":\"b0000000-0000-4000-8000-000000000201\",\"properties\":{\"type\":\"SOLID\",\"width\":3,\"position\":\"CENTER\",\"captype\":\"FLAT\",\"jointype\":\"MITER\",\"fill\":{\"solid\":{\"color\":{\"rgb\":{\"red\":200,\"green\":0,\"blue\":0}}}}}}]}";
        HttpRequest request = requestBuilder
            .PUT(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}/{container}/{container_id}/connectors";

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

requestData = {"elements": {{"id": "b0000000-0000-4000-8000-000000000201", "properties": {"type": "SOLID", "width": 3, "position": "CENTER", "captype": "FLAT", "jointype": "MITER", "fill": {"solid": {"color": {"rgb": {"red": 200, "green": 0, "blue": 0}}}}}}}};

response = invokeurl
[
    url: "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors"
    type: PUT
    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");
}

DELETE Remove Connectors

DELETE https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors

Required Scopes:

ZohoShow.showdocslist.DELETE

Deletes one or more connector objects from the selected container. Use this when relationships or arrows should be removed while keeping the shapes they connected. Pass comma-separated connector UUIDs in ids. Deleting a connector does not delete its source or target shapes.

Path parameters

Name	Type	Required	Description
rid	string	Required	Resource id of the presentation. The caller must have the appropriate permission on this presentation.
container	string	Required	Container type that owns the object. Allowed values: slides, masters, layouts.
container_id	string	Required	Id of the selected container. Provide slide_id when container is slides, master_id when container is masters, or layout_id when container is layouts.

Query parameters

Name	Type	Required	Description
ids	string	Required	Comma-separated connector object ids to delete. These ids select the objects to remove; the path parameters identify the container that holds them.

Samples

Responses

200 Connectors Deleted

400 Missing Ids

404 Object Not Found

400 Invalid Ids

{
  "data": {
    "success_count": "1",
    "failure_count": "0",
    "results": [
      {
        "new_revision_id": "272",
        "object_id": "64eee548-73e1-47dc-848a-88585074b99b"
      }
    ]
  },
  "message": "Connector(s) deleted successfully",
  "request_uri": "/api/v1/presentation/8i4vv3f345fcf907446a2bdc4e2c871fc585e/slides/54ca442b-63d1-43df-bda9-9f8cd2654e70/connectors",
  "status": "success"
}

Code Examples

cURL

curl -X DELETE "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids={{object_id}}" \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

JavaScript

const response = await fetch('https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids={{object_id}}', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Zoho-oauthtoken YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  }
});

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}/{container}/{container_id}/connectors?ids={{object_id}}'),
  method: 'DELETE',
  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.end();

Python

import requests

url = "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids={{object_id}}"
headers = {
    "Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

response = requests.delete(url, headers=headers)
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}/{container}/{container_id}/connectors?ids={{object_id}}"))
            .header("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
            .timeout(Duration.ofSeconds(30));

            .header("Content-Type", "application/json")
        HttpRequest request = requestBuilder
            .DELETE(HttpRequest.BodyPublishers.noBody())
            .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}/{container}/{container_id}/connectors?ids={{object_id}}";

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

response = invokeurl
[
    url: "https://show.zoho.com/api/v1/presentation/{rid}/{container}/{container_id}/connectors?ids={{object_id}}"
    type: DELETE
    headers: headers
];

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");
}