Folds a tag into another in the same scope and deletes the source.
const url = 'https://example.com/api/v1/provision/admin/tags/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/merge';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"intoTagId":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/v1/provision/admin/tags/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/merge \ --header 'Content-Type: application/json' \ --data '{ "intoTagId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Identifier of the tag to fold away.
Request Bodyrequired
Section titled “Request Bodyrequired”Cancels the request.
Admin request to fold one tag into another within the same scope.
object
The tag to keep. Every record carrying the merged tag gains this one instead, duplicates collapse, and the merged tag is deleted. Both tags must be in the same scope.
Examplegenerated
{ "intoTagId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Admin request to fold one tag into another within the same scope.
object
The tag to keep. Every record carrying the merged tag gains this one instead, duplicates collapse, and the merged tag is deleted. Both tags must be in the same scope.
Examplegenerated
{ "intoTagId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Admin request to fold one tag into another within the same scope.
object
The tag to keep. Every record carrying the merged tag gains this one instead, duplicates collapse, and the merged tag is deleted. Both tags must be in the same scope.
Examplegenerated
{ "intoTagId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Responses
Section titled “Responses”OK
A tag in the tenant’s registry: a free-form organizing label that records in one scope can be filtered by. Tags are vendor-facing catalog organization only — they never reach an entitlement snapshot, a license token, an activation decision, or the end-user portal.
object
Registry identifier.
The vocabulary this tag belongs to.
Display name as first written. Uniqueness is case-insensitive within a tenant and scope.
Optional chip colour as a #rrggbb hex triplet; null renders in the default chip colour.
How many records currently carry this tag, across every scope-eligible entity.
Whether the tag has been soft-deleted.
When the tag was first created — by an administrator, or implicitly by being typed on a record.
When the tag was last renamed or recoloured.
Optimistic-concurrency revision.
A tag in the tenant’s registry: a free-form organizing label that records in one scope can be filtered by. Tags are vendor-facing catalog organization only — they never reach an entitlement snapshot, a license token, an activation decision, or the end-user portal.
object
Registry identifier.
The vocabulary this tag belongs to.
Display name as first written. Uniqueness is case-insensitive within a tenant and scope.
Optional chip colour as a #rrggbb hex triplet; null renders in the default chip colour.
How many records currently carry this tag, across every scope-eligible entity.
Whether the tag has been soft-deleted.
When the tag was first created — by an administrator, or implicitly by being typed on a record.
When the tag was last renamed or recoloured.
Optimistic-concurrency revision.
Example
{ "scope": "Product"}A tag in the tenant’s registry: a free-form organizing label that records in one scope can be filtered by. Tags are vendor-facing catalog organization only — they never reach an entitlement snapshot, a license token, an activation decision, or the end-user portal.
object
Registry identifier.
The vocabulary this tag belongs to.
Display name as first written. Uniqueness is case-insensitive within a tenant and scope.
Optional chip colour as a #rrggbb hex triplet; null renders in the default chip colour.
How many records currently carry this tag, across every scope-eligible entity.
Whether the tag has been soft-deleted.
When the tag was first created — by an administrator, or implicitly by being typed on a record.
When the tag was last renamed or recoloured.
Optimistic-concurrency revision.
Example
{ "scope": "Product"}Bad Request
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Unauthorized
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Not Found
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}