Skip to main content
POST
/
v1
/
skills
/
{skill_id}
/
update
!pip install vlmrun

from vlmrun.client import VLMRun

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

# Upload a new skill zip
file = client.files.upload(file=Path("updated-skill.zip"))

# Update the skill (creates a new version)
updated_skill = client.agent.skills.update(
    skill_id="<skill-id>",
    file_id=file.id,
    description="Updated invoice extraction with improved accuracy"
)
print(f"Updated skill: {updated_skill.id} (v{updated_skill.version})")

{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "skill_version": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "status": "completed"
}

Documentation Index

Fetch the complete documentation index at: https://docs.vlm.run/llms.txt

Use this file to discover all available pages before exploring further.

!pip install vlmrun

from vlmrun.client import VLMRun

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

# Upload a new skill zip
file = client.files.upload(file=Path("updated-skill.zip"))

# Update the skill (creates a new version)
updated_skill = client.agent.skills.update(
    skill_id="<skill-id>",
    file_id=file.id,
    description="Updated invoice extraction with improved accuracy"
)
print(f"Updated skill: {updated_skill.id} (v{updated_skill.version})")

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
skill_id
string
required

Body

application/json

Request to update a skill.

​
file_id
string
required

File ID from file upload API (the new skill zip)

​
description
string | null

Updated description of the skill

​
is_public
boolean | null

Updated public accessibility

Response

Successful Response

Response for skill creation.

​
id
string
required

ID of the created skill

​
name
string
required

Name of the skill (may differ from request if LLM-generated)

​
description
string
required

Description of the skill (may differ from request if LLM-generated)

​
skill_version
string
required

Auto-generated version of the skill (e.g. '20260512-abc12345')

​
created_at
string<date-time>
required

Date and time when the skill was created

​
updated_at
string<date-time>
required

Date and time when the skill was updated

​
status
string
default:completed

Status of the skill creation