Delete a Bookmark

Purpose

This API is used to delete a specific bookmark.

OAuth Scope

Use the scope

ZohoMail.links.ALL (or) ZohoMail.links.DELETE

to generate the Authtoken.

ALL - Grants full access to links.

DELETE - Grants access to delete bookmarks.

Request URL

Method: DELETE

For Group :

https://mail.zoho.com/api/links/groups/{groupId}/{bookmarkId}

or

For Personal :

https://mail.zoho.com/api/links/me/{bookmarkId}

Path Parameters

  • groupId* long
    • Specifies the unique ID of the group.
    • This parameter can be retrieved from the Get all groups API.
  • bookmarkId* long

Request Body (JSON Object)

  • forceDelete boolean
    • This parameter specifies whether to delete the bookmark permanently or to be moved to trash.
    • Allowed values:
      • true - The bookmark will be deleted permanently.
      • false - The bookmark will be moved to trash.
    • Default value : true.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

``

Sample Request - For Group

Copiedcurl "https://mail.zoho.com/api/links/groups/12345678/1712055560315110001" \
-X DELETE \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"

Sample Request - For Personal

Copiedcurl "https://mail.zoho.com/api/links/me/1712055560315110001" \
-X DELETE \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"

Sample Success Response

Copied{
  "status": {
    "code": 200,
    "description": "success"
  }
}

Sample Failure Response

Copied{
  "status": {
    "code": 500,
    "description": "Internal Error"
  },
  "data": {
    "moreInfo": "Operation not permitted"
  }
}