Skills

Create Skill

post /v1/skills

Create Skill

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

id: string

Unique identifier for the skill.

The format and length of IDs may change over time.
created_at: string

ISO 8601 timestamp of when the skill was created.
display_title: string

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.
latest_version: string

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.
source: string

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
type: string

Object type.

For Skills, this is always "skill".
updated_at: string

ISO 8601 timestamp of when the skill was last updated.

Example

curl https://api.anthropic.com/v1/skills \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "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

get /v1/skills

List Skills

Query Parameters

limit: optional number

Number of results to return per page.

Maximum value is 100. Defaults to 20.
page: optional string

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.
source: optional string

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

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

data: array of object { id, created_at, display_title, 4 more }

List of skills.
- id: string
  
  Unique identifier for the skill.
  
  The format and length of IDs may change over time.
- created_at: string
  
  ISO 8601 timestamp of when the skill was created.
- display_title: string
  
  Display title for the skill.
  
  This is a human-readable label that is not included in the prompt sent to the model.
- latest_version: string
  
  The latest version identifier for the skill.
  
  This represents the most recent version of the skill that has been created.
- source: string
  
  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
- type: string
  
  Object type.
  
  For Skills, this is always "skill".
- updated_at: string
  
  ISO 8601 timestamp of when the skill was last updated.
has_more: boolean

Whether there are more results available.

If true, there are additional results that can be fetched using the next_page token.
next_page: string

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

curl https://api.anthropic.com/v1/skills \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "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

get /v1/skills/{skill_id}

Get Skill

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

id: string

Unique identifier for the skill.

The format and length of IDs may change over time.
created_at: string

ISO 8601 timestamp of when the skill was created.
display_title: string

Display title for the skill.

This is a human-readable label that is not included in the prompt sent to the model.
latest_version: string

The latest version identifier for the skill.

This represents the most recent version of the skill that has been created.
source: string

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
type: string

Object type.

For Skills, this is always "skill".
updated_at: string

ISO 8601 timestamp of when the skill was last updated.

Example

curl https://api.anthropic.com/v1/skills/$SKILL_ID \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "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

delete /v1/skills/{skill_id}

Delete Skill

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

id: string

Unique identifier for the skill.

The format and length of IDs may change over time.
type: string

Deleted object type.

For Skills, this is always "skill_deleted".

Example

curl https://api.anthropic.com/v1/skills/$SKILL_ID \
    -X DELETE \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "type": "type"
}

Domain Types

Skill Create Response

SkillCreateResponse object { id, created_at, display_title, 4 more }
- id: string
  
  Unique identifier for the skill.
  
  The format and length of IDs may change over time.
- created_at: string
  
  ISO 8601 timestamp of when the skill was created.
- display_title: string
  
  Display title for the skill.
  
  This is a human-readable label that is not included in the prompt sent to the model.
- latest_version: string
  
  The latest version identifier for the skill.
  
  This represents the most recent version of the skill that has been created.
- source: string
  
  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
- type: string
  
  Object type.
  
  For Skills, this is always "skill".
- updated_at: string
  
  ISO 8601 timestamp of when the skill was last updated.

Skill List Response

SkillListResponse object { id, created_at, display_title, 4 more }
- id: string
  
  Unique identifier for the skill.
  
  The format and length of IDs may change over time.
- created_at: string
  
  ISO 8601 timestamp of when the skill was created.
- display_title: string
  
  Display title for the skill.
  
  This is a human-readable label that is not included in the prompt sent to the model.
- latest_version: string
  
  The latest version identifier for the skill.
  
  This represents the most recent version of the skill that has been created.
- source: string
  
  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
- type: string
  
  Object type.
  
  For Skills, this is always "skill".
- updated_at: string
  
  ISO 8601 timestamp of when the skill was last updated.

Skill Retrieve Response

SkillRetrieveResponse object { id, created_at, display_title, 4 more }
- id: string
  
  Unique identifier for the skill.
  
  The format and length of IDs may change over time.
- created_at: string
  
  ISO 8601 timestamp of when the skill was created.
- display_title: string
  
  Display title for the skill.
  
  This is a human-readable label that is not included in the prompt sent to the model.
- latest_version: string
  
  The latest version identifier for the skill.
  
  This represents the most recent version of the skill that has been created.
- source: string
  
  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
- type: string
  
  Object type.
  
  For Skills, this is always "skill".
- updated_at: string
  
  ISO 8601 timestamp of when the skill was last updated.

Skill Delete Response

SkillDeleteResponse object { id, type }
- id: string
  
  Unique identifier for the skill.
  
  The format and length of IDs may change over time.
- type: string
  
  Deleted object type.
  
  For Skills, this is always "skill_deleted".

Versions

Create Skill Version

post /v1/skills/{skill_id}/versions

Create Skill Version

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

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

curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
    -X POST \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "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

get /v1/skills/{skill_id}/versions

List Skill Versions

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.

Query Parameters

limit: optional number

Number of items to return per page.

Defaults to 20. Ranges from 1 to 1000.
page: optional string

Optionally set to the next_page token from the previous response.

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

data: array of object { id, created_at, description, 5 more }

List of skill versions.
- 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").
has_more: boolean

Indicates if there are more results in the requested page direction.
next_page: string

Token to provide in as page in the subsequent request to retrieve the next page of data.

Example

curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "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

get /v1/skills/{skill_id}/versions/{version}/content

Download a skill version's content as a zip archive.

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.
version: string

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Example

curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Get Skill Version

get /v1/skills/{skill_id}/versions/{version}

Get Skill Version

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.
version: string

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

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

curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "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

delete /v1/skills/{skill_id}/versions/{version}

Delete Skill Version

Path Parameters

skill_id: string

Unique identifier for the skill.

The format and length of IDs may change over time.
version: string

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Header Parameters

"anthropic-beta": optional array of AnthropicBeta

Optional header to specify the beta version(s) you want to use.
- string
- "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 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"

Returns

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

curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -X DELETE \
    -H 'anthropic-version: 2023-06-01' \
    -H 'anthropic-beta: skills-2025-10-02' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

Response

{
  "id": "1759178010641129",
  "type": "type"
}

Domain Types

Version Create Response

VersionCreateResponse object { id, created_at, description, 5 more }
- 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 object { id, created_at, description, 5 more }
- 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 object { id, created_at, description, 5 more }
- 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 object { id, type }
- 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".