Labels

Add Labels to Bookmarks

Add one or more labels to user bookmarks.

POST /v1/labels/add attaches a label to one or many saved posts in a single call. Identify the label either by label_id (from GET /v1/labels) or by label_name, and pass post_ids as an array — or a single id, which is accepted for convenience and treated as an array of one.

This is the bulk primitive behind every classification workflow: fetch a filtered page from /v1/bookmarks, decide a label, and write it back in one request rather than one call per post.

post/v1/labels/add

Request

  • Base URL: https://api.linkedmash.com
  • URL: https://api.linkedmash.com/v1/labels/add
  • 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 add.

label_namestring

Name of the label to add (if creating a new one).

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.