# Skills ## Create Skill `SkillCreateResponse Beta.Skills.Create(SkillCreateParams?parameters, CancellationTokencancellationToken = default)` **post** `/v1/skills` Create Skill ### Parameters - `SkillCreateParams parameters` - `string? displayTitle` Body param: Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `IReadOnlyList? 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 betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class SkillCreateResponse:` - `required string ID` Unique identifier for the skill. The format and length of IDs may change over time. - `required string CreatedAt` ISO 8601 timestamp of when the skill was created. - `required string? DisplayTitle` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `required string? LatestVersion` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `required string Source` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `required string Type` Object type. For Skills, this is always `"skill"`. - `required string UpdatedAt` ISO 8601 timestamp of when the skill was last updated. ### Example ```csharp SkillCreateParams parameters = new(); var skill = await client.Beta.Skills.Create(parameters); Console.WriteLine(skill); ``` #### Response ```json { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ``` ## List Skills `SkillListPageResponse Beta.Skills.List(SkillListParams?parameters, CancellationTokencancellationToken = default)` **get** `/v1/skills` List Skills ### Parameters - `SkillListParams parameters` - `Long limit` Query param: Number of results to return per page. Maximum value is 100. Defaults to 20. - `string? page` Query param: Pagination token for fetching a specific page of results. Pass the value from a previous response's `next_page` field to get the next page of results. - `string? source` Query param: Filter skills by source. If provided, only skills from the specified source will be returned: * `"custom"`: only return user-created skills * `"anthropic"`: only return Anthropic-created skills - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class SkillListPageResponse:` - `required IReadOnlyList Data` List of skills. - `required string ID` Unique identifier for the skill. The format and length of IDs may change over time. - `required string CreatedAt` ISO 8601 timestamp of when the skill was created. - `required string? DisplayTitle` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `required string? LatestVersion` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `required string Source` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `required string Type` Object type. For Skills, this is always `"skill"`. - `required string UpdatedAt` ISO 8601 timestamp of when the skill was last updated. - `required Boolean HasMore` Whether there are more results available. If `true`, there are additional results that can be fetched using the `next_page` token. - `required string? NextPage` Token for fetching the next page of results. If `null`, there are no more results available. Pass this value to the `page_token` parameter in the next request to get the next page. ### Example ```csharp SkillListParams parameters = new(); var page = await client.Beta.Skills.List(parameters); await foreach (var item in page.Paginate()) { Console.WriteLine(item); } ``` #### Response ```json { "data": [ { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ], "has_more": true, "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Get Skill `SkillRetrieveResponse Beta.Skills.Retrieve(SkillRetrieveParamsparameters, CancellationTokencancellationToken = default)` **get** `/v1/skills/{skill_id}` Get Skill ### Parameters - `SkillRetrieveParams parameters` - `required string skillID` Unique identifier for the skill. The format and length of IDs may change over time. - `IReadOnlyList betas` Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class SkillRetrieveResponse:` - `required string ID` Unique identifier for the skill. The format and length of IDs may change over time. - `required string CreatedAt` ISO 8601 timestamp of when the skill was created. - `required string? DisplayTitle` Display title for the skill. This is a human-readable label that is not included in the prompt sent to the model. - `required string? LatestVersion` The latest version identifier for the skill. This represents the most recent version of the skill that has been created. - `required string Source` Source of the skill. This may be one of the following values: * `"custom"`: the skill was created by a user * `"anthropic"`: the skill was created by Anthropic - `required string Type` Object type. For Skills, this is always `"skill"`. - `required string UpdatedAt` ISO 8601 timestamp of when the skill was last updated. ### Example ```csharp SkillRetrieveParams parameters = new() { SkillID = "skill_id" }; var skill = await client.Beta.Skills.Retrieve(parameters); Console.WriteLine(skill); ``` #### Response ```json { "id": "skill_01JAbcdefghijklmnopqrstuvw", "created_at": "2024-10-30T23:58:27.427722Z", "display_title": "My Custom Skill", "latest_version": "1759178010641129", "source": "custom", "type": "type", "updated_at": "2024-10-30T23:58:27.427722Z" } ``` ## Delete Skill `SkillDeleteResponse Beta.Skills.Delete(SkillDeleteParamsparameters, CancellationTokencancellationToken = default)` **delete** `/v1/skills/{skill_id}` Delete Skill ### Parameters - `SkillDeleteParams parameters` - `required string skillID` Unique identifier for the skill. The format and length of IDs may change over time. - `IReadOnlyList betas` Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class SkillDeleteResponse:` - `required string ID` Unique identifier for the skill. The format and length of IDs may change over time. - `required string Type` Deleted object type. For Skills, this is always `"skill_deleted"`. ### Example ```csharp SkillDeleteParams parameters = new() { SkillID = "skill_id" }; var skill = await client.Beta.Skills.Delete(parameters); Console.WriteLine(skill); ``` #### Response ```json { "id": "skill_01JAbcdefghijklmnopqrstuvw", "type": "type" } ``` # Versions ## Create Skill Version `VersionCreateResponse Beta.Skills.Versions.Create(VersionCreateParamsparameters, CancellationTokencancellationToken = default)` **post** `/v1/skills/{skill_id}/versions` Create Skill Version ### Parameters - `VersionCreateParams parameters` - `required string skillID` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `IReadOnlyList? 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 betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `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"). ### Example ```csharp VersionCreateParams parameters = new() { SkillID = "skill_id" }; var version = await client.Beta.Skills.Versions.Create(parameters); Console.WriteLine(version); ``` #### 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 `VersionListPageResponse Beta.Skills.Versions.List(VersionListParamsparameters, CancellationTokencancellationToken = default)` **get** `/v1/skills/{skill_id}/versions` List Skill Versions ### Parameters - `VersionListParams parameters` - `required string skillID` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `Long? limit` Query param: Number of items to return per page. Defaults to `20`. Ranges from `1` to `1000`. - `string? page` Query param: Optionally set to the `next_page` token from the previous response. - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class VersionListPageResponse:` - `required IReadOnlyList Data` List of skill versions. - `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"). - `required Boolean HasMore` Indicates if there are more results in the requested page direction. - `required string? NextPage` Token to provide in as `page` in the subsequent request to retrieve the next page of data. ### Example ```csharp VersionListParams parameters = new() { SkillID = "skill_id" }; var page = await client.Beta.Skills.Versions.List(parameters); await foreach (var item in page.Paginate()) { Console.WriteLine(item); } ``` #### 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 `HttpResponse Beta.Skills.Versions.Download(VersionDownloadParamsparameters, CancellationTokencancellationToken = default)` **get** `/v1/skills/{skill_id}/versions/{version}/content` Download a skill version's content as a zip archive. ### Parameters - `VersionDownloadParams parameters` - `required string skillID` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `required string version` Path param: Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Example ```csharp VersionDownloadParams parameters = new() { SkillID = "skill_id", Version = "version", }; var response = await client.Beta.Skills.Versions.Download(parameters); Console.WriteLine(response); ``` ## Get Skill Version `VersionRetrieveResponse Beta.Skills.Versions.Retrieve(VersionRetrieveParamsparameters, CancellationTokencancellationToken = default)` **get** `/v1/skills/{skill_id}/versions/{version}` Get Skill Version ### Parameters - `VersionRetrieveParams parameters` - `required string skillID` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `required string version` Path param: Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class VersionRetrieveResponse:` - `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"). ### Example ```csharp VersionRetrieveParams parameters = new() { SkillID = "skill_id", Version = "version", }; var version = await client.Beta.Skills.Versions.Retrieve(parameters); Console.WriteLine(version); ``` #### 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 `VersionDeleteResponse Beta.Skills.Versions.Delete(VersionDeleteParamsparameters, CancellationTokencancellationToken = default)` **delete** `/v1/skills/{skill_id}/versions/{version}` Delete Skill Version ### Parameters - `VersionDeleteParams parameters` - `required string skillID` Path param: Unique identifier for the skill. The format and length of IDs may change over time. - `required string version` Path param: Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` - `"server-side-fallback-2026-06-01"ServerSideFallback2026_06_01` - `"fallback-credit-2026-06-01"FallbackCredit2026_06_01` ### Returns - `class VersionDeleteResponse:` - `required string ID` Version identifier for the skill. Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - `required string Type` Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`. ### Example ```csharp VersionDeleteParams parameters = new() { SkillID = "skill_id", Version = "version", }; var version = await client.Beta.Skills.Versions.Delete(parameters); Console.WriteLine(version); ``` #### Response ```json { "id": "1759178010641129", "type": "type" } ```