Delete a tag

DELETE 
/:workspace/tags/:tag

Deletes a tag. Requires the ADMIN or MEMBER workspace role; the VIEWER role receives 403.

Unlike PUT, this endpoint does not return 404 for an unknown tag UUID: it returns 200 with {"success": false} when no matching tag existed in the workspace.

Request

Responses

200

Delete result. success is false when no matching tag existed in the workspace.

401

The bearer token is missing, malformed, unknown, or expired.

403

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 /panel endpoints, 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.

404

The {workspace} UUID in the path does not match any workspace.