Skip to navigation
API v1 ReferenceUser Tags

Updates a tag globally for users.

Updates a tag globally for users. The renamed or merged tag is applied to matching users.

Required Permissions
The user must be an admin or have user-master-data:write permissions.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
oldTagNamestringRequired>=1 character
The old name of the tag.
newTagobjectRequired
shouldMergeboolean or nullOptional
If true, merge the tags if they already exist. If false, throw an error if the tag already exists.

Response

OK

Errors

400
Bad Request Error
404
Not Found Error