---
title: "Uninstall a disabled extension"
method: DELETE
path: "/api/extensions/{id}"
tags: ["Extensions"]
---

# Uninstall a disabled extension

`DELETE /api/extensions/{id}`

Workers may uninstall their own disabled extensions. Leads, operators, and dashboard users retain access to all extensions.

## Path parameters

- `id` string, required

## Response `200`

Extension uninstalled

- object
  - `deleted` true, required
  - `assets` object, required
    - `deleted` object[], required
      - `kind` 'script' | 'schedule' | 'workflow' | 'skill', required
      - `name` string, required
    - `detached` object[], required
      - `kind` 'script' | 'schedule' | 'workflow' | 'skill', required
      - `name` string, required

## Other responses

- `403` — Permission denied
- `404` — Extension not found
- `409` — Enabled extensions cannot be uninstalled

## Changes

- **2026-09-24** `ad817d2e687d` — 1 info
  - added the required property `assets` to the response with the `200` status
- **2026-09-16** `3f6e56391f84` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/extensions/:id/delete.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/01e2386c97da?raw)