# Versions ## Create Skill Version `beta.skills.versions.create(strskill_id, VersionCreateParams**kwargs) -> VersionCreateResponse` **post** `/v1/skills/{skill_id}/versions` Create Skill Version ### Parameters - `skill_id: str` Unique identifier for the skill. The format and length of IDs may change over time. - `files: Optional[Sequence[FileTypes]]` 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: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - `Literal["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 - `class VersionCreateResponse: …` - `id: str` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: str` ISO 8601 timestamp of when the skill version was created. - `description: str` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: str` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: str` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: str` Identifier for the skill that this version belongs to. - `type: str` Object type. For Skill Versions, this is always `"skill_version"`. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```python import os from anthropic import Anthropic client = Anthropic( api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted ) version = client.beta.skills.versions.create( skill_id="skill_id", ) print(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 `beta.skills.versions.list(strskill_id, VersionListParams**kwargs) -> SyncPageCursor[VersionListResponse]` **get** `/v1/skills/{skill_id}/versions` List Skill Versions ### Parameters - `skill_id: str` Unique identifier for the skill. The format and length of IDs may change over time. - `limit: Optional[int]` Number of items to return per page. Defaults to `20`. Ranges from `1` to `1000`. - `page: Optional[str]` Optionally set to the `next_page` token from the previous response. - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - `Literal["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 - `class VersionListResponse: …` - `id: str` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: str` ISO 8601 timestamp of when the skill version was created. - `description: str` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: str` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: str` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: str` Identifier for the skill that this version belongs to. - `type: str` Object type. For Skill Versions, this is always `"skill_version"`. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```python import os from anthropic import Anthropic client = Anthropic( api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted ) page = client.beta.skills.versions.list( skill_id="skill_id", ) page = page.data[0] print(page.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 `beta.skills.versions.download(strversion, VersionDownloadParams**kwargs) -> BinaryResponseContent` **get** `/v1/skills/{skill_id}/versions/{version}/content` Download a skill version's content as a zip archive. ### Parameters - `skill_id: str` Unique identifier for the skill. The format and length of IDs may change over time. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - `Literal["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 - `BinaryResponseContent` ### Example ```python import os from anthropic import Anthropic client = Anthropic( api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted ) response = client.beta.skills.versions.download( version="version", skill_id="skill_id", ) print(response) content = response.read() print(content) ``` ## Get Skill Version `beta.skills.versions.retrieve(strversion, VersionRetrieveParams**kwargs) -> VersionRetrieveResponse` **get** `/v1/skills/{skill_id}/versions/{version}` Get Skill Version ### Parameters - `skill_id: str` Unique identifier for the skill. The format and length of IDs may change over time. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - `Literal["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 - `class VersionRetrieveResponse: …` - `id: str` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: str` ISO 8601 timestamp of when the skill version was created. - `description: str` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: str` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: str` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: str` Identifier for the skill that this version belongs to. - `type: str` Object type. For Skill Versions, this is always `"skill_version"`. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Example ```python import os from anthropic import Anthropic client = Anthropic( api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted ) version = client.beta.skills.versions.retrieve( version="version", skill_id="skill_id", ) print(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 `beta.skills.versions.delete(strversion, VersionDeleteParams**kwargs) -> VersionDeleteResponse` **delete** `/v1/skills/{skill_id}/versions/{version}` Delete Skill Version ### Parameters - `skill_id: str` Unique identifier for the skill. The format and length of IDs may change over time. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `betas: Optional[List[AnthropicBetaParam]]` Optional header to specify the beta version(s) you want to use. - `str` - `Literal["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 - `class VersionDeleteResponse: …` - `id: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `type: str` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`. ### Example ```python import os from anthropic import Anthropic client = Anthropic( api_key=os.environ.get("ANTHROPIC_API_KEY"), # This is the default and can be omitted ) version = client.beta.skills.versions.delete( version="version", skill_id="skill_id", ) print(version.id) ``` #### Response ```json { "id": "1759178010641129", "type": "type" } ``` ## Domain Types ### Version Create Response - `class VersionCreateResponse: …` - `id: str` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: str` ISO 8601 timestamp of when the skill version was created. - `description: str` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: str` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: str` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: str` Identifier for the skill that this version belongs to. - `type: str` Object type. For Skill Versions, this is always `"skill_version"`. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version List Response - `class VersionListResponse: …` - `id: str` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: str` ISO 8601 timestamp of when the skill version was created. - `description: str` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: str` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: str` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: str` Identifier for the skill that this version belongs to. - `type: str` Object type. For Skill Versions, this is always `"skill_version"`. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version Retrieve Response - `class VersionRetrieveResponse: …` - `id: str` Unique identifier for the skill version. The format and length of IDs may change over time. - `created_at: str` ISO 8601 timestamp of when the skill version was created. - `description: str` Description of the skill version. This is extracted from the SKILL.md file in the skill upload. - `directory: str` Directory name of the skill version. This is the top-level directory name that was extracted from the uploaded files. - `name: str` Human-readable name of the skill version. This is extracted from the SKILL.md file in the skill upload. - `skill_id: str` Identifier for the skill that this version belongs to. - `type: str` Object type. For Skill Versions, this is always `"skill_version"`. - `version: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). ### Version Delete Response - `class VersionDeleteResponse: …` - `id: str` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `type: str` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`.