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 date-time required

ISO 8601 timestamp of when the skill was created.

display_namestring required

Human-readable, single-line label for the Skill. Maximum 255 characters. Always set: derived from the SKILL.md frontmatter name when omitted at creation. Not unique.

idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

latest_version_idstring required

ID of the newest Skill Version — what latest references resolve to. Always set: a Skill holds at least one version.

type'skill' required

Object type.

For Skills, this is always "skill".

updated_atstring date-time required

ISO 8601 timestamp of when the skill was last updated.

Example response

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "id": "skill_01JAbcdefghijklmnopqrstuvw",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}

Changes

Changed in 2 of the 68 revisions of this API.615

Aug 27, 2026ef8360d7d2b6315See the full diff
- ▲
  the response's property type changed from string to object for status
  response-property-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  removed the request property
  request-property-removed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  the response property const value skill was added for the status
  response-property-const-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 1, 20269c991bee394d3See the full diff
- ▲
  request body became required
  request-body-became-required
- ▲
  the request property became required
  request-property-became-required
- ▲
  request property list-of-types was narrowed by removing types null from media type multipart/form-data
  request-property-list-of-types-narrowed
This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history