Skip to main content
By default, skill_version is "latest", which resolves to the most recent revision of the skill. You can pin a specific version for reproducibility.

​
Latest vs Pinned

from vlmrun.client.types import AgentSkill

# Always use the latest version
skill = AgentSkill(skill_name="invoice-extraction")

# Pin a specific version
skill = AgentSkill(skill_name="invoice-extraction", skill_version="20260219-abc123")

​
When to Pin

ScenarioRecommendation
Production pipelinesPin a specific version for consistent, reproducible results
Development and testingUse "latest" to automatically pick up improvements
A/B testingPin different versions to compare extraction quality
Compliance workloadsPin to ensure auditable, repeatable outputs

​
Version Format

Version strings follow the format YYYYMMDD-<hash>, for example 20260219-abc123. Each time a skill is updated, a new version is created with a new unique ID but the same name.

​
Checking Available Versions

Use the Skills API to list available versions for a skill: 
from vlmrun.client import VLMRun

client = VLMRun(api_key="<VLMRUN_API_KEY>")

# Get the latest version
skill = client.agent.skills.get(name="invoice-extraction")
print(f"Latest version: {skill.skill_version}")

# Get a specific version
skill = client.agent.skills.get(name="invoice-extraction", skill_version="20260219-abc123")