Create a tag

Create a tag and assign it to zero or more vaults.

Request

Security

Table 1. Roles capable of executing the Create Tag (createTag) API method
Any Super User System Admin Security Admin Operator
  superUser systemAdmin    
POST /manager/api/{format}/1.0/createTag.adm HTTP/1.1
Host:{manager.dsnet}
name={tagName}&description={tagDescription}&vaultIds=[{vault1,vault2}]

Curl method

curl -u {admin}:{password} -k ”/manager/api/{format}/1.0/createTag.adm“ -d ”name={tagName}&description={tagDescription}&vaultIds=[{vault1,vault2}]“

Parameters

Table 2. Request Parameters for Create Tag (createTag) API method
Parameter Type Usage Default Description
name String Required  

Name for tag.

Must be unique.

description String Optional  

Description for tag.

vaultIds Set Optional  

IDs of vaults on which to place new tag.

deviceIds Set Optional  

IDs of devices on which to place new tag.