Labels

Bulk-remove a label by filter

Remove one label from every saved post matching the supplied server-side filters in a bounded bulk operation.

post/v1/labels/remove-by-filter

Request

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

Existing LinkedMash label identifier.

label_namestring

Existing or new LinkedMash label name.

qstring

Full-text query applied to the saved-post library.

authorstring

LinkedIn author identifier used to narrow matching posts.

tagstring

Existing label used to narrow matching posts.

media_typestring

Media type used to narrow matching posts.

posted_fromstring date-time

Inclusive earliest LinkedIn post timestamp.

posted_tostring date-time

Inclusive latest LinkedIn post timestamp.

bookmarked_fromstring date-time

Inclusive earliest saved timestamp.

bookmarked_tostring date-time

Inclusive latest saved timestamp.

is_unread_onlyboolean

Limit the operation to unread saved posts.

hide_archivedboolean

Exclude archived saved posts when true.

Response

Bulk label removal result.

object required

Bulk-operation result with matched, affected, failed, and truncation counts.

Changes

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