Tags API #

Base path: /tags

---

GET /tags #

Returns a list of all tags. Supports includes (categories) in the response.

---

GET /tags/{id} #

Returns a single tag by its ID.

---

POST /tags #

Creates a new tag.
Returns the created tag.
Validation rules:

• name: required array, unique per translation
• type: optional
• categories: optional array
  Possible errors: 422 (validation error)

---

PUT/PATCH /tags/{id} #

Updates an existing tag.
Returns the updated tag.
Validation rules:

• name: optional, unique per translation (ignores current tag ID)
• type: optional
• categories: optional array
  Possible errors: 422 (validation error), 404 (tag not found)

---

DELETE /tags/{id} #

Deletes a tag.
Returns no content on success.
Possible errors: 404 (tag not found)

---

GET /tags/type/{type} #

Returns tags filtered by type.

Behavior:

• type="*" → returns all tags
• type="string" → returns tags of that type
• type=array → returns tags matching any of the types
• type=null → returns empty collection

---

Notes:

• Tags can be associated with categories.
• Categories can be attached or updated when creating or updating a tag.
• Tag names support translations and must be unique per locale.
• Related resources (categories) are included by default.