Connect your knowledgeCheck source status

Check source status

Read the Sources page, understand each badge and banner, confirm that data is arriving, and manage, reconnect, remove or disconnect a source.

A source is one place Gurusup learns from: a Slack channel, a Notion connection, a HubSpot connection, a webhook or your uploaded files.

Admins manage sources. Members can open Sources and Catalog to read about company sources and can upload files, but cannot connect or manage company sources. They can connect their own tl;dv key while an admin allows it: see Connect tl;dv. See also What members see.

Before you start

  • You are an admin to manage sources. Members can read the page and upload files.
  • Your first memory build is queued. Until then, Sources shows a preview with Available once your memory is built, and you connect apps from Catalog and upload files with Upload files. See the Quickstart.

Read the Sources page

Open Sources in the sidebar, in the Brain group. A list on the left has two sections, Connected and Catalog, followed by the sources you have connected. Connected reads "Knowledge from your connected sources." and Catalog reads "Connect the sources your company learns from." Until something is connected, Sources opens on Catalog. The buttons at the top are Upload files and Import wiki for admins and members, and Connect source on Connected, which opens Catalog. In Catalog, admins also get Add webhook source next to the search.

Two tiles sit at the top of Connected.

TileWhat it shows
Collected eventsHow many incoming payloads Gurusup has archived. This is how much has arrived.
Total memoriesHow many memories are in Brain. This is how much has been learned.

Below them, Personal sources and Company sources are tables with one row per source, except that an app with several sources shares one row: see One row per app.

ColumnWhat it means
SourceThe source's name, or the app's name when its sources share a row. A Slack workspace has one row, Slack · workspace name. See Slack.
StatusThe status of the source, in plain words. See Status badges.
Last updatedWhen the source last changed. Hidden on narrow windows.
ContributionThis row's share of everything in Brain, as a percentage. Below 1% it shows one decimal, and below 0.05% it shows <0.1.

Click a row to open the source's page. See Manage a source.

New sources can show zeros for a while: the numbers grow as Gurusup reads. With no sources, admins read "No connected sources yet". Overview also has a short Connected sources card with your top three sources and a View all link to this page.

One row per app

An app with two or more sources shows as one row named after the app, for example Notion when you connected two Notion accounts. Its Contribution is the sum of its sources and its Status is the worst of them. An app with a single source keeps its own row. Three cases stay as they were:

  • Slack has one row per workspace, even with one channel.
  • A webhook source never joins an app's row, even when it is named after the app.
  • Uploaded files are grouped under Local Uploads instead of one row per file. Files members upload are grouped under that name too.

Click the row to open the source's page. For an app with several sources, a list headed Sources (Channels for Slack, Accounts for personal accounts) shows each one with its documents, memories, contribution and status. Click one to open it, and use Back to connected sources to return. Slack channels do not open.

What members see

Members see the same page, and only the sources they can read. They cannot manage sources, but they can upload files.

WhereWhat a member sees
Buttons at the topUpload files and Import wiki, and Connect source, which only opens Catalog. No Add webhook source. See Upload content.
Company sourcesThe same table. A row opens the source's page: About and the accounts under Organization accounts, without the buttons that change anything.
No sources"Your admin has not connected any apps yet." with a link to the catalog.
CatalogThe same apps as admins. Each row has one button, View, and a Connected mark once an admin has connected the app. On tl;dv, the button reads Connect while an admin allows it. On any other app's page, Connect for the organization is off, with the hint "Only administrators can connect organization accounts."

A source an admin restricted to other people is not in the member's table or the totals. Admins see every source, so they can manage who reads it. See Restrict a source to specific people.

Check that data is arriving

QuestionWhere to look
Is this source connected and counted?Sources: its row and its badge, and Total memories at the top.
Did one message, page, deal or file arrive, and where is it now?Ingest: filter by the source and find the row. See Follow ingestion.
Did something fail or wait?Ingest: the Failed and Waiting tabs.

Collected events rising means content is arriving. Total memories rising means it has been learned. The gap between them is content still moving through Ingest.

Manage a source

