Labels

List Labels

List all labels for the authenticated user.

GET /v1/labels returns every label on the authenticated account, each with its numeric id, label_name and a metadata object. Labels are LinkedMash's tagging layer over saved posts; the ids returned here are what you pass as label_id when adding or removing labels in bulk.

This is the call to make before any labelling workflow, because it tells you which names already exist. Adding by label_name will create a label that is not in this list, so reading first is how you avoid ending up with 'AI', 'ai' and 'A.I.' as three separate labels.

get/v1/labels

Request

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

Response

Successful response.

statusboolean required

Changes

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