Skip to main content
PATCH/extensions-admin/{slug}/config

Update Extension Config

Updates per-extension configuration for the specified project and fires the configure lifecycle hook (best-effort, single attempt).

The configuration payload is extension-defined; the platform delivers it to the extension's hooks.configure.url handler along with the current permission grants.

Requires PROJECT_ADMIN.

Parameters
slug *path
projectSlug *path

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

It is unique within the org.

Request body
Responses
HTTPK9O CodeDescription
200Success
401K9O_SESSION_EXPIREDYour session has expired; authenticate again to continue.
403K9O_ACCESS_DENIEDYour role does not permit updating extension configuration 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_...).

config *object

The install's whole configuration after the merge, as name to value.

meta *any
cURL
curl -X PATCH 'https://<org>.api-<region>.k9o.io/@storefront/extensions-admin/demoext/config' \
  -H 'Authorization: Bearer $K9O_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'

Showing example in cURL

Request example
Response example (200)
{
  "data": {
    "installId": "string",
    "extensionSlug": "string",
    "projectId": "string"
  }
}

More in Extensions