# Versions ## Create Skill Version `client.beta.skills.versions.create(stringskillID, VersionCreateParamsparams?, RequestOptionsoptions?): VersionCreateResponse` **post** `/v1/skills/{skill_id}/versions` Create Skill Version ### Parameters - `skillID: string` Unique identifier for the skill. The format and length of IDs may change over time. - `params: VersionCreateParams` - `files?: Array | null` 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. - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `VersionCreateResponse` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```typescript import Anthropic from '@anthropic-ai/sdk'; const client = new Anthropic({ apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted }); const version = await client.beta.skills.versions.create('skill_id'); console.log(version.id); ``` #### Response ```json { "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" } ``` ## List Skill Versions `client.beta.skills.versions.list(stringskillID, VersionListParamsparams?, RequestOptionsoptions?): PageCursor` **get** `/v1/skills/{skill_id}/versions` List Skill Versions ### Parameters - `skillID: string` Unique identifier for the skill. The format and length of IDs may change over time. - `params: VersionListParams` - `limit?: number | null` Query param: Number of items to return per page. Defaults to `20`. Ranges from `1` to `1000`. - `page?: string | null` Query param: Optionally set to the `next_page` token from the previous response. - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `VersionListResponse` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```typescript import Anthropic from '@anthropic-ai/sdk'; const client = new Anthropic({ apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const versionListResponse of client.beta.skills.versions.list('skill_id')) { console.log(versionListResponse.id); } ``` #### Response ```json { "data": [ { "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" } ], "has_more": true, "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Download Skill Version Content `client.beta.skills.versions.download(stringversion, VersionDownloadParamsparams, RequestOptionsoptions?): Response` **get** `/v1/skills/{skill_id}/versions/{version}/content` Download a skill version's content as a zip archive. ### Parameters - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `params: VersionDownloadParams` - `skill_id: string` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `unnamed_schema_3 = Response` ### Example ```typescript import Anthropic from '@anthropic-ai/sdk'; const client = new Anthropic({ apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted }); const response = await client.beta.skills.versions.download('version', { skill_id: 'skill_id' }); console.log(response); const content = await response.blob(); console.log(content); ``` ## Get Skill Version `client.beta.skills.versions.retrieve(stringversion, VersionRetrieveParamsparams, RequestOptionsoptions?): VersionRetrieveResponse` **get** `/v1/skills/{skill_id}/versions/{version}` Get Skill Version ### Parameters - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `params: VersionRetrieveParams` - `skill_id: string` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `VersionRetrieveResponse` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```typescript import Anthropic from '@anthropic-ai/sdk'; const client = new Anthropic({ apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted }); const version = await client.beta.skills.versions.retrieve('version', { skill_id: 'skill_id' }); console.log(version.id); ``` #### Response ```json { "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" } ``` ## Delete Skill Version `client.beta.skills.versions.delete(stringversion, VersionDeleteParamsparams, RequestOptionsoptions?): VersionDeleteResponse` **delete** `/v1/skills/{skill_id}/versions/{version}` Delete Skill Version ### Parameters - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `params: VersionDeleteParams` - `skill_id: string` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `betas?: Array` Header param: Optional header to specify the beta version(s) you want to use. - `(string & {})` - `"message-batches-2024-09-24" | "prompt-caching-2024-07-31" | "computer-use-2024-10-22" | 25 more` - `"message-batches-2024-09-24"` - `"prompt-caching-2024-07-31"` - `"computer-use-2024-10-22"` - `"computer-use-2025-01-24"` - `"pdfs-2024-09-25"` - `"token-counting-2024-11-01"` - `"token-efficient-tools-2025-02-19"` - `"output-128k-2025-02-19"` - `"files-api-2025-04-14"` - `"mcp-client-2025-04-04"` - `"mcp-client-2025-11-20"` - `"dev-full-thinking-2025-05-14"` - `"interleaved-thinking-2025-05-14"` - `"code-execution-2025-05-22"` - `"extended-cache-ttl-2025-04-11"` - `"context-1m-2025-08-07"` - `"context-management-2025-06-27"` - `"model-context-window-exceeded-2025-08-26"` - `"skills-2025-10-02"` - `"fast-mode-2026-02-01"` - `"output-300k-2026-03-24"` - `"user-profiles-2026-03-24"` - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"` - `"cache-diagnosis-2026-04-07"` - `"thinking-token-count-2026-05-13"` - `"server-side-fallback-2026-06-01"` - `"fallback-credit-2026-06-01"` ### Returns - `VersionDeleteResponse` - `id: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `type: string` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`. ### Example ```typescript import Anthropic from '@anthropic-ai/sdk'; const client = new Anthropic({ apiKey: process.env['ANTHROPIC_API_KEY'], // This is the default and can be omitted }); const version = await client.beta.skills.versions.delete('version', { skill_id: 'skill_id' }); console.log(version.id); ``` #### Response ```json { "id": "1759178010641129", "type": "type" } ``` ## Domain Types ### Version Create Response - `VersionCreateResponse` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version List Response - `VersionListResponse` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version Retrieve Response - `VersionRetrieveResponse` - `id: string` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: string` ISO 8601 timestamp of when the skill version was created. - `description: string` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: string` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: string` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: string` Identifier for the skill that this version belongs to. - `type: string` Object type. For Skill Versions, this is always `"skill_version"`. - `version: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version Delete Response - `VersionDeleteResponse` - `id: string` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `type: string` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`.