FAQ & Troubleshooting

We have collected a few frequently asked questions and steps to resolve issues.

Connectors vs. Knowledge Hub sync

What's the difference between a connector and a synced folder?

There are two distinct ways to bring outside data into Odeus, and they behave differently:

• Connectors (live tools): Slack, Notion, Linear, Jira, GitHub, HubSpot, Google Workspace, and Microsoft 365 (including SharePoint and OneDrive) connect as live tools your agents call in real time. Nothing is copied into Odeus — the agent queries the source when it needs the data.
• Google Drive sync (Knowledge Hub): A Google Drive folder can be synced into the Knowledge Hub, where it is indexed for semantic search and retrieved with citations. This is the only sync source today.

SharePoint and OneDrive are browse-only via the Microsoft 365 connector — they are not synced into the Knowledge Hub. Only Google Drive can be synced. OneDrive and Dropbox sync are not available.

Which permissions does my connector have?

Connectors use OAuth 2.0 (or an API key) to access external tools. OAuth connectors inherit your existing permissions from the connected tool, so you'll only see content you already have access to there.

Example: User A saves a document in SharePoint without sharing it. User B connects through Odeus and searches for that file but can't find it, because User A hasn't granted access. Once User A shares the file, User B can find it through Odeus.

Is all content of a connector imported into Odeus?

No. For live connectors, Odeus queries the source on demand and only retrieves what a given action returns. Content is not bulk-imported. Only a synced Google Drive folder is ingested and indexed into the Knowledge Hub.

How often is content updated?

• Connectors: Queried in real time, so you always see current data.
• Synced Google Drive folders: Refreshed automatically in the background, with only changed files re-indexed.

---

General

I receive an error when using a connector

If an action fails, check these common fixes:

Input parameters

Some requests need specific IDs or formatted queries. If the parameter description doesn't provide enough detail, add it to your agent instructions or specify it in your chat prompt.

OAuth connection

Actions require a valid OAuth connection. Add one by requesting an action for that connector in chat, or connect directly via the integrations menu.

• Reconnect the connector if the connection expired or was revoked.
• Check that the connected account has the scopes the action needs.
• Odeus retries eligible OAuth requests automatically after refreshing the token.
• MCP connections refresh tokens silently when the server supports refresh tokens.