---
title: "Delete workspace skill"
method: DELETE
path: "/api/workspace/skills/{skill_id}"
---

# Delete workspace skill

`DELETE /api/workspace/skills/{skill_id}`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/workspace/skills/{skill_id}`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Deletes a skill. This can't be undone, and the AI stops using the skill right away. To keep it but stop it being used, set `enabled` to `false` with [Update workspace skill](/api-reference/update-workspace-skill) instead.

Skills belong to the workspace your credential is for. With a personal access token, that's the token's workspace, and there's no parameter to choose another one.

Skills need the Builder plan or higher. Below it, this returns a `403`.

This is limited to 60 requests per minute, shared with the other endpoints that change skills. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this as an owner or admin of the workspace, with a personal access token sent as a Bearer token, or from a signed-in session. A read-only token is refused, and workspace API keys aren't accepted.</Note>

## Path parameters

- `skill_id` string, required: ID of the skill to delete. Get it from `id` in [List workspace skills](/api-reference/list-workspace-skills).

## Response `200`

The skill was deleted.

- ChangeResult: Confirms the change.
  - `status` 'success', required: Always `success`.
  - `message` string, required: Short confirmation. Its wording can change, so don't parse it.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The workspace's plan doesn't include skills, you aren't an owner or admin of the workspace, your token is read-only, or your credential can't be used on this endpoint.
- `404`: Skill not found in this workspace.
- `409`: Your workspace requires an unlocked SSO session.
- `429`: Rate limit exceeded.

## Changes

- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-10** `fc604cdcc3a2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/workspace/skills/:skill_id/delete.md)

---

[API](https://skmtc.dev/idealspot/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/idealspot/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/idealspot/apis/base44-app-management-api/revisions/b5b4ebd82a1e?raw)