VESSL Cloud Documentation

The tag command lets you create, list, and delete tags at the organization level. Tags can be attached to jobs for filtering and categorization.

create

Create a new tag in your organization.

vesslctl tag create <value>

Argument	Description
`value`	Display name for the tag

Flag	Default	Description
`--color`	`#808080`	Tag color in hex format (for example, `#ff0000`)

Example:

vesslctl tag create "experiment-v2" --color "#3b82f6"

list

List all tags in your organization.

vesslctl tag list

Example output:

SLUG                VALUE            COLOR     CREATOR    CREATED
tag-abc123          experiment-v2    #3b82f6   wayne      2026-04-15T09:00:00Z
tag-def456          baseline         #808080   alice      2026-04-14T15:30:00Z

delete

Delete a tag by its value or slug.

vesslctl tag delete [value]

Argument	Description
`value`	Tag value to delete (positional, mutually exclusive with `--slug`)

Flag	Short	Description
`--slug`	`-s`	Delete tag by slug instead of value

Example:

# Delete by value
vesslctl tag delete "experiment-v2"

# Delete by slug
vesslctl tag delete -s tag-abc123

Job tag commands

Tags can be attached to and detached from jobs using vesslctl job tag. When you attach a tag value that does not exist yet, it is created automatically.

job tag attach

Attach a tag to a job.

vesslctl job tag attach <slug> [tagValue]

Argument	Description
`slug`	Slug of the job
`tagValue`	Tag value to attach (auto-creates if not exists)

Flag	Short	Description
`--slug`	`-s`	Attach tag by slug instead of value

Example:

# Attach by value (auto-creates the tag if needed)
vesslctl job tag attach job-abc123 "nightly-run"

# Attach by slug
vesslctl job tag attach job-abc123 -s tag-def456

job tag detach

Detach a tag from a job.

vesslctl job tag detach <slug> [tagValue]

Argument	Description
`slug`	Slug of the job
`tagValue`	Tag value to detach

Flag	Short	Description
`--slug`	`-s`	Detach tag by slug instead of value

Example:

vesslctl job tag detach job-abc123 "nightly-run"

Use vesslctl job create --tag "my-tag" to attach tags at job creation time. The --tag flag is repeatable and auto-creates tags that don’t exist.

Get started

Examples

vesslctl CLI

Use VESSL Cloud

Operate organization

VM Clusters

Glossary

Support

vesslctl tag

create

list

delete

Job tag commands

job tag attach

job tag detach

​create

​list

​delete

​Job tag commands

​job tag attach

​job tag detach

create

list

delete

Job tag commands

job tag attach

job tag detach