Setting up Hive as a Source

👥
Access Required
Guru Access: You need to be an Admin or relevant custom role to set up Sources.
Hive Access: The authenticating user must have an API Key with access to the Hive workspace, projects, and tasks you want to sync.

Setting up Hive as a Source

Go to Manage > Sources.
Select Hive from the list of Source icons.
Enter your Hive API Key when prompted.
Grant Guru permission to access your Hive workspace.
Select content to sync:
- Choose specific projects or lists
- Or select all content from your workspace
Assign which Guru Groups should have access to this content.
Click Connect Source.

The initial sync may take some time depending on the amount of data in your Hive workspace.

✍ Note: Your Source status will show "Initializing" during the first sync, then change to "Synced" when complete.

What gets synced from Hive

Tasks	Lists	Activities	Users	Groups
Task title	List name	Activity data	User info	Group structure
Task description	List metadata	Status updates	Role context	Group permissions
Status and priority	Project context	Comments	Assignment data	Team organization

Managing permissions

After connecting Hive, you control who can access this content through Guru Groups:

Go to Manage > Sources.
Find your Hive Source.
Select Edit.
Add or remove Groups as needed.

Only members of assigned Groups will see results from your Hive Source when asking questions in Guru.

Frequently asked questions

How long does it take for Hive data to sync? Sync times vary based on data volume and API rate limits. Initial syncs can take several hours for large workspaces.

Can I sync only specific Hive projects or lists? Yes, during setup you can select specific subsets of Hive content to sync rather than syncing your entire workspace.

Will Hive content appear as Guru Cards? No, Hive Source content is used for AI answer generation and is not converted into Cards. It remains in Hive while being searchable through Guru.

Who can access Hive Source content in Guru? Access is controlled by the Groups you assign to the Source in Guru. Only members of those Groups will see Hive content in search results and answers.

How often does Hive data sync? Hive syncs automatically on a regular schedule. The sync frequency depends on your Guru plan and Source configuration.

Troubleshooting

Issue: Hive Source not syncing

Verify your Hive API Key is correct and has necessary permissions
Check your internet connection and try again
Confirm you have Admin access in Guru
Contact Guru Support if the problem persists

Issue: Users cannot see Hive content in answers

Ensure the users belong to Groups assigned access to the Hive Source
Ask users to refresh their browser or log out and back in
Verify the Source sync status is "Synced" and not "Error"

Issue: Some Hive projects aren't syncing

Check that your API Key has access to those specific projects in Hive
Review your sync settings to ensure those projects are selected
Try disconnecting and reconnecting the Source

What's next

Learn more about Managing Sources in Guru
Explore Using Knowledge Agents with Sources
Understand Source Permissions and Access Control

💡 Tip: Use selective sync options to focus on the most relevant Hive projects or lists to improve sync speed and answer relevance.