Overview
Access tags (also known as user tags) are labels that can be assigned to users to control access to content, collections, and features within a platform.
Use Cases
- Gate premium content behind specific tags
- Segment users by membership tier or interest
- Control visibility of collections and group features
- Track user categories for analytics and reporting
Key Concepts
- Tags are scoped to a platform — each platform has its own set of tags.
- A user can have multiple tags assigned at once.
- Tags can be managed in bulk via the Add/Edit User endpoint using
AccessTagIds, or individually via the assign/unassign endpoints below. - Tags are referenced by
title(string) when assigning individually, or byid(integer) when setting in bulk.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/access-tags | List all tags for the platform |
| POST | /api/access-tag | Create a new tag |
| POST | /api/access-tag/assign | Assign a tag to the current user |
| DELETE | /api/access-tag/assign | Remove a tag from the current user |