---
title: "Stop a skill install"
method: POST
path: "/sandbox-configs/{id}/skills/{skillId}/stop"
tags: ["SandboxConfig"]
---

# Stop a skill install

`POST /sandbox-configs/{id}/skills/{skillId}/stop`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/sandbox-configs/{id}/skills/{skillId}/stop`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

Abort an in-flight install so the operator can retry or uninstall. After a process restart the row may still say installing with no live process; this rewrites it immediately instead of waiting for the stuck-run reaper. Removal is not stopped.

## Path parameters

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

## Response `200`

Stopped skill

- object
  - `data` InternalHandlerSkillResponse
    - `bundle_sha256` string
    - `created_at` string
    - `description` string
    - `enabled` boolean
    - `envs` InternalHandlerSkillEnvResponse[]
      - `description` string
      - `is_set` boolean
      - `name` string
      - `required` boolean
    - `error` string
    - `id` string
    - `install_message_id` string
    - `install_session_id` string
    - `installed_snapshot_id` string
    - `missing_envs` string[]: MissingEnvs names the required environment variables with no workspace value yet; the skill cannot run until they are set.
    - `name` string
    - `served` GithubComTencentWeKnoraInternalApplicationServiceSkillServedInfo
      - `version` string
    - `status` string
    - `updated_at` string
    - `version` string
  - `success` boolean

## Other responses

- `400`: Skill is not installing
- `401`: Unauthorized
- `404`: Skill not found

## Changes

- **2026-09-03** `794821c045c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/sandbox-configs/:id/skills/:skillId/stop/post.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.dev/tencentblueking/apis/weknora-api/revisions/685d1f9fce30?raw)