Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connections

A connection is your environment's settings for one connector, such as Gmail: its name and the OAuth client ID, client secret and scopes Scalekit uses to sign users in to the app. Users then link their own accounts to it as connected accounts. See Connections for setting one up in the dashboard.

Typical flow. Create a connection for a connector, register an OAuth app with the provider using the redirect_uri in the response, then update the connection with the app's client ID, client secret and the scopes you need.

MethodEndpointPathWhat it doesSDKs
POSTCreate a connectionCreate a connection for a connector, such as Gmail./api/v1/agentkit/connectionCreate a connection for a connector, such as Gmail.PythonNode.js
GETGet a connectionGet a connection and its settings, by the connection's name or ID./api/v1/agentkit/connection/{connection_identifier}Get a connection and its settings, by the connection's name or ID.PythonNode.js
GETList connectionsList connections, filtered by connector or name./api/v1/agentkit/connectionList connections, filtered by connector or name.PythonNode.js
PATCHUpdate a connectionRename a connection, or change its client ID, client secret and scopes./api/v1/agentkit/connection/{connection_id}Rename a connection, or change its client ID, client secret and scopes.PythonNode.js
DELETEDelete a connectionDelete a connection./api/v1/connections/{connection_id}Delete a connection.PythonNode.js

This page as markdownWhole reference as one file