Skip to navigation
Workspace APIConnections

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