Rensei docs
API ReferenceWorker Protocol

Publish a local plugin source version

Called by the daemon to register a new version of a locally-developed plugin. Validates the manifest, creates or updates the plugin record in the registry, and links the tarball URL if provided. Only `local-path` source-class mounts are accepted. Auth: `Bearer rsk_*` via `getCliOrSessionAuth`. The mount's `scopeOwnerId` must match the caller's `orgId`. Publish authority: human callers need the org admin or owner role; plain `api_key` callers need the `plugins:publish` scope; `oauth_agent` and registration-bound credentials are refused. Every publish appends a `plugin.published` audit event.

POST
/api/daemon/plugin-sources/{id}/publish

Authorization

rsk_Bearer
headerAuthorizationBearer <rsk_live_*>

Rensei API key presented as Authorization: Bearer rsk_live_. Required API-key scopes are recorded per operation in x-rensei-required-scopes.

Path Parameters

id*string

Plugin source mount ID.

Request Body

application/json
  1. body
manifest*

Plugin manifest (apiVersion rensei.dev/v1; metadata.id and metadata.version required).

tarballUrl?string

Download URL for the plugin tarball.

Formaturi
tarballSha256?string

SHA-256 hex digest of the tarball for integrity verification.

Response Body

Plugin version published.

application/json
  1. response
ok*true
Value intrue
pluginId*string
version*string
mountId*string
Example Request
curl -X POST 'https://app.rensei.ai/api/daemon/plugin-sources/string/publish' \  -H 'Content-Type: application/json' \  -d '{  "manifest": {}}'
Example Response
{  "ok": true,  "pluginId": "string",  "version": "string",  "mountId": "string"}