Click a row. The source opens on its own page, with Back to connected sources (or Back to catalog, when you came from Catalog) at the top. The page opens with the source's name, a status badge and Company source or Personal source. Below it come the sections that apply.

SectionWhen you see itWhat it holds
AboutAlwaysThe description, Category, Connection, Developer and Website, and What Gurusup learns from it. Webhook and upload sources show a short note instead.
Knowledge accessAdmins, on a connected source, a webhook or Local UploadsAccess, a menu named Access mode with Default access, Restricted or Private, and the people you pick. A change saves as soon as you make it: "Knowledge access saved." See Restrict a source to specific people.
Organization accountsEvery company source"Your team uses these accounts; administrators manage them." One row per account, with its status badge and "Synced" and the time of its last read. Admins get Connect for the organization here and Reconnect on the account's row. With none, "No organization accounts connected yet."
MembersAdmins, on an app people can connect themselves (tl;dv)The switch Let members connect their own account.
Your accountsA personal app"Only you use and manage these accounts."
ContentWebhook and upload sources, and apps with choices to makeWhat the source reads: the choices for Attio, Factorial, Sesame and Zernio, the page picker for Notion, Add data for a webhook, the uploaded files for Local Uploads.
HistoryA connected app that can import past contentImport history, and for Notion the Import from Notion card.
Danger zoneAdminsDisconnect, Remove source or Regenerate webhook token, depending on the source.

The page does not list what an app reads (boards, spaces, projects, folders or teams). You see that list in the dialog when you connect or reconnect.

With several accounts of one app, click an account's name to open its own settings. The page then says "Settings for" and its name, and Knowledge access, History and Danger zone apply to that account. The three dots on a row ("More actions for" the account's name) give Rename, Manage settings and, for the account you opened, Disconnect.

A Slack workspace row opens the workspace. The page does not list the channels, and a channel has no page of its own. To stop Gurusup reading one channel, take the app out of that channel in Slack.

Reconnect

Click Reconnect on the account's row under Organization accounts. It opens the dialog Reconnect (App).

HappyScribe, Holded, ClickUp, Asana, Granola, tl;dv, Factorial, Sesame, Zernio, monday.com and Attio. Create a new key or token, paste it and click Reconnect. The hint under the field and Show steps say how to create it.

For HappyScribe, paste the API key again, and the Workspace ID only if that key manages more than one HappyScribe workspace. Neither is filled in for you. Your saved choice under What comes into Brain stays as it was.

Then check that the badge reads Connected. Reconnecting keeps the connection's access and saved choices.

Add another account

Click Connect for the organization again under Organization accounts. The dialog asks for the knowledge access of the new account under Who can read it: pick one and click Connect. Then approve access, or paste the key or address. Slack, Notion, HubSpot, Granola, Mintlify and Documentation.AI take more than one connection. tl;dv has one personal connection per person, see Connect tl;dv. Both accounts are listed under Organization accounts. On Sources they share one row, except for Slack, which has one row per workspace: see One row per app.

HappyScribe, Holded, ClickUp, Asana, Linear, Factorial, Sesame, Zernio, monday.com and Attio take one connection: once connected, Connect for the organization is off with the hint "(App) supports one organization connection. Reconnect the existing account to change it."

Choose content

For Notion, the page picker under Content lets you pick pages while an Import history is running, and brings in only the pages edited inside the window you picked there. You do not need it to start: Gurusup learns from the moment you connect. Search or browse, tick what you want and click Import selected. Gurusup says how many pages were added; without a running import it says "0 pages added" and learns nothing. Added is not learned: follow them in Ingest. See Notion. For HubSpot deals, use Import history instead: see HubSpot.

Slack cannot bring in earlier history.

Regenerate a webhook URL

Under Danger zone on a webhook's page, open the menu on Regenerate webhook token, choose it and confirm. Gurusup shows the new full URL, which includes the access token, under Content. Copy it into your sender. The old URL stops working. Add data and examples are in Webhook.

Remove source and Disconnect

A source with a connection offers Disconnect. A source with no connection, such as a webhook, offers Remove source. Both are under Danger zone. Neither deletes what Gurusup already learned. What each one stops and keeps is in Remove, disconnect and what stays.

Disconnect removes the whole connected account, not only the source you opened. To stop one Slack channel, take the app out of that channel in Slack.

Open Danger zone

Click the row. Under Danger zone, open the menu on Disconnect or Remove source. With several accounts, click the account's name first.

Disconnect or remove

Disconnect opens a dialog, "Disconnect [name]?", that says "Gurusup stops reading from [app]. What it already learned stays." Click Disconnect. Remove source asks "Remove source?" and "Remove (name) from Sources.": click Remove source to confirm.

Check the message

You should see "[name] disconnected." or "[name] removed." A removed source's row leaves Sources.

Local Uploads has neither action. See Upload content.

When ingestion is paused or Demo Mode is on

Sources shows "External ingestion is paused." or "Demo Mode is active.", then "Existing sources remain available, but new external data cannot be added." Upload, import, webhook and the buttons that add or change content on the source pages are off until it lifts; you can still open the pages and read them. While ingestion is paused, Disconnect and Remove source still work. In Demo Mode they are off too. What is off in detail is in Connectors overview.

Status badges

The badge on a row and the badge on each account use the same plain words. The stored status is in the second column.

BadgeStored statusWhat to do
Connectedactive, connectedNothing.
Needs reconnectneeds_reconnectReconnect.
Needs attentionerror, failedReconnect.
Syncingsyncing, importing, running, processingNothing. The source is importing or processing.
Not connectedNo connectionConnect the app from its page in Catalog.
DisconnectedrevokedClick Reconnect on the account's row. For Slack, approve again and invite the app to your channels.
DisconnecteddisconnectedThe account no longer has a row. Connect the app again if you need it.
Check delayeddegradedIf content stops arriving, contact support.
Setup needed, Pendingsetup_required, pendingThe connection is not finished. Open the source, and contact support if it does not clear.
Status unavailableAny other word, for example pausedThe app has no button to pause or resume a source and does not say who set it. Treat it as not yet healthy and open the source.

Banners across the app

One banner shows at a time, across the top of every page. When several apply, the highest row wins.

Banner saysWhenAction
"Ingestion is paused because a payment needs attention. New content stays queued; you can still ask your Brain." or "Your subscription renewal is being confirmed. New content stays queued; you can still ask your Brain."A payment or renewal blocks ingestion.Admins only, View billing.
"You're out of credit. New content is paused until your plan renews on" a date, or "You've gone over your plan." with the same endingUsage is fully used. Not on Usage.Admins only, Contact support. See Plan and usage.
"You're in a demo account. Contact sales for full access."Demo Mode.Contact us. You can close it.
"Ingestion is paused for this organization. Your sources aren't being read, so the Brain only knows what it already had."Ingestion is paused. You cannot lift it from the app.Contact us. You can close it.
"Your company memory hasn't been built yet. Add content, then build your memory to start asking questions." Members read "Gurusup has no sources yet, so it can't answer company questions. Ask an admin in your organization to set it up."Before any source is connected. Not on Home or Sources, or on pages that show the preview.Admins get Build my memory, which opens Sources.
"Gurusup is preparing your documents. Your memory will be built automatically when they are ready." or "Your sources have no documents ready to use. View progress for the next step."After the build is confirmed and before it is queued.View progress, except on Home.
"Gurusup is building your memory, about N min left. Answers will be incomplete until it finishes." or "Your memory build is waiting to start, about N min to go."During the first build.View progress, except on Home.

If something does not work

MessageWhat to do
"Could not load sources.", "Could not load source contribution." or "Could not load source connections.", with a line that the request failed on our side or Gurusup couldn't be reachedReload the page. If it keeps failing, contact support.
"Could not disconnect." and a reason, or "Try again in a minute, and contact support if it keeps failing."The dialog stays open. Try again.
"Could not remove source." and a reasonTry again. If it keeps failing, contact support.
A source stays at zeroCheck Ingest for Failed or Waiting rows. See Connector troubleshooting.