Create Skill

POST /v1/skills?beta=true

Copy endpoint

https://api.anthropic.com

Parameters

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 BetaBodyCreateSkillV1SkillsPost {
display_title?: string | null;
files?: string[] | null;
}

Responses

200 application/json

Successful Response

interface BetaCreateSkillResponse {
created_at: string;
display_title: string | null;
id: string;
latest_version: string | null;
source: string;
type: string;
updated_at: 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";
}