Skip to main content
DELETE/extensions-admin/{slug}/disable

Disable Extension

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
slug *path
projectSlug *path

The project's slug: the path segment after @.

It is unique within the org.

Responses
HTTPK9O CodeDescription
200Success
401K9O_SESSION_EXPIREDYour session has expired; authenticate again to continue.
403K9O_ACCESS_DENIEDYour role does not permit disabling extensions on this project; a PROJECT_ADMIN role is required.
404K9O_EXTENSION_NOT_FOUNDNo extension with this slug exists in the registry.
Response body (200)
data *object
installId *string

The project's install record for the extension (xinst_...).

extensionSlug *string

The extension's slug.

projectId *string

The project's id (proj_...).

status *"disabled"

Always disabled.

functionsRetired *integer

How many of the extension's functions were switched off. 0 when it was already disabled.

mcpToolsRemoved *integer

How many of its MCP tools were removed. 0 when it was already disabled.

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

Showing example in cURL

Response example (200)
{
  "data": {
    "installId": "string",
    "extensionSlug": "string",
    "projectId": "string",
    "status": "disabled",
    "functionsRetired": 0,
    "mcpToolsRemoved": 0
  }
}

More in Extensions