Tags Overview

Tags provide a simple categorization system that can be applied to Components, Content, and Assets within Metabind. They enable efficient organization and filtering of content.

The Tag Object

string

Unique identifier (UUID)

string

Display name

string

URL-friendly name (auto-generated from name)

string

Optional description

string

Creation timestamp (ISO format)

string

Last update timestamp (ISO format)

Example Tag

{
  "id": "tag123",
  "name": "Technology",
  "slug": "technology",
  "description": "Technology-related content",
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-21T15:30:00Z"
}

Permissions

Tags inherit permissions from content and assets:

Users need read permissions on either resource type to view tags
Users need update permissions to create, modify, or delete tags

Using Tags

Tags can be applied when creating or updating:

Components: Include tag IDs in the tags array
Content: Include tag IDs in the tags array
Assets: Include tag IDs in the tags array

Filtering by Tags

Use the tag query parameter or advanced filtering to find resources by tag:

# Simple query parameter
GET /app/v1/.../content?tag=tag123

# Advanced filtering - any tag
POST /app/v1/.../content
{ "filter": { "tags": { "any": ["tag123", "tag456"] } } }

# Advanced filtering - all tags
POST /app/v1/.../content
{ "filter": { "tags": { "all": ["tag123", "tag456"] } } }

Getting Started

API Basics

Organizations

Projects

Saved Searches

Folders

Components

Component Assets

Collections

Packages

Draft Packages

Content Types

Content

Assets

Asset Searching

Tags

Roles

API Keys

The Tag Object

Example Tag

Permissions

Using Tags

Filtering by Tags

​The Tag Object

​Example Tag

​Permissions

​Using Tags

​Filtering by Tags

The Tag Object

Example Tag

Permissions

Using Tags

Filtering by Tags