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, your reserved_ipv4_addresses, the domains for your Linodes, and the volumes on your Linodes.

📘

This operation can only be accessed by account users with unrestricted access. Talk to your local account administrator about access management.

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.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: account:read_write

CLI

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

Learn more

Path Params

apiVersion

string

enum

required

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

Allowed:

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

reserved_ipv4_addresses

array of strings

The reserved IPv4 addresses where you want to apply the tag. Each IP must be reserved on your account before you can tag it. Run the Reserve a public IPv4 address operation to reserve one.

reserved_ipv4_addresses

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

200The new tag.

defaultSee Errors for the range of possible error response codes.