Connections
Not available yet
Connections are switched off in this release. In the portal, Settings → Integrations → Connections shows "Connections are not available yet". This page will describe them when they become available.
A connection will link your organization to a documentation platform account once. Your knowledge bases can then use it as a source, without anyone pasting a token again.
What is already decided:
- A connection belongs to the whole organization. Only owners and admins manage it.
- Managing connections needs
connections:writeon a management key. Reading needsconnections:readon an inference or a management key. See Who can manage integrations. - Credentials are never shown again after you enter them. For a token, value or password of at least 12 characters the last four characters are returned as a hint; otherwise, and for OAuth sign-ins, there is no hint.
- When a connection stops working (for example the platform account revoked access), the
integrations.connection.reauth_requiredwebhook event is sent.
Until then, adding a connection, checking it or giving it a new credential is refused with 403 integrations_disabled (or 403 connector_platform_disabled for a platform that is not offered). Renaming and deleting still work.