Choose where you’d like to start

Delete Record by ID

Table of Contents

Note: This task is applicable to all Zoho Services except Zoho Creator.

Overview

This task is used to delete a record using its ID from a Zoho Cliq database.

This task is based on Zoho Cliq API - Delete a record

Syntax

<variable> = zoho.cliq.deleteRecord(<database_name>, <record_ID>, <connection>);

where,

ParameterData typeDescription

<variable>

KEY-VALUE

specifies the variable which will hold the response returned by Zoho Cliq.

<database_name>

TEXT

specifies the unique name of the database from which the record is deleted.

<record_ID>

NUMBER

specifies the ID of the record which will be deleted.

Learn how to fetch the record ID after creating or fetching records.

<connection>

TEXTspecifies the link name of the Zoho Cliq connection.

Note:

  • In view of stopping new authtoken generation, a Zoho OAuth connection with appropriate scopes is mandatory for new integration tasks (created after the deadline specified in the post) to work as expected. Existing integration tasks will continue to work with or without the connections parameter unless the authtoken is manually deleted from accounts.
  • Add relevant scopes as mentioned in Zoho Cliq API - Delete a record.
  • Refer to this post for the list of Zoho services that support the connections page.
  • Learn more about connections

Example

The following example deletes a record with ID - 1775XXXX0002XXXX009 from the database - availabilitydatabase.

 response_map=zoho.cliq.deleteRecord("availabilitydatabase",1775XXXX0002XXXX009, "cliq_connection");

where,

response_map
is the variable which will hold the KEY-VALUE response returned by Zoho Cliq.
"availabilitydatabase"
is the TEXT that represents the unique name of the database from which the record is deleted
1775XXXX0002XXXX009
is the NUMBER that represents the ID of the record to be deleted
"cliq_connection"
is the TEXT that represents the name of the connection

Sample Response

Success Response

  • The success response returned is of the following format

     {"status":"SUCCESS"}

Failure Response

  • The failure response returned for an incorrect database name is of the following format

     {
     "status":"FAILURE",
     "message":"Uh-oh! Looks like availabilitydata does not exist.",
     "code":"platform_storage_database_not_found"
     }

  • The failure response returned for an incorrect record ID is of the following format

     {
     "status":"FAILURE",
     "message":"No record found for the id 1775XXXX0002XXXX009",
     "code":"platform_storage_record_not_exists_for_given_id"
     }

Related Links

Get Started Now

Execute