> ## Documentation Index
> Fetch the complete documentation index at: https://docs.knoq.one/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect and manage your Knoq integrations

> Step-by-step guide to connecting, testing, and disconnecting integrations in Knoq via OAuth.

Every Knoq integration uses OAuth — you authorize the provider directly on their own login page, and Knoq receives a scoped access token in return. Your credentials never pass through Knoq, and you can revoke access at any time from either side. This guide walks you through connecting your first integration, checking its status, and disconnecting when you no longer need it.

## Connect an integration

<Steps>
  <Step title="Open Settings → Integrations">
    Click your avatar or workspace name in the top-right corner of Knoq, then select **Settings**. In the left sidebar, choose **Integrations**. You'll see the full connector gallery with all available integrations and a badge showing which ones are already connected.
  </Step>

  <Step title="Find the integration you want">
    Scroll the gallery or use the category chips at the top to filter by type — Knowledge, Communication, Project, Dev Tools, CRM, Design, Finance, or Automation. Each card shows the integration name, category, and a brief description of what Knoq can access.
  </Step>

  <Step title="Click Connect">
    Click the connector card to expand it, then press the **Connect** button. If you've reached your plan's connector limit, Knoq will prompt you to upgrade before proceeding.
  </Step>

  <Step title="Authorize on the provider's page">
    Knoq redirects you to the provider's official OAuth authorization page — for example, Slack's login screen or GitHub's authorization prompt. Review the requested permissions, then click **Allow** or **Authorize** to grant access. Knoq only requests the scopes it needs for search and retrieval.
  </Step>

  <Step title="Return to Knoq">
    After you authorize, the provider redirects you back to Knoq's **Settings → Integrations** page. The connector card updates to show a green **Connected** badge, and you'll see a confirmation message. If this is your first connector, Knoq will invite you to head straight to the chat and ask your first question.
  </Step>
</Steps>

<Tip>
  After connecting, try a quick test query in the chat — for example, "Summarize recent activity in #general" for Slack, or "Show my open pull requests" for GitHub. A successful response confirms the integration is working.
</Tip>

## Check connection status

The **Settings → Integrations** page shows the live connection status of every connector:

* **Green badge — Connected:** The integration is active and Knoq can query it on your behalf.
* **No badge — Not connected:** You haven't connected this integration yet, or it was disconnected.
* **Red or error badge — Authorization error:** The token has been revoked, expired, or the provider returned an error. You'll need to reconnect.

If Knoq encounters an error while querying an integration mid-conversation, it surfaces a plain-language message rather than a raw error code. The Settings page will show the error badge on the affected connector.

## Disconnect an integration

Disconnecting immediately revokes Knoq's access to that tool. Knoq deletes the stored access token, and subsequent queries will no longer reach that integration.

<Steps>
  <Step title="Go to Settings → Integrations">
    Navigate to the connector gallery as described above.
  </Step>

  <Step title="Open the connected integration">
    Click the connector card that shows a green Connected badge.
  </Step>

  <Step title="Click Disconnect">
    Press the **Disconnect** button in the expanded card. Knoq asks you to confirm — click **Disconnect** again to proceed.
  </Step>

  <Step title="Confirm removal">
    The badge clears and the connector returns to its unconnected state. Knoq no longer holds an access token for that provider. Disconnecting does not delete any data from the provider itself.
  </Step>
</Steps>

<Warning>
  Disconnecting is immediate. Any in-progress queries that involve that integration will fail once the token is removed. If you're in the middle of a conversation that depends on the connector, finish it before disconnecting.
</Warning>

## Reconnect after expiry

OAuth tokens issued by some providers expire after a set period, or a workspace admin may revoke them centrally. When this happens, the connector shows an error badge on the Settings page and Knoq will be unable to query that source.

To reconnect, follow the same [Connect an integration](#connect-an-integration) steps above. Knoq will walk you through the OAuth flow again, and a new access token will replace the expired one. You don't need to reconfigure anything — your previous connector choice is preserved.

<Tip>
  If a connector repeatedly shows an error badge after reconnecting, check whether a workspace admin at the provider (for example, a Slack workspace admin or GitHub organization owner) has restricted OAuth app access for your organization.
</Tip>

## Connector limits

<Note>
  The number of integrations you can connect at one time depends on your Knoq plan: **Free** (2 connectors), **Solo** (5), **Team** (15), and **Business** (unlimited). Each connected integration counts as one connector. See [concepts](/concepts) for full plan details and upgrade options.
</Note>