Search + K

Command Palette

Search for a command to run...

Sign In

Create Skill Version

POST /v1/skills/{skill_id}/versions?beta=true
Copy endpoint
https://api.anthropic.com

Parameters

path Path Parameters

Name Type
skill_id required

Unique identifier for the skill.

The format and length of IDs may change over time.

string

header Header Parameters

Name Type
anthropic-beta

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

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

string
anthropic-version

The version of the Claude API you want to use.

Read more about versioning and our version history here.

string

Request Body

multipart/form-data
interface BetaBodyCreateSkillVersionV1SkillsSkillIdVersionsPost {
files?: string[] | null;
}

Responses

200 application/json

Successful Response

interface BetaCreateSkillVersionResponse {
created_at: string;
description: string;
directory: string;
id: string;
name: string;
skill_id: string;
type: string;
version: string;
}

Client Errors

4XX application/json

Error response.

See our errors documentation for more details.

interface BetaErrorResponse {
error: BetaInvalidRequestError
interface BetaInvalidRequestError {
message: string;
type: "invalid_request_error";
}
| BetaAuthenticationError
interface BetaAuthenticationError {
message: string;
type: "authentication_error";
}
| BetaBillingError
interface BetaBillingError {
message: string;
type: "billing_error";
}
| BetaPermissionError
interface BetaPermissionError {
message: string;
type: "permission_error";
}
| BetaNotFoundError
interface BetaNotFoundError {
message: string;
type: "not_found_error";
}
| BetaRateLimitError
interface BetaRateLimitError {
message: string;
type: "rate_limit_error";
}
| BetaGatewayTimeoutError
interface BetaGatewayTimeoutError {
message: string;
type: "timeout_error";
}
| BetaAPIError
interface BetaAPIError {
message: string;
type: "api_error";
}
| BetaOverloadedError
interface BetaOverloadedError {
message: string;
type: "overloaded_error";
}
;
request_id: string | null;
type: "error";
}