Skip to main content
PUT
Update a local MCP server installation

Authorizations

Authorization
string
header
required

A Barndoor API key, sent as Authorization: Bearer <key>. Keys are prefixed bdai_ and are opaque — do not attempt to decode one. Interchangeable with an OAuth 2.0 access token.

Scopes

openid

Issue an OIDC ID token identifying the caller.

profile

Read the caller's basic profile claims.

email

Read the caller's email address.

Path Parameters

installation_id
string<uuid>
required

Body

application/json
enabled
boolean
required
configuration
Configuration · object
required

Values for the catalog entry's configuration_schema: a flat object of scalar values, every required key present and no undeclared key. Not for secrets. Replaces the current configuration.

availability
enum<string> | null

opt_in: only users who connect it get it. required: every Barndoor CLI in the organization gets it. Omit to keep the current value.

Available options:
opt_in,
required

Response

Successful Response

id
string<uuid>
required
catalog_id
string<uuid>
required
slug
string
required
name
string
required
enabled
boolean
required
configuration
Configuration · object
required
availability
enum<string>
required
Available options:
opt_in,
required
runtime
EmbeddedRuntime · object
required
configuration_schema
Configuration Schema · object
required