Labels

Remove Labels from Bookmarks

Remove one or more labels from user bookmarks.

POST /v1/labels/remove detaches a label from one or many saved posts. It mirrors /v1/labels/add: identify the label by label_id or label_name, pass post_ids, and the removal is applied across the whole set in one request.

The response is more informative than the add path because removal has two distinct non-error outcomes. meta carries removed, requested and removed_post_ids, so you can tell 'removed from 3 of 5' apart from 'none of those posts carried that label' without diffing state yourself.

post/v1/labels/remove

Request

  • Base URL: https://api.linkedmash.com
  • URL: https://api.linkedmash.com/v1/labels/remove
  • Auth: one of:
    • OAuth 2 (client credentials, token URL https://api.linkedmash.com/auth/oauth/token, scopes: library:write)
    • HTTP bearer
    • API key in header linkedmash-api-key

Request body

label_idstring

ID of the label to remove.

label_namestring

Name of the label to remove.

Example request

{
  "label_name": "Hooks"
}

Response

Successful response.

statusboolean required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.