Error

A valid request URL is required to generate request examples

{
  "commit_hash": "9f1e2d3c4b5a",
  "commit_id": "c_8a7b6c5d",
  "created_at": "2026-01-15T09:30:00Z",
  "description": "Researches a topic across the web and writes a brief.",
  "files": {},
  "id": "skill_3f9a2b1c",
  "name": "web-research",
  "owners": [
    {
      "created_at": "2026-01-15T09:30:00Z",
      "email": "dev@example.com",
      "full_name": "Ada Lovelace",
      "identity_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0",
      "ls_user_id": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809"
    }
  ],
  "updated_at": "2026-01-15T09:30:00Z",
  "visibility": "workspace"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Update a skill

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.

PATCH

/

v1

/

fleet

/

skills

/

{skillID}

Error

A valid request URL is required to generate request examples

{
  "commit_hash": "9f1e2d3c4b5a",
  "commit_id": "c_8a7b6c5d",
  "created_at": "2026-01-15T09:30:00Z",
  "description": "Researches a topic across the web and writes a brief.",
  "files": {},
  "id": "skill_3f9a2b1c",
  "name": "web-research",
  "owners": [
    {
      "created_at": "2026-01-15T09:30:00Z",
      "email": "dev@example.com",
      "full_name": "Ada Lovelace",
      "identity_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0",
      "ls_user_id": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809"
    }
  ],
  "updated_at": "2026-01-15T09:30:00Z",
  "visibility": "workspace"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

Path Parameters

skillID

string

required

Skill ID

Body

application/json

Sparse file patch

files

object

required

Show child attributes

Response

OK

commit_hash

string

Content hash of the current skill revision.

Example:

"9f1e2d3c4b5a"

commit_id

string

Omitted on the lightweight list (include_files=false): commit_id is not on the upstream repos-list contract, only commit_hash is.

Example:

"c_8a7b6c5d"

created_at

string

Example:

"2026-01-15T09:30:00Z"

description

string

Short summary derived from the skill's SKILL.md front matter.

Example:

"Researches a topic across the web and writes a brief."

files

object

File tree keyed by path; populated only when include_files=true.

Show child attributes

id

string

Example:

"skill_3f9a2b1c"

name

string

Example:

"web-research"

owners

object[]

Show child attributes

updated_at

string

Example:

"2026-01-15T09:30:00Z"

visibility

string

Who can see the skill: private, workspace, or public.

Example:

"workspace"

Get Fleet user in tenant