---
title: "Changes to Create Skill"
method: POST
path: "/v1/skills"
---

# Changes to Create Skill

`POST /v1/skills`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 250 revisions.

- **2026-10-08** `047ff2a727d5`: 2 breaking, 10 info
- **2026-09-04** `4789294140a2`: 17 info
- **2026-08-19** `67ee007cda1c`: 1 info
- **2026-04-24** `2d9a6272c569`: 1 breaking

## Changes

- **2026-10-08** `047ff2a727d5`: 2 breaking, 10 info
  - the `error` response's property type changed from no type to `object` for status `400`
  - the `error` response's property type changed from no type to `object` for status `503`
  - added the optional property `error/details` to the response with the `400` status
  - added the optional property `error/details` to the response with the `503` status
  - removed discriminator from `error` response property for the response status `400`
  - removed discriminator from `error` response property for the response status `503`
  - removed `#/components/schemas/InvalidRequestError, #/components/schemas/AuthenticationError, #/components/schemas/BillingError, #/components/schemas/PermissionError, #/components/schemas/NotFoundError, #/components/schemas/RateLimitError, #/components/schemas/GatewayTimeoutError, #/components/schemas/APIError, #/components/schemas/OverloadedError` from the `error` response property `oneOf` list for the response status `400`
  - removed `#/components/schemas/InvalidRequestError, #/components/schemas/AuthenticationError, #/components/schemas/BillingError, #/components/schemas/PermissionError, #/components/schemas/NotFoundError, #/components/schemas/RateLimitError, #/components/schemas/GatewayTimeoutError, #/components/schemas/APIError, #/components/schemas/OverloadedError` from the `error` response property `oneOf` list for the response status `503`
  - added the required property `error/message` to the response with the `400` status
  - added the required property `error/message` to the response with the `503` status
  - added the required property `error/type` to the response with the `400` status
  - added the required property `error/type` to the response with the `503` status
- **2026-09-04** `4789294140a2`: 17 info
  - added the new optional `header` request parameter `anthropic-workspace-id`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `408`
  - added the non-success response with the status `409`
  - added the non-success response with the status `412`
  - added the non-success response with the status `413`
  - added the non-success response with the status `429`
  - added the non-success response with the status `431`
  - added the non-success response with the status `499`
  - added the non-success response with the status `500`
  - added the non-success response with the status `501`
  - added the non-success response with the status `503`
  - added the non-success response with the status `504`
  - added the non-success response with the status `529`
- **2026-08-19** `67ee007cda1c`: 1 info
  - endpoint added
- **2026-04-24** `2d9a6272c569`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/anthropics/apis/anthropic-api/docs/v1/skills/post.md) - [API](https://skmtc.dev/anthropics/apis/anthropic-api.md) - [Page](https://skmtc.dev/anthropics/apis/anthropic-api/changes/v1/skills/post)