Deploy extension version

POST

/ui-extensions/registry/{id}/deploy

Last modified:2026-10-06 20:29:20

OperationId:deployUiExtensionVersion

Fetches a bundle, analyzes it, and makes it the live version when it passes. Requires Reseller, Super User, or Admin Super User scope. A Reseller can deploy only its own extensions.

The result is in status: approved and flagged go live; rejected changes nothing live. A host that is not in approved-cdn-origins, or a bundle that cannot be fetched, is also answered 200 with status: rejected; the report says why. When the bytes match the live version, the answer is unchanged and nothing is written, so a build pipeline can call this on every run.

On development servers, a localhost or 127.0.0.1 URL is not fetched or analyzed: it goes live as dev, without an integrity hash.

Each extension allows 10 deploys a minute. promoted: true means the version was accepted and takes effect shortly after; send synchronous=yes to wait for it.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The verdict, or unchanged.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠409Conflict

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

cURL

ApprovedMajor version, wait for itRejectedUnchanged

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/ui-extensions/registry/call-notes/deploy' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "remote_entry_url": "https://cdn.example.com/call-notes/remoteEntry.js",
    "source_map_url": "https://cdn.example.com/call-notes/remoteEntry.js.map"
}'

Response Example

200 - Approved

{
    "version_id": "9a8b7c6d5e4f40312a1b2c3d4e5f6a7b",
    "version": "1.2.1",
    "status": "approved",
    "has_chunk_sri": "yes",
    "promoted": true,
    "unchanged": false,
    "report": {
        "findings": []
    }
}

Modified at 2026-10-06 20:29:20

Reanalyze extension versions

List inboxes