Tags API
Manage content tags through the Levercast API.
List Tags
GET /api/v1/tagsReturns all tags available to the authenticated user, including both system tags and user-created tags.
Response:
{
"data": [
{
"id": "uuid",
"name": "Evergreen",
"slug": "evergreen",
"category": "shelf_life",
"color": "#10b981",
"createdAt": "2025-01-15T10:30:00Z"
}
]
}Create a Tag
POST /api/v1/tagsRequest Body:
{
"name": "Product Update",
"color": "#6366f1"
}Tags are automatically assigned to the user category and a slug is generated from the name.
Response: 201 with the created tag in data.
Update a Tag
PATCH /api/v1/tags/:idRequest Body (all optional):
{
"name": "New Name",
"color": "#f59e0b"
}Delete a Tag
DELETE /api/v1/tags/:idDeleting a tag removes it from all posts that reference it.
Response:
{
"data": {
"id": "uuid",
"deleted": true
}
}