Create a tag

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

Creates a new Tag and optionally tags requested objects with it immediately.

Important. You must be an unrestricted User in order to access, add, or modify Tags information.

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

The tag to create, and optionally the objects to tag.

domains

array of integers

A list of Domain IDs to apply the new Tag to. You must be allowed to read_write all of the requested Domains, or the Tag will not be created and an error will be returned.

domains

label

string

required

length between 3 and 50

The new Tag.

linodes

array of integers

A list of Linode IDs to apply the new Tag to. You must be allowed to read_write all of the requested Linodes, or the Tag will not be created and an error will be returned.

linodes

nodebalancers

array of integers

A list of NodeBalancer IDs to apply the new Tag to. You must be allowed to read_write all of the requested NodeBalancers, or the Tag will not be created and an error will be returned.

nodebalancers

volumes

array of integers

A list of Volume IDs to apply the new Tag to. You must be allowed to read_write all of the requested Volumes, or the Tag will not be created and an error will be returned.

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.