---
title: "Update an installed skill"
method: PATCH
path: "/sandbox-configs/{id}/skills/{skillId}"
tags: ["SandboxConfig"]
---

# Update an installed skill

`PATCH /sandbox-configs/{id}/skills/{skillId}`

Show or hide an installed skill and set the workspace-wide values of the environment variables it declared. Either field may be sent, or both. The files stay in the image either way; removal is a separate flow.

## Path parameters

- `id` string, required
- `skillId` string, required

## Request body

- InternalHandlerSkillPatchRequest
  - `enabled` boolean — Enabled is a pointer because its absence is not a request to disable the skill; a body may carry envs instead.
  - `envs` object — Envs is a pointer to a map because "sent an empty object" and "did not mention envs" are different requests: the first clears what it names, the second must leave every stored value alone.

## Response `200`

Updated skill

- object

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Skill not found

## Changes

- **2026-08-25** `8f184d39c6b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/sandbox-configs/:id/skills/:skillId/patch.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tencentblueking/weknora-api/revisions/c70887fb1bf7/schema)