PATCH https://api.usecommune.com/tags/{tag} Production. There is no separate sandbox host.

Rename a tag

Changes what a segment is called. Needs audience: write, and is a write.

name is the only thing about a tag that can be changed, and changing it moves nothing else. The people holding the tag still hold it, and every article addressed to it is still addressed to it, because an article names a tag by id rather than by name. A rename is a label, never a change of who may read what.

The new name has to be free among this newsletter's live tags; one a live tag already has answers 422.

A retired tag cannot be renamed, and answers 422. A retirement is the surviving record of what an already sent article was addressed to, and renaming it would relabel an audience that has already gone out.

Publishes no event.

Path parameters

  • string(uuid) Required

Request Headers

  • string Required
  • string

Body

  • string Required
PATCH /tags/{tag}
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-updatetag

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.