> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tags Overview

> Categorize components, content, and assets with tags

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

<ResponseField name="id" type="string">
  Unique identifier (UUID)
</ResponseField>

<ResponseField name="name" type="string">
  Display name
</ResponseField>

<ResponseField name="slug" type="string">
  URL-friendly name (auto-generated from name)
</ResponseField>

<ResponseField name="description" type="string">
  Optional description
</ResponseField>

<ResponseField name="createdAt" type="string">
  Creation timestamp (ISO format)
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Last update timestamp (ISO format)
</ResponseField>

### Example Tag

```json theme={null}
{
  "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:

```bash theme={null}
# 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"] } } }
```