AnthropicClaude Managed Agents

Create Skill Version

Upload a new version of a Skill.

POST /anthropic/v1/skills/{skill_id}/versions○ Unsupported

Request parameters

  • skill_idstring必填

    path: Skill ID (path or query parameter).

  • filesarray必填

    Files to upload for the skill. All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.

Returns

501 This endpoint is not implemented yet; calling it returns the response below:

Uploading and managing Skills is not supported yet; passing skills when creating an agent returns 400. Calling it returns 501 (not_implemented_error), produces no side effects, and the official SDK does not retry.

Errors follow the Claude Managed Agents format — see error codes

Response

HTTP 200

Successful response

multipart/form-data

NameTypeDescription
idstringUnique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
created_atstringISO 8601 timestamp of when the skill was created.
descriptionstringDescription of the skill version. This is extracted from the SKILL.md file in the skill upload.
namestringThe Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter `name` (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.
skill_idstringUnique identifier for the skill. The format and length of IDs may change over time.
typestringObject type. For Skill Versions, this is always `"skill_version"`.