v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-261319281.7 MB

Create Skill

post/v1/skills?beta=true

Headers

anthropic-betastring

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.

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.

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

created_atstring required

ISO 8601 timestamp of when the skill was created.

display_titlestring nullable required

Display title for the skill.

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

idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

latest_versionstring nullable required

The latest version identifier for the skill.

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

sourcestring required

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

typestring required

Object type.

For Skills, this is always "skill".

updated_atstring required

ISO 8601 timestamp of when the skill was last updated.

Example response

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_title": "My Custom Skill",
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "latest_version": "1759178010641129",
  "source": "custom",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}