Tag Ownership API

Data Model

Field	Type	Description
id	UUID	Primary key
slug	string(128)	Unique normalized identifier (lowercase, trimmed)
name	string(256)?	Display name
description	string(4096)?	Tag description/metadata
owner_publisher_id	UUID?	Owning publisher
is_protected	bool	Only owner can use on new posts
is_event	bool	Time-limited event tag
event_ends_at	Instant?	Expiry timestamp

quota = 3 + 3 × perkLevel

All endpoints prefixed with /api/posts/tags. The pub query param selects the publisher (defaults to current user's default publisher).

POST /api/posts/tags?pub={publisherName}

{
  "slug": "photography",
  "name": "Photography",
  "description": "Posts about photography"
}

The authenticated publisher becomes the owner.

GET /api/posts/tags/{slug}

PATCH /api/posts/tags/{slug}?pub={publisherName}

Only the owning publisher's manager/owner can edit.

POST /api/posts/tags/{slug}/claim?pub={publisherName}

Manually claim ownership of an unowned tag.

GET /api/posts/tags/quota?pub={publisherName}

Returns total/used/remaining quota and list of protected tags.

All require IsSuperuser or posts.tags.admin permission.

POST /api/admin/posts/tags/{slug}/assign

{ "publisher_id": "..." }

PATCH /api/admin/posts/tags/{slug}/protect

{ "is_protected": true }

Returns 400 if quota exceeded.

PATCH /api/admin/posts/tags/{slug}/event

{
  "is_event": true,
  "ends_at": "2026-06-01T00:00:00Z"
}

PATCH /api/admin/posts/tags/{slug}

Admin can update any tag regardless of ownership.