Sync SharePoint files with assistant files using Drive Sync
Drive Sync keeps an assistant’s knowledge files up to date with files stored in SharePoint. Choose a source location and schedule, and Theta Assist checks for new, changed or removed files automatically.
Each sync uses a person’s Microsoft connection. You can check whose connection it uses, whether it is working, and take over a sync using your own connection if needed.
Quick links
Before you start
You need:
- ownership of the assistant or edit access
- Drive Sync set up for your organisation by a system administrator
- access to the SharePoint site, document library and folder you want to sync
- a working Microsoft connection for the sync.
The sync runs using its configured person’s connection—not necessarily the connection of whoever is currently editing it.
If you cannot see Drive Sync, ask your system administrator to complete the organisation setup.
Create a Drive Sync
1. Open Drive Sync
- Open the assistant you want to update.
- Select Edit Assistant.
- Go to Knowledge > Drive Sync.
- Select +Add Drive Sync.

2. Connect your Microsoft account
- Check your Microsoft authentication status.
- If you are not signed in, select Authenticate with Microsoft.
- Complete the Microsoft sign-in steps.
- If prompted to reconnect, select Re-authenticate.
Use a Microsoft account that has access to the SharePoint source.
3. Select the SharePoint source
- Search for a SharePoint site by name or site URL.
- Select the site.
- Select the document library.
- Browse to a folder if you want to sync only part of the library. Leave the folder blank to sync from the library root.
Use Clear to reset your source selection.
If you select a folder, only that folder is included unless you turn on Include subfolders.

Important: After saving, you cannot change the source site, library or folder. Create a new sync configuration if you need a different source.
4. Name the sync
Review the automatically filled Name and change it if needed. Use a name that helps you identify the source or purpose.
5. Choose what to sync
Under File extensions, enter a comma-separated list such as pdf,docx,pptx.
Leave this blank to include all supported file types.
Turn on Include subfolders to include files in nested folders.

6. Set the schedule
- Choose Daily, Weekly or Monthly.
- Set the time.
- Choose the time zone.
7. Save the configuration
- Select Save to wait for the next scheduled run.
- Select Save & sync now to save and start the first sync.
After saving, check whose Microsoft connection the sync uses and whether it is working.
After the first sync
Open the sync log to check that the expected files were added. Investigate failed or skipped files before relying on the assistant’s knowledge being up to date.
Manage an existing sync
Open Edit Assistant > Knowledge > Drive Sync and select the configuration you want to manage.
You can change:
- the sync name
- whether scheduled syncing is enabled
- file extensions included
- whether subfolders are included
- the schedule and time zone
- the Microsoft connection, using Use my connection.
You cannot change the source site, library or folder after saving.
Pause scheduled syncing
Clear Scheduled sync to pause scheduled runs without deleting the configuration.
You can still run the sync manually while scheduled syncing is paused, provided its Microsoft connection is working.
Run a sync manually
Select Sync now to check SharePoint and update the assistant’s files.
A sync:
- adds new files
- updates changed files
- removes files that are no longer in the source or no longer match the filter.
Manual syncs are blocked if the sync does not have a working Microsoft connection. Restore or change the connection before trying again.
Delete a configuration
Select Delete to remove the sync configuration.
Deleting a configuration also removes the files it synced from the assistant’s file library.
Check or change the Microsoft connection

In the Microsoft Connection section, Runs as shows whose Microsoft connection the sync uses. You can also see the sign-in status, such as Signed in.
Select Check connection to check the sync’s Microsoft connection.
Opening or editing a sync does not mean it automatically uses your connection. Check the connection information before troubleshooting or taking over a sync.
Restore your connection
If the sync uses your Microsoft connection:
- Check its connection status.
- Select Re-authenticate.
- Complete the Microsoft sign-in.
- Check that the connection is working.
- Select Sync now and review the sync log.
Signing in again replaces the Microsoft sign-in used by that sync.
Use your connection for a sync
Use this option to take over a sync with your own Microsoft connection.
You need edit access to the assistant and access to the SharePoint source through your Microsoft account.
- Open the sync configuration.
- Check whose connection it currently uses.
- Select Use my connection.
- Complete any Microsoft sign-in prompts.
- Check that the sync shows your connection and that it is working.
- Select Sync now and review the sync log.
If another person’s connection is not working, you can ask them to reconnect instead of taking over the sync.
Check the sync log
The sync log shows what happened when files were processed. You can open it from Drive Sync, Files, Integrations or Web Crawl.
What you can see
Each row shows:
- File name
- Type — upload or delete
- Status — pending, processing, success, failed or skipped
- Created
- Completed
Expand a row to see details such as the source URL and processing log.
Filter the log
Filter by status, type or date range. Select Reset to clear the filters.
Supported file types
Drive Sync adds supported assistant file types:
.c, .cs, .cpp, .doc, .docx, .html, .java, .json, .md, .pdf, .php, .pptx, .py, .rb, .tex, .txt, .css, .js, .sh, .ts and .vtt.
It does not add:
- Excel or CSV files
- images
- videos
- ZIP files.
To work with Excel or CSV files in a conversation, see Files in Theta Assist.
Troubleshooting
I cannot see Drive Sync
Ask your system administrator to check the organisation setup.
The sync’s Microsoft connection is not working
Check whose connection the sync uses.
- Your connection: Re-authenticate with Microsoft.
- Another person’s connection: Ask them to reconnect, or select Use my connection if you have edit access and access to the source.
Check the connection status before running the sync again.
I cannot run a manual sync
Check whether the sync has a working Microsoft connection. Manual syncs are blocked until the connection is restored.
I received a sync failure email
Read the email to identify the affected sync and who needs to act.
If the email identifies a connection problem, check whose connection the sync uses and restore or change it. For other failures, review the sync log.
A file is missing
Check that:
- the file is in the selected source location
- Include subfolders is enabled if needed
- the file type is supported and matches any extension filter
- the sync log does not show a failed or skipped result.
A file did not update
Check the last sync result and the next scheduled run. Confirm the Microsoft connection is working, then select Sync now if needed.
I need to sync a different location
Create a new configuration. You cannot change the source location of an existing sync.
Check the deletion warning before removing the old configuration: deleting it also removes the files it synced from the assistant’s library.
Permissions
| Role | What they can do |
|---|---|
| System administrator | Configure the organisation’s Microsoft authentication setup for Drive Sync. |
| Assistant owner or editor | Create and manage sync configurations, use their own connection for a sync, run syncs and view the sync log. |
| Assistant viewer | View the sync log only. |