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

  1. Navigate to Manage > Sources.
  2. Select Box from the icon menu.
  3. Select your account type.
    1. If you want to set up your permissions in Guru
      1. 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
    2. 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
  4. Click Authorize Access and log in to Box.
  5. 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.
  6. 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.
    1. Admins have the option of adding a Source Owner for each Source. Source Owners can add Viewers or other Owners, and delete the Source.
    2. An Owner can be added during this initial setup stage, or later by clicking manage access for that Source.
  7. 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.

FilesFoldersUsers
ChecksumDriveEmail Address
DescriptionFolder URLIs Me
File URLNameName
FolderParent Folder
Mime TypeRemote Created Timestamp
NameRemote Updated Timestamp
Remote Created TimestampSize
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)