# Disable Extension

`DELETE /extensions-admin/{slug}/disable` · Core · Extensions

Disables an enabled extension on the specified project. The per-project plugin token is revoked, in-flight hook deliveries are cancelled, and the `deactivate` lifecycle hook fires (best-effort, single attempt). The per-project SQL schema and data are **preserved** by default; a subsequent re-enable resumes against the existing data. This is distinct from purge — no data is destroyed. Requires `PROJECT_ADMIN`.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `slug` | path | yes |  Example: `"demoext"`. |
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | object | yes |  |
| `data.installId` | string | yes | The project's install record for the extension (`xinst_...`). |
| `data.extensionSlug` | string | yes | The extension's slug. |
| `data.projectId` | string | yes | The project's id (`proj_...`). |
| `data.status` | enum ("disabled") | yes | Always `disabled`. |
| `data.functionsRetired` | integer | yes | How many of the extension's functions were switched off. 0 when it was already disabled. |
| `data.mcpToolsRemoved` | integer | yes | How many of its MCP tools were removed. 0 when it was already disabled. |
| `meta` | object | yes |  |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_SESSION_EXPIRED` | Your session has expired; authenticate again to continue. |
| 403 | `K9O_ACCESS_DENIED` | Your role does not permit disabling extensions on this project; a PROJECT_ADMIN role is required. |
| 404 | `K9O_EXTENSION_NOT_FOUND` | No extension with this slug exists in the registry. |

## Code samples

### cURL

```bash
curl -X DELETE 'https://<org>.api-<region>.k9o.io/@storefront/extensions-admin/demoext/disable' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/extensions-admin/demoext/disable', {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/disable-extension
