Add a connection to a space

View as Markdown
Creates a connection in this space. `type` is `remote_mcp` (a remote MCP server), `authenticated_http` (one authenticated endpoint), `openapi` (an imported spec) or `slack`; `config` carries the plaintext, non-secret settings for that type (never a credential — use `POST …/credentials` or the OAuth flow). `operationPolicy` defaults to `read_only`: discovered write operations stay off until a builder opts in, and flipping it to `all` is what provisions the approval-gated `conn-<slug>` action. The space comes from the path and is never read from the body. Authorization: `space:contribute`. Returns 201 `{ data: Connection }`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

Request

spaceId comes from the path, never the body.

typeenumRequired
Allowed values:
namestringRequired1-200 characters
slugstringOptionalformat: "^[a-z0-9]+(-[a-z0-9]+)*$"1-64 characters
configmap from strings to anyOptional
operationPolicyenumOptionalDefaults to read_only

A connection only becomes write-capable when a builder opts in.

Allowed values:
scopeenumOptional
Allowed values:

Response

The created connection.
dataobject