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

# Tag Management

Tags help organize memory blobs. Currently, the API supports retrieving tags.

## Tag Management Endpoints

### Retrieve Tags

Retrieve a list of all tags available to the specified user.

```bash theme={null}
GET /tags
```

**Query parameters:**

* `user_id` (string, **required**): The unique ID of the user whose tags are being requested.

**Example Request:**

```bash theme={null}
curl -X GET "https://api.memoram.app/api/v1/tags?user_id=USER_ID_HERE" \
  -H "Authorization: Bearer YOUR_DEVELOPER_JWT_TOKEN"
```

**Example Response (`200 OK`):**

```json theme={null}
{
  "items": [
    {
      "id": "tag_123",
      "name": "preferences",
      "description": "User preferences and settings",
      "color": "#FF5733",
      "is_enabled": true,
      "created_at": "2023-03-15T10:00:00Z",
      "updated_at": "2023-03-15T10:00:00Z"
    },
    {
      "id": "tag_456",
      "name": "work",
      "description": "Work-related memories",
      "color": "#3366FF",
      "is_enabled": true,
      "created_at": "2023-03-16T11:00:00Z",
      "updated_at": "2023-03-16T11:00:00Z"
    }
    // ... other tags
  ]
}
```

### Retrieve Single Tag by ID

Retrieve the details of a specific tag by its ID.

```bash theme={null}
GET /tags/{tagId}
```

**Path parameters:**

* `tagId` (string, **required**): The unique ID of the tag.

**Query parameters:**

* `user_id` (string, **required**): The unique ID of the user who owns the tag.

**Example Request:**

```bash theme={null}
curl -X GET "https://api.memoram.app/api/v1/tags/tag_123?user_id=USER_ID_HERE" \
  -H "Authorization: Bearer YOUR_DEVELOPER_JWT_TOKEN"
```

**Example Response (`200 OK`):** A single Tag object (see schema above).