Skip to main content

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:write on a management key. Reading needs connections:read on 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_required webhook 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.