Update a tag
PUT/:workspace/tags/:tag
Updates a tag's name and colour. Both fields are required — this is a full replace, not a partial patch. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives 403.
Returns {"success": <bool>}, where success is false only if the update itself fails. If no tag matches the UUID, the request returns 404 with {"message": "Tag not found."} instead.
Request
Responses
- 200
- 401
- 403
- 404
- 422
Update result.
The bearer token is missing, malformed, unknown, or expired.
The token is valid, but the user it belongs to may not perform this action:
- they are not a member of the
{workspace}in the path; or - their workspace role is too low for this endpoint (write routes require Admin or Member); or
- for
/panelendpoints, they are not a platform administrator.
The host application that Mixpost is installed into can also deny access to Mixpost as a whole, which produces the same response.
The workspace or the tag was not found.
The request body failed validation.