Disable notifications

Disable the notifications enabled through channels by removing those channels. This endpoint deletes the channels and the notifications enabled for those channels.

Endpoints

DELETE /actions/watch

Request URL

Bigin APIs are available across eight different domains, and you must choose the one relevant to your data center (DC):

DELETEhttps://www.zohoapis.com/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.eu/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.com.au/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.in/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.com.cn/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.jp/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.sa/bigin/v2/actions/watch

DELETEhttps://www.zohoapis.ca/bigin/v2/actions/watch

Authorization

For this endpoint, pass the access token as an authorization header. Read OAuth Authentication for more information about access tokens.

Authorization: Zoho-oauthtoken <ACCESS_TOKEN>

You must authenticate using an access token that's associated with the following scope:

ZohoBigin.notifications.ALL
ZohoBigin.notifications.DELETE

Sample request

Copiedcurl "https://www.zohoapis.com/bigin/v2/actions/watch?channel_ids=1001,1002" \
-X DELETE \
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Request parameters

The available request parameters are provided below:

Query parameters

channel_ids stringRequired

Provide a comma-separated list of channel IDs that are specified when enabling a notification.

Sample response

Copied{
    "watch": [
        {
            "code": "SUCCESS",
            "details": {
                "resource_uri": "https://www.zohoapis.com/bigin/v2/Contacts",
                "resource_id": "5436046000000002179",
                "channel_id": "1001"
            },
            "message": "Successfully un-subscribed from actions-watch",
            "status": "success"
	},
        {
            "code": "SUCCESS",
            "details": {
                "resource_uri": "https://www.zohoapis.com/bigin/v2/Pipelines",
                "resource_id": "5436046000000002181",
                "channel_id": "1002"
            },
            "message": "Successfully un-subscribed from actions-watch",
            "status": "success"
		}
	]
}