Setting up Box as a Source
Bringing Box content into Guru makes it simple for teams to search, access, and trust internal documents without leaving the tools they already use.
Access Required
Guru Access: You need to be an Admin in Guru to set up Sources.
Box Access: If you want to set up your permissions in Guru you do not need to be an Admin. If you want to inherit your team's permissions from Box you need to be an Admin.
Setting up Box as a Source
- Navigate to Manage > Sources.
- Select Box from the icon menu.
- Select your account type.
- If you want to set up your permissions in Guru
- Under Select your account type select Read and write for admins.
Note
The required scopes include:
- root_readonly
- root_readwrite
- manage_managed_users
- manage_groups
- manage_webhook
- Under Select your account type select Read and write for admins.
- If you want to inherit your team's permissions from Box
b. Under Select your account type select Read and write for non-admins.Note
The required scopes include:
- root_readonly
- root_readwrite
- manage_managed_users
- manage_groups
- manage_webhook
- If you want to set up your permissions in Guru
- Click Authorize Access and log in to Box.
- Choose which content to sync - this is called Selective Sync. Limiting the synced content to only what's necessary improves sync speed and search relevance. You can also choose to sync all data.
- If you want to set up permissions to content in Guru, specify which Guru Groups should have access to the content once synced. Otherwise, if you choose "Use permissions from Box" - Knowledge Agents will respect the permissions from Box.
- Admins have the option of adding a Source Owner for each Source. Source Owners can add Viewers or other Owners, and delete the Source.
- An Owner can be added during this initial setup stage, or later by clicking manage access for that Source.
- Guru will send a confirmation email when the initial sync is complete. This will also be indicated in the web app when you see the Sync status change from "Initializing" to "Synced."
Objects synced from Box
Only files in selected folders can be synced to Guru. You'll need to connect each folder in Sharepoint individually.
Files | Folders | Users |
---|---|---|
Checksum | Drive | Email Address |
Description | Folder URL | Is Me |
File URL | Name | Name |
Folder | Parent Folder | |
Mime Type | Remote Created Timestamp | |
Name | Remote Updated Timestamp | |
Remote Created Timestamp | Size | |
Remote Updated Timestamp | ||
Size |
Note
Box enforces two types of rate limits:
- 1,000 API requests per minute
- 100,000 API requests per month (Enterprise Plan)
Updated about 6 hours ago