---
title: "Changes to Install a skill"
method: POST
path: "/api/v1beta/skills"
---

# Changes to Install a skill

`POST /api/v1beta/skills`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 56 revisions.

- **2026-09-08** `022455c26a63`: 2 info
- **2026-08-17** `a7011540b058`: 2 info
- **2026-08-05** `43b22ce40564`: 1 info
- **2026-07-29** `3db2b10a01f6`: 1 info
- **2026-04-23** `d5a1987b7457`: 4 info
- **2026-04-21** `ead8d06eaeaa`: 1 info
- **2026-04-13** `3b31034fd29e`: 1 warning, 1 info
- **2026-03-17** `8ab2f5690c97`: 1 breaking, 1 info
- **2026-03-06** `b2b0a6a97af8`: 1 info
- **2026-03-05** `7ddc75dcd1f4`: 1 info
- **2026-02-20** `cb830b4f4217`: 2 info
- **2026-02-17** `28f7cf2e2c81`: 1 info
- **2026-01-29** `ff6ce8dd8f3a`: 1 breaking

## Changes

- **2026-09-08** `022455c26a63`: 2 info
  - added the new optional request property `oneOf[#/components/schemas/pkg_api_v1.installSkillRequest]/public_key`
  - added the optional property `provenance/public_key` to the response with the `201` status
- **2026-08-17** `a7011540b058`: 2 info
  - added the optional property `provenance` to the response with the `201` status
  - added the optional property `unsigned` to the response with the `201` status
- **2026-08-05** `43b22ce40564`: 1 info
  - added the new optional request property `oneOf[#/components/schemas/pkg_api_v1.installSkillRequest]/allow_unsigned`
- **2026-07-29** `3db2b10a01f6`: 1 info
  - added the optional property `skill/managed` to the response with the `201` status
- **2026-04-23** `d5a1987b7457`: 4 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `504`
- **2026-04-21** `ead8d06eaeaa`: 1 info
  - added the non-success response with the status `502`
- **2026-04-13** `3b31034fd29e`: 1 warning, 1 info
  - removed the request property `oneOf[#/components/schemas/pkg_api_v1.installSkillRequest]/client`
  - added the new optional request property `oneOf[#/components/schemas/pkg_api_v1.installSkillRequest]/clients`
- **2026-03-17** `8ab2f5690c97`: 1 breaking, 1 info
  - removed `#/components/schemas/v1.installSkillRequest` from the request body `oneOf` list
  - added `#/components/schemas/pkg_api_v1.installSkillRequest` to the request body `oneOf` list
- **2026-03-06** `b2b0a6a97af8`: 1 info
  - added the new optional request property `oneOf[#/components/schemas/v1.installSkillRequest]/group`
- **2026-03-05** `7ddc75dcd1f4`: 1 info
  - added the new optional request property `oneOf[#/components/schemas/v1.installSkillRequest]/project_root`
- **2026-02-20** `cb830b4f4217`: 2 info
  - added the new optional request property `oneOf[#/components/schemas/v1.installSkillRequest]/client`
  - added the new optional request property `oneOf[#/components/schemas/v1.installSkillRequest]/force`
- **2026-02-17** `28f7cf2e2c81`: 1 info
  - endpoint added
- **2026-01-29** `ff6ce8dd8f3a`: 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/stacklok/apis/toolhive-api/docs/api/v1beta/skills/post.md) - [API](https://skmtc.dev/stacklok/apis/toolhive-api.md) - [Page](https://skmtc.dev/stacklok/apis/toolhive-api/changes/api/v1beta/skills/post)