versions

Creates, updates, deletes, gets or lists a versions resource.

Overview

Name	versions
Type	Resource
Id	anthropic.skills.versions

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
name	string	The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter `name` (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.
skill_id	string	Unique identifier for the skill. The format and length of IDs may change over time.
created_at	string (date-time)	ISO 8601 timestamp of when the skill was created.
description	string	Description of the skill version. This is extracted from the SKILL.md file in the skill upload.
type	string	Object type. For Skill Versions, this is always `"skill_version"`. (skill_version)

list

Name	Datatype	Description
id	string	Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
name	string	The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter `name` (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.
skill_id	string	Unique identifier for the skill. The format and length of IDs may change over time.
created_at	string (date-time)	ISO 8601 timestamp of when the skill was created.
description	string	Description of the skill version. This is extracted from the SKILL.md file in the skill upload.
type	string	Object type. For Skill Versions, this is always `"skill_version"`. (skill_version)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	skill_id, version	anthropic-workspace-id
list	select	skill_id	anthropic-workspace-id
delete	delete	skill_id, version	anthropic-workspace-id
create	exec	skill_id, files	anthropic-workspace-id
download	exec	skill_id, version	anthropic-workspace-id	Download a skill version's content as a zip archive.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
skill_id	string	Unique identifier for the skill. The format and length of IDs may change over time.
version	string	Identifies the skill version by its version ID. Requests carrying the skills-2025-10-02 beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").
anthropic-workspace-id	string	Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. (example: wrkspc_011CZkZaBF1tNoB5wlCeusgy)

SELECT examples

get

Successful Response

SELECT
id,
name,
skill_id,
created_at,
description,
type
FROM anthropic.skills.versions
WHERE skill_id = '{{ skill_id }}' -- required
AND version = '{{ version }}' -- required
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;

list

Successful Response

SELECT
id,
name,
skill_id,
created_at,
description,
type
FROM anthropic.skills.versions
WHERE skill_id = '{{ skill_id }}' -- required
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;

DELETE examples

delete

No description available.

DELETE FROM anthropic.skills.versions
WHERE skill_id = '{{ skill_id }}' --required
AND version = '{{ version }}' --required
AND "anthropic-workspace-id" = '{{ anthropic-workspace-id }}'
;

Lifecycle Methods

create

Successful Response

EXEC anthropic.skills.versions.create 
@skill_id='{{ skill_id }}' --required, 
@anthropic-workspace-id='{{ anthropic-workspace-id }}'
@@json=
'{
"files": "{{ files }}"
}'
;

download

Download a skill version's content as a zip archive.

EXEC anthropic.skills.versions.download 
@skill_id='{{ skill_id }}' --required, 
@version='{{ version }}' --required, 
@anthropic-workspace-id='{{ anthropic-workspace-id }}'
;