{
"opencollection": "1.0.0",
"info": {
"name": "Bots Extensions API",
"version": "1.0.0"
},
"items": [
{
"info": {
"name": "Extensions",
"type": "folder"
},
"items": [
{
"info": {
"name": "Install an extension",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://cliq.zoho.com/api/v3/extensions/:EXTENSION_ID/installation",
"params": [
{
"name": "EXTENSION_ID",
"value": "EXTENSION_ID",
"type": "path",
"description": "Unique numeric identifier for the installed Extension (Application) in Cliq. To learn how to retrieve this ID, see EXTENSION_ID in the Glossary page."
},
{
"name": "extension_key",
"value": "",
"type": "query",
"description": "Encrypted identifier for the Extension (Application). Generated when the extension is registered on the Cliq Developer Platform. Used as an authentication credential for all Extension API requests. Refer to EXTENSION_KEY in the Glossary page."
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Install a Cliq extension in an organisation. After installation, the extension's bundled platform components (bots, commands, message actions, etc.) become available to users.\n
\n
\n Threshold limit: 10 requests per min per user
\n Maximum API calls allowed within one minute.
\n Lock period: 5 minutes
Cooldown period applied after threshold exhaustion.
\n
\n Threshold limit: 10 requests per min per user
\n Maximum API calls allowed within one minute.
\n Lock period: 10 minutes
Cooldown period applied after threshold exhaustion.
\n
\n Extension properties are values associated with the extension. They are quite similar to regular data properties, wherein you map a key of type string with a value string. The main purpose is to store data configurations for the extension. They can be added, retrieved for use and deleted and even the Organization admin does not have access to view these configurations. "
},
{
"info": {
"name": "Add or update extension properties",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://cliq.zoho.com/api/v3/extensions/:EXTENSION_ID/properties",
"params": [
{
"name": "extension_key",
"value": "",
"type": "query",
"description": "Encrypted identifier for the Extension (Application). Generated when the extension is registered on the Cliq Developer Platform. Used as an authentication credential for all Extension API requests. Refer to EXTENSION_KEY in the Glossary page."
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Add new or update existing configuration properties for an installed Extension. Extension properties are key-value pairs used to store extension-level settings (e.g. API keys, configuration flags) that are accessible to the extension's platform components. The `extension_key` parameter is required.\n
\n
\n Threshold limit: 30 requests per min per user
\n Maximum API calls allowed within one minute.
\n Lock period: 5 minutes
Cooldown period applied after threshol"
},
{
"info": {
"name": "Get a specific extension property",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://cliq.zoho.com/api/v3/extensions/:EXTENSION_ID/properties/:EXTENSION_PROPERTY_KEY_NAME",
"params": [
{
"name": "EXTENSION_PROPERTY_KEY_NAME",
"value": "EXTENSION_PROPERTY_KEY_NAME",
"type": "path",
"description": "The string key uniquely identifying a single extension property. Must match the pattern ([a-z_]+), max 30 characters. To learn more, see EXTENSION_PROPERTY_KEY_NAME in the Glossary page."
},
{
"name": "extension_key",
"value": "",
"type": "query",
"description": "Encrypted identifier for the Extension (Application). Generated when the extension is registered on the Cliq Developer Platform. Used as an authentication credential for all Extension API requests. Refer to EXTENSION_KEY in the Glossary page."
}
],
"auth": {
"type": "oauth2",
"flow": "implicit",
"authorizationUrl": "https://accounts.zoho.com/oauth/v2/auth",
"credentials": {
"clientId": "{{clientId}}"
}
}
},
"docs": "Retrieve a single extension property of an installed extension.\n
\n
\n Threshold limit: 30 requests per min per user
\n Maximum API calls allowed within one minute.
\n Lock period: 5 minutes
Cooldown period applied after threshold exhaustion.
\n
\n Threshold limit: 30 requests per min per user
\n Maximum API calls allowed within one minute.
\n Lock period: 5 minutes
Cooldown period applied after threshold exhaustion.
\n