Skip to main content
Set or remove a tag for an image.

TL;DR

  • Use when: Naming frequently-used images
  • Returns: Updated image details
  • Cost: No VM needed

Parameters

ParameterTypeRequiredDefaultDescription
image_uuidstringYes-Image UUID to tag
tagstringNonullTag to assign (omit to remove)

Response

{
  "uuid": "abc123-def456-...",
  "tag": "my-image:v1",
  "created_at": "2024-01-15T10:30:00Z"
}

Examples

Set Tag

{"tool": "set_tag", "args": {
  "image_uuid": "abc123-def456-...",
  "tag": "claude/project/python/dev-env:v1"
}}

Remove Tag

{"tool": "set_tag", "args": {
  "image_uuid": "abc123-def456-..."
}}

Tagging Convention

For AI agents, use this pattern:
{agent}/{project}/{base}/{approach}:{version}
Examples:
  • claude/myproject/python/dev-env:v1
  • claude/common/alpine/build-tools:latest

See Also