Create a tag

post https://api.linode.com/{apiVersion}/tags

Creates a new tag and lets you optionally add it to specific objects. Tags are labels you can attach to objects in your account. Use them to specify and group attributes of objects that are relevant to you. Currently, you can add a tag to your linodes, your nodebalancers, the domains for your Linodes, and the volumes on your Linodes.

📘

This operation can only be accessed by account users with unrestricted access.

If you don't add a tag to a supported object with this operation, you can use that object's update operation to later add the tag you created.

linode-cli tags create \
  --label 'example tag' \
  --linodes 123 \
  --linodes 456 \
  --volumes 9082 \
  --volumes 10003


Learn more...

account:read_write


Learn more...

Path Params

apiVersion

string

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Body Params

domains

array of integers

The id values for the domains where you want to apply the tag. You need read_write access to each domain. If you don't, the API won't create the tag and you'll receive an error. You can run the List domains operation to store the id for desired domains and to review any tags currently applied.

domains

label

string

required

length between 3 and 50

The name of your tag. This is used for display purposes.

linodes

array of integers

The id values for the Linodes where you want to apply the tag. You need read_write access to each Linode. If you don't, the API won't create the tag and you'll receive an error. You can run the List Linodes operation to store the id for desired Linodes and to review any tags currently applied.

linodes

nodebalancers

array of integers

The id values for the NodeBalancers where you want to apply the tag. You need read_write access to each NodeBalancer. If you don't, the API won't create the tag and you'll receive an error. You can run the List NodeBalancers operation to store the id for desired NodeBalancers and to review any tags currently applied.

nodebalancers

volumes

array of integers

The id values for the Linode volumes where you want to apply the tag. You need read_write access to each volume. If you don't, the API won't create the tag and you'll receive an error. You can run the List volumes operation to store the id for desired Linode volumes and to review any tags currently applied.

volumes

Responses

Language

Credentials


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.linode.com/v4/tags \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
 
1
{
2
  "label": "example tag"
3
}

200The new tag.

defaultSee Errors for the range of possible error response codes.