skills

Update Skill

Create a new version of an existing skill.

This creates a NEW database record with:

  • A new unique ID
  • The same name as the original skill
  • A new auto-generated version (format: YYYYMMDD-<8-char-sha256>)

Workflow:

  1. Upload new skill zip via POST /v1/files -> get file_id
  2. Call this endpoint with the original skill_id and new file_id to create a new version
post/v1/skills/{skill_id}/update

Request

  • Base URL: https://api.vlm.run (the document declares no server; this is the origin it was published from)
  • URL: https://api.vlm.run/v1/skills/{skill_id}/update
  • Auth: HTTP bearer

Path parameters

skill_idstring required

Request body

file_idstring required

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

descriptionstring nullable

Updated description of the skill

is_publicboolean nullable

Updated public accessibility

Response

Successful Response

idstring required

ID of the created skill

namestring required

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

descriptionstring required

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

skill_versionstring required

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

statusstring

Status of the skill creation

created_atstring date-time required

Date and time when the skill was created

updated_atstring date-time required

Date and time when the skill was updated

Changes

No recorded changes to this operation across all 2 revisions of this API.