Introduction

Create, read, update, and delete tags for categorizing and organizing your links.

Overview

(GET) Retrieve tags with pagination and filtering
(POST) Create one or more tags with custom names and colors
(PUT) Update existing tags or create new ones with upsert
(DELETE) Permanently delete tags (hard delete)

Tags help categorize and filter your links, providing a flexible labeling system that complements collections. While collections organize links into folders, tags allow you to apply multiple labels to a single link, enabling cross-cutting categorization.

Use tags to mark links by campaign type, content category, target audience, priority level, or any other dimension that helps you organize and find your links. A single link can have multiple tags, making it easy to filter and search across different organizational axes.

The Tags API provides full CRUD operations for managing your tag library. Create tags with custom names and colors, update them as your needs evolve, and delete tags that are no longer needed.

Tag Strategy

Plan your tag structure to complement your collection organization. Use tags for cross-cutting concerns that span multiple collections, such as campaign types, content categories, or priority levels. Choose descriptive tag names and use colors to visually distinguish different tag categories.