Skip to main content
GET/extensions-admin

List Extensions

Returns the list of extensions currently enabled (or previously installed) on the specified project, including each extension's status, manifest version, enabled-at timestamp, and permission grants.

This is the project-scoped view; it shows only extensions relevant to this project, not the full org registry.

Requires at minimum PROJECT_VIEWER authentication.

Parameters
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 listing extensions on this project; at least PROJECT_VIEWER is required.
Response body (200)
data *object[]

The extensions installed on the project, oldest first.

Purged installs are left out.

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
cli *object[]

The command-line verbs the extension declares.

Empty when it declares none.

verb *string

The command word.

summary *string

A one-line description.

invokes *string

The extension route the command calls, as METHOD:path.

argsobject[]

The command's arguments.

name *string

The argument's name.

summary *string

A one-line description.

position *"positional" | "flag"

positional or flag.

type *"string" | "number" | "boolean" | "json"

The value's type.

requiredboolean

Whether the argument must be given.

bind"path" | "query" | "body"

Where the value goes in the extension route's request.

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
deployment *any
One of: "ready" | "deploying" | "unavailable"
or: null
meta *any
cURL
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/extensions-admin' \
  -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",
      "cli": [
        {
          "verb": "string",
          "summary": "string",
          "invokes": "string",
          "args": [
            {}
          ]
        }
      ],
      "updateAvailable": false,
      "latestVersion": "string",
      "updateBumpType": "major",
      "deployment": "ready"
    }
  ]
}

More in Extensions