---
title: "Remove an installed skill from the workspace"
method: DELETE
path: "/v1/skill-installations/{installation_id}"
tags: ["skill-hub"]
---

# Remove an installed skill from the workspace

`DELETE /v1/skill-installations/{installation_id}`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/skill-installations/{installation_id}`
- Auth: HTTP bearer

Uninstall ONE skill. A skills:delete holder (owner/admin, or a delete-scoped API key) removes ANY install; anyone else may remove only their OWN personal install — a TEAM install answers 403, and another member's personal install already 404s like a missing one (the same fence every installation-id route applies). A hard delete: the install's settings and its occurrence history cascade away with it, and it cannot be undone. A built-in skill is not removable: the route returns 409 and says to pause it instead. For other skills, the skill can be installed again from the catalog, but it comes back unconfigured. For a skill the trusted catalog enables by default, removing the install discards the workspace's override, so the skill returns to running with catalog defaults. Refused with a 409 while another installed skill declares this one as a dependency, so removing it can never leave a kept skill broken.

## Path parameters

- `installation_id` string, uuid, required

## Headers

- `X-Tenant-Id` string, nullable

## Response `204`

Successful Response

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `409`: Conflict
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)