---
title: "Update a skill"
method: PATCH
path: "/v1/fleet/skills/{skillID}"
tags: ["skills"]
---

# Update a skill

`PATCH /v1/fleet/skills/{skillID}`

Applies a sparse patch to the skill's file tree. Each entry in
`files` is keyed by relative path: a non-null value upserts
that file, an explicit null deletes it, and absent paths are
left unchanged. SKILL.md cannot be deleted via this endpoint —
use DELETE on the skill instead. Skills support file entries
only — linked agent/skill entries are rejected. The commit is
atomic: on validation failure no changes are applied.

## Path parameters

- `skillID` string, required

## Request body

- SkillsUpdateSkillRequest
  - `files` object, required

## Response `200`

OK

- SkillsSkill
  - `commit_hash` string
  - `commit_id` string
  - `created_at` string
  - `files` object
  - `id` string
  - `name` string
  - `owners` SkillsSkillOwner[]
    - `created_at` string
    - `email` string
    - `full_name` string
    - `identity_id` string
    - `ls_user_id` string
  - `updated_at` string
  - `visibility` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)