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

# Discourse Connector

> Access knowledge from your Discourse **Topics**

## How it works

The Discourse connector indexes documents from your Discourse **Topics**.

## Setting up

### Authorization

1. Log into your Discourse account
   <Info> This Discourse user must have admin priveleges </Info>
2. Click the **Admin** menu from the home page.
3. Open the **Advanced** sub-menu and select **API keys**.

<img src="https://mintcdn.com/utopikai/g8jaLDrzOAAW8fQL/images/connectors/discourse/discourse_1.gif?s=48c33a6cf4114a40ef6905ae9a63d74c" width="400" height="auto" alt="NavigateToAPIKeys" title="NavigateToAPIKeys" data-path="images/connectors/discourse/discourse_1.gif" />

4. Click **New API Key**, name it "UtopikAI". Select "All Users" for **User Level** and "Read-only" for **Scope**.

<img src="https://mintcdn.com/utopikai/g8jaLDrzOAAW8fQL/images/connectors/discourse/discourse_2.gif?s=d000f309d26bbc70dd17750af4d5fed2" alt="FillOutAPIKey" width="2146" height="1388" data-path="images/connectors/discourse/discourse_2.gif" />

5. Click **Save**. Copy the key and put it into UtopikAI.

<img src="https://mintcdn.com/utopikai/fX4Gfjw1E606KuQ9/images/connectors/discourse/discourse_3.gif?s=7a4d2717e1d60881661c8172cc00b0bb" alt="CreateAndCopyAPIKey" width="2560" height="1192" data-path="images/connectors/discourse/discourse_3.gif" />

5. for the API Key Username, enter the username of the Discourse account which has access to the information you'd like to index.

### Indexing

1. Input a name for a connector (if you plan on creating multiple Discourse connectors, this will be used by you to tell between them)
2. Provide your Discourse's base url.

<img src="https://mintcdn.com/utopikai/fX4Gfjw1E606KuQ9/images/connectors/discourse/discourse_4.gif?s=e2f046cb86c70b008d1220cb8b1c6a6e" alt="FillOutUtopikAI" width="2560" height="1274" data-path="images/connectors/discourse/discourse_4.gif" />

3. Enter the **Topics** you wish to index. If left blank, all topics available will be indexed.
4. Click connector to begin indexing the indicated **topics**.