Create Skill Version

VersionCreateResponse Beta.Skills.Versions.Create(, )

POST/v1/skills/{skill_id}/versions

ParametersExpand Collapse

VersionCreateParams parameters

required string skillID

Path param: Unique identifier for the skill.

The format and length of IDs may change over time.

IReadOnlyList<string>? files

Body param: Files to upload for the skill.

All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.

IReadOnlyList<AnthropicBeta> betas

Header param: Optional header to specify the beta version(s) you want to use.

ReturnsExpand Collapse

class VersionCreateResponse:

required string ID

Unique identifier for the skill version.

The format and length of IDs may change over time.

required string CreatedAt

ISO 8601 timestamp of when the skill version was created.

required string Description

Description of the skill version.

This is extracted from the SKILL.md file in the skill upload.

required string Directory

Directory name of the skill version.

This is the top-level directory name that was extracted from the uploaded files.

required string Name

Human-readable name of the skill version.

This is extracted from the SKILL.md file in the skill upload.

required string SkillID

Identifier for the skill that this version belongs to.

required string Type

Object type.

For Skill Versions, this is always "skill_version".

required string Version

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Create Skill Version

VersionCreateParams parameters = new() { SkillID = "skill_id" };

var version = await client.Beta.Skills.Versions.Create(parameters);

Console.WriteLine(version);

Response 200

{
  "id": "skillver_01JAbcdefghijklmnopqrstuvw",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "A custom skill for doing something useful",
  "directory": "my-skill",
  "name": "my-skill",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "type",
  "version": "1759178010641129"
}

Returns Examples

Response 200

{
  "id": "skillver_01JAbcdefghijklmnopqrstuvw",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "A custom skill for doing something useful",
  "directory": "my-skill",
  "name": "my-skill",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "type",
  "version": "1759178010641129"
}

{ "id": "skillver_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "description": "A custom skill for doing something useful", "directory": "my-skill", "name": "my-skill", "skill_id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type", "version": "1759178010641129" }