Skip to main content
GET/extensions-admin/{slug}

Get Extension

Returns the per-project enable record for the specified extension on this project — including the enable status, current manifest version, permission grants, schema name, and the hookSecret (HMAC shared secret for hook signature verification).

This endpoint allows the extension to recover the hookSecret after a process restart without requiring a disable and re-enable cycle.

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 retrieving extension detail on this project; a PROJECT_ADMIN role is required for the hookSecret field.
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_...).

extensionId *string

The extension's id in the org's registry (ext_...).

extensionSlug *string

The extension's slug.

manifestVersion *string

The version installed on this project.

status *"queued" | "installing" | "enabled" | "disabled" | "purged" | "failed" | "stalled"

The install's state: enabled and disabled are the settled states; queued and installing while it is being set up; failed or stalled when setup did not finish; purged once its data is destroyed.

enabledAt *string <date-time>

When the install was first enabled (ISO 8601 UTC).

disabledAt *any
One of: string <date-time>
or: null
config *object

The install's configuration, as name to value.

updateAvailable *boolean

True when the org's registry holds a newer version than the one installed, and the install is enabled.

latestVersion *any
One of: string
or: null
updateBumpType *any
One of: "major" | "minor" | "patch"
or: null
meta *any
cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/extensions-admin/demoext' \
  -H 'Authorization: Bearer $K9O_TOKEN'

Showing example in cURL

Response example (200)
{
  "data": {
    "installId": "string",
    "extensionId": "string",
    "extensionSlug": "string",
    "manifestVersion": "string",
    "status": "queued",
    "enabledAt": "string",
    "disabledAt": "string",
    "updateAvailable": false,
    "latestVersion": "string",
    "updateBumpType": "major"
  }
}

More in Extensions