Skip to main content
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

​
id
string
Unique identifier (UUID)
​
name
string
Display name
​
slug
string
URL-friendly name (auto-generated from name)
​
description
string
Optional description
​
createdAt
string
Creation timestamp (ISO format)
​
updatedAt
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 /v1/.../content?tag=tag123

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

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