Skip to main content
POST
Install a marketplace plugin

Authorizations

x-api-key
string
header
required

Body

application/json

Install a marketplace plugin by ref, optionally pinning a version.

env / secret_keys are accepted for an install whose spec declares install-time env (an mcp entry's required !ENV markers or an oauth connector's client-credential env): these values are written to the env store in the same transaction that writes the provides entry (never deferred), and secret_keys marks the given keys secret (appended to TAI_ENV_SECRET_KEYS; an oauth connector's client secret is masked by derivation with no mark needed). Declared on the model so a Studio body carrying them is not silently dropped (pydantic ignores unknown fields).

route_mounts remaps a route-carrying item's declared base ({item_name: base}); accept_public_routes acknowledges that the install's public routes answer WITHOUT authentication (required when any public route is declared).

ref
string
required
accept_public_routes
boolean
default:false
env
Env · object | null
route_mounts
Route Mounts · object | null
secret_keys
string[] | null
version
string | null

Response

Success.

data
InstallResult · object
required

The install (and update) receipt. package is null for a descriptor-only plugin; advisories are the target's upstream advisory rows forwarded verbatim; notes are activation notes; reload is the manifest apply's fleet result; pip_output is null for a descriptor-only plugin; routes lists every route the operation mounted.