{"versionId":"ce61e02e-6999-49d5-f00f-08df3875ce53","articleId":"ca33141a-e714-483e-fb1e-08debacbbb49","title":"Sync SharePoint files with assistant files using Drive Sync","tags":["Creating assistants","Working with files","All articles"],"content":"<html><head></head><body><p>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.</p>\n<p>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.</p>\n<div class=\"mce-toc\">\n<h2>Quick links</h2>\n<ul>\n<li><a href=\"#before-you-start\">Before you start</a></li>\n<li><a href=\"#create-a-drive-sync\">Create a Drive Sync</a>\n<ul>\n<li><a href=\"#mcetoc_1jq34oh6012n\">1. Open Drive Sync</a></li>\n<li><a href=\"#mcetoc_1jq34oh6012o\">2. Connect your Microsoft account</a></li>\n<li><a href=\"#mcetoc_1jq34oh6012p\">3. Select the SharePoint source</a></li>\n<li><a href=\"#mcetoc_1jq34oh6012r\">4. Name the sync</a></li>\n<li><a href=\"#mcetoc_1jq34oh6012s\">5. Choose what to sync</a></li>\n<li><a href=\"#mcetoc_1jq34oh6012t\">6. Set the schedule</a></li>\n<li><a href=\"#mcetoc_1jq34oh6012u\">7. Save the configuration</a></li>\n<li><a href=\"#after-the-first-sync\">After the first sync</a></li>\n</ul>\n</li>\n<li><a href=\"#manage-an-existing-sync\">Manage an existing sync</a>\n<ul>\n<li><a href=\"#mcetoc_1jq34oh6012v\">Pause scheduled syncing</a></li>\n<li><a href=\"#mcetoc_1jq34oh60130\">Run a sync manually</a></li>\n<li><a href=\"#mcetoc_1jq34oh60131\">Delete a configuration</a></li>\n</ul>\n</li>\n<li><a href=\"#check-or-change-the-microsoft-connection\">Check or change the Microsoft connection</a>\n<ul>\n<li><a href=\"#restore-your-connection\">Restore your connection</a></li>\n<li><a href=\"#use-your-connection\">Use your connection for a sync</a></li>\n</ul>\n</li>\n<li><a href=\"#check-the-sync-log\">Check the sync log</a>\n<ul>\n<li><a href=\"#mcetoc_1jq34oh60132\">What you can see</a></li>\n<li><a href=\"#mcetoc_1jq34oh60133\">Filter the log</a></li>\n</ul>\n</li>\n<li><a href=\"#supported-file-types\">Supported file types</a></li>\n<li><a href=\"#troubleshooting\">Troubleshooting</a>\n<ul>\n<li><a href=\"#mcetoc_1jq34oh60134\">I cannot see Drive Sync</a></li>\n<li><a href=\"#mcetoc_1jq34oh60135\">The sync’s Microsoft connection is not working</a></li>\n<li><a href=\"#cannot-run-manual-sync\">I cannot run a manual sync</a></li>\n<li><a href=\"#sync-failure-email\">I received a sync failure email</a></li>\n<li><a href=\"#mcetoc_1jq34oh60136\">A file is missing</a></li>\n<li><a href=\"#mcetoc_1jq34oh60137\">A file did not update</a></li>\n<li><a href=\"#mcetoc_1jq34oh60138\">I need to sync a different location</a></li>\n</ul>\n</li>\n<li><a href=\"#permissions\">Permissions</a></li>\n</ul>\n</div>\n<h2 id=\"before-you-start\">Before you start</h2>\n<p>You need:</p>\n<ul>\n<li>ownership of the assistant or edit access</li>\n<li>Drive Sync set up for your organisation by a system administrator</li>\n<li>access to the SharePoint site, document library and folder you want to sync</li>\n<li>a working Microsoft connection for the sync.</li>\n</ul>\n<p>The sync runs using its configured person’s connection—not necessarily the connection of whoever is currently editing it.</p>\n<p>If you cannot see Drive Sync, ask your system administrator to complete the <a href=\"https://help.thetaassist.ai/article/set-up-drive-sync-for-your-organisation\" target=\"_blank\" rel=\"noopener\">organisation setup</a>.</p>\n<h2 id=\"create-a-drive-sync\">Create a Drive Sync</h2>\n<h3 id=\"mcetoc_1jq34oh6012n\">1. Open Drive Sync</h3>\n<ol>\n<li>Open the assistant you want to update.</li>\n<li>Select <strong>Edit Assistant</strong>.</li>\n<li>Go to <strong>Knowledge &gt; Drive Sync</strong>.</li>\n<li>Select <strong>+Add Drive Sync</strong>.</li>\n</ol>\n<p><img src=\"https://storage.faqbot.nz/prod/0d5220bc9ad14992d05108dccd460f35/files/pasted_image_article_sync-sharepoint-files-with-drive-sync_b10a6cce-bffa-4276-b71b-10b08cbe62be.png\" alt=\"Drive Sync section in the assistant editor.\" width=\"800\"></p>\n<h3 id=\"mcetoc_1jq34oh6012o\">2. Connect your Microsoft account</h3>\n<ol>\n<li>Check your Microsoft authentication status.</li>\n<li>If you are not signed in, select <strong>Authenticate with Microsoft</strong>.</li>\n<li>Complete the Microsoft sign-in steps.</li>\n<li>If prompted to reconnect, select <strong>Re-authenticate</strong>.</li>\n</ol>\n<p>Use a Microsoft account that has access to the SharePoint source.</p>\n<h3 id=\"mcetoc_1jq34oh6012p\">3. Select the SharePoint source</h3>\n<ol>\n<li>Search for a SharePoint site by name or site URL.</li>\n<li>Select the site.</li>\n<li>Select the document library.</li>\n<li>Browse to a folder if you want to sync only part of the library. Leave the folder blank to sync from the library root.</li>\n</ol>\n<p>Use <strong>Clear</strong> to reset your source selection.</p>\n<p>If you select a folder, only that folder is included unless you turn on <strong>Include subfolders</strong>.</p>\n<p><img src=\"https://storage.faqbot.nz/prod/0d5220bc9ad14992d05108dccd460f35/files/pasted_image_article_sync-sharepoint-files-with-drive-sync_49e5b4cc-1131-44af-8269-2e7f426e6966.png\" alt=\"SharePoint source selection for Drive Sync.\" width=\"800\"></p>\n<p><strong>Important:</strong> After saving, you cannot change the source site, library or folder. Create a new sync configuration if you need a different source.</p>\n<h3 id=\"mcetoc_1jq34oh6012r\">4. Name the sync</h3>\n<p>Review the automatically filled <strong>Name</strong> and change it if needed. Use a name that helps you identify the source or purpose.</p>\n<h3 id=\"mcetoc_1jq34oh6012s\">5. Choose what to sync</h3>\n<p>Under <strong>File extensions</strong>, enter a comma-separated list such as <code>pdf,docx,pptx</code>.</p>\n<p>Leave this blank to include all <a href=\"#supported-file-types\">supported file types</a>.</p>\n<p>Turn on <strong>Include subfolders</strong> to include files in nested folders.</p>\n<p><img src=\"https://storage.faqbot.nz/prod/0d5220bc9ad14992d05108dccd460f35/files/pasted_image_article_sync-sharepoint-files-with-drive-sync_12058fd8-3f16-4159-80bc-b28bdfe737d5.png\" alt=\"Drive Sync file extension and subfolder settings.\" width=\"800\"></p>\n<h3 id=\"mcetoc_1jq34oh6012t\">6. Set the schedule</h3>\n<ol>\n<li>Choose <strong>Daily</strong>, <strong>Weekly</strong> or <strong>Monthly</strong>.</li>\n<li>Set the time.</li>\n<li>Choose the time zone.</li>\n</ol>\n<h3 id=\"mcetoc_1jq34oh6012u\">7. Save the configuration</h3>\n<ul>\n<li>Select <strong>Save</strong> to wait for the next scheduled run.</li>\n<li>Select <strong>Save &amp; sync now</strong> to save and start the first sync.</li>\n</ul>\n<p>After saving, check whose Microsoft connection the sync uses and whether it is working.</p>\n<h3 id=\"after-the-first-sync\">After the first sync</h3>\n<p>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.</p>\n<h2 id=\"manage-an-existing-sync\">Manage an existing sync</h2>\n<p>Open <strong>Edit Assistant &gt; Knowledge &gt; Drive Sync</strong> and select the configuration you want to manage.</p>\n<p>You can change:</p>\n<ul>\n<li>the sync name</li>\n<li>whether scheduled syncing is enabled</li>\n<li>file extensions included</li>\n<li>whether subfolders are included</li>\n<li>the schedule and time zone</li>\n<li>the Microsoft connection, using <strong>Use my connection</strong>.</li>\n</ul>\n<p>You cannot change the source site, library or folder after saving.</p>\n<h3 id=\"mcetoc_1jq34oh6012v\">Pause scheduled syncing</h3>\n<p>Clear <strong>Scheduled sync</strong> to pause scheduled runs without deleting the configuration.</p>\n<p>You can still run the sync manually while scheduled syncing is paused, provided its Microsoft connection is working.</p>\n<h3 id=\"mcetoc_1jq34oh60130\">Run a sync manually</h3>\n<p>Select <strong>Sync now</strong> to check SharePoint and update the assistant’s files.</p>\n<p>A sync:</p>\n<ul>\n<li>adds new files</li>\n<li>updates changed files</li>\n<li>removes files that are no longer in the source or no longer match the filter.</li>\n</ul>\n<p>Manual syncs are blocked if the sync does not have a working Microsoft connection. <a href=\"#check-or-change-the-microsoft-connection\">Restore or change the connection</a> before trying again.</p>\n<h3 id=\"mcetoc_1jq34oh60131\">Delete a configuration</h3>\n<p>Select <strong>Delete</strong> to remove the sync configuration.</p>\n<p><strong>Deleting a configuration also removes the files it synced from the assistant’s file library.</strong></p>\n<h2 id=\"check-or-change-the-microsoft-connection\">Check or change the Microsoft connection</h2>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/0d5220bc9ad14992d05108dccd460f35/files/pasted_image_article_sync-sharepoint-files-with-drive-sync_a4916302-a4cb-440b-b499-f6513ec8cdad.png\" width=\"800\" height=\"170\"></div>\n<p>&nbsp;</p>\n<p>In the <strong>Microsoft Connection</strong> section, <strong>Runs as</strong> shows whose Microsoft connection the sync uses. You can also see the sign-in status, such as <strong>Signed in</strong>.</p>\n<p>Select <strong>Check connection</strong> to check the sync’s Microsoft connection.</p>\n<p>Opening or editing a sync does not mean it automatically uses your connection. Check the connection information before troubleshooting or taking over a sync.</p>\n<h3 id=\"restore-your-connection\">Restore your connection</h3>\n<p>If the sync uses your Microsoft connection:</p>\n<ol>\n<li>Check its connection status.</li>\n<li>Select <strong>Re-authenticate</strong>.</li>\n<li>Complete the Microsoft sign-in.</li>\n<li>Check that the connection is working.</li>\n<li>Select <strong>Sync now</strong> and review the sync log.</li>\n</ol>\n<p>Signing in again replaces the Microsoft sign-in used by that sync.</p>\n<h3 id=\"use-your-connection\">Use your connection for a sync</h3>\n<p>Use this option to take over a sync with your own Microsoft connection.</p>\n<p>You need edit access to the assistant and access to the SharePoint source through your Microsoft account.</p>\n<ol>\n<li>Open the sync configuration.</li>\n<li>Check whose connection it currently uses.</li>\n<li>Select <strong>Use my connection</strong>.</li>\n<li>Complete any Microsoft sign-in prompts.</li>\n<li>Check that the sync shows your connection and that it is working.</li>\n<li>Select <strong>Sync now</strong> and review the sync log.</li>\n</ol>\n<p>If another person’s connection is not working, you can ask them to reconnect instead of taking over the sync.</p>\n<h2 id=\"check-the-sync-log\">Check the sync log</h2>\n<p>The sync log shows what happened when files were processed. You can open it from <strong>Drive Sync</strong>, <strong>Files</strong>, <strong>Integrations</strong> or <strong>Web Crawl</strong>.</p>\n<h3 id=\"mcetoc_1jq34oh60132\">What you can see</h3>\n<p>Each row shows:</p>\n<ul>\n<li><strong>File name</strong></li>\n<li><strong>Type</strong> — upload or delete</li>\n<li><strong>Status</strong> — pending, processing, success, failed or skipped</li>\n<li><strong>Created</strong></li>\n<li><strong>Completed</strong></li>\n</ul>\n<p>Expand a row to see details such as the source URL and processing log.</p>\n<h3 id=\"mcetoc_1jq34oh60133\">Filter the log</h3>\n<p>Filter by status, type or date range. Select <strong>Reset</strong> to clear the filters.</p>\n<h2 id=\"supported-file-types\">Supported file types</h2>\n<p>Drive Sync adds supported assistant file types:</p>\n<p><code>.c</code>, <code>.cs</code>, <code>.cpp</code>, <code>.doc</code>, <code>.docx</code>, <code>.html</code>, <code>.java</code>, <code>.json</code>, <code>.md</code>, <code>.pdf</code>, <code>.php</code>, <code>.pptx</code>, <code>.py</code>, <code>.rb</code>, <code>.tex</code>, <code>.txt</code>, <code>.css</code>, <code>.js</code>, <code>.sh</code>, <code>.ts</code> and <code>.vtt</code>.</p>\n<p>It does not add:</p>\n<ul>\n<li>Excel or CSV files</li>\n<li>images</li>\n<li>videos</li>\n<li>ZIP files.</li>\n</ul>\n<p>To work with Excel or CSV files in a conversation, see <a href=\"https://help.thetaassist.ai/article/using-files-in-theta-assist\" target=\"_blank\" rel=\"noopener\">Files in Theta Assist</a>.</p>\n<h2 id=\"troubleshooting\">Troubleshooting</h2>\n<h3 id=\"mcetoc_1jq34oh60134\">I cannot see Drive Sync</h3>\n<p>Ask your system administrator to check the <a href=\"https://help.thetaassist.ai/article/set-up-drive-sync-for-your-organisation\" target=\"_blank\" rel=\"noopener\">organisation setup</a>.</p>\n<h3 id=\"mcetoc_1jq34oh60135\">The sync’s Microsoft connection is not working</h3>\n<p>Check whose connection the sync uses.</p>\n<ul>\n<li><strong>Your connection:</strong> Re-authenticate with Microsoft.</li>\n<li><strong>Another person’s connection:</strong> Ask them to reconnect, or select <strong>Use my connection</strong> if you have edit access and access to the source.</li>\n</ul>\n<p>Check the connection status before running the sync again.</p>\n<h3 id=\"cannot-run-manual-sync\">I cannot run a manual sync</h3>\n<p>Check whether the sync has a working Microsoft connection. Manual syncs are blocked until the connection is restored.</p>\n<h3 id=\"sync-failure-email\">I received a sync failure email</h3>\n<p>Read the email to identify the affected sync and who needs to act.</p>\n<p>If the email identifies a connection problem, check whose connection the sync uses and <a href=\"#check-or-change-the-microsoft-connection\">restore or change it</a>. For other failures, review the sync log.</p>\n<h3 id=\"mcetoc_1jq34oh60136\">A file is missing</h3>\n<p>Check that:</p>\n<ul>\n<li>the file is in the selected source location</li>\n<li><strong>Include subfolders</strong> is enabled if needed</li>\n<li>the file type is supported and matches any extension filter</li>\n<li>the sync log does not show a failed or skipped result.</li>\n</ul>\n<h3 id=\"mcetoc_1jq34oh60137\">A file did not update</h3>\n<p>Check the last sync result and the next scheduled run. Confirm the Microsoft connection is working, then select <strong>Sync now</strong> if needed.</p>\n<h3 id=\"mcetoc_1jq34oh60138\">I need to sync a different location</h3>\n<p>Create a new configuration. You cannot change the source location of an existing sync.</p>\n<p>Check the deletion warning before removing the old configuration: deleting it also removes the files it synced from the assistant’s library.</p>\n<h2 id=\"permissions\">Permissions</h2>\n<table style=\"border-collapse: collapse;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">Role</th>\n<th style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">What they can do</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">System administrator</td>\n<td style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">Configure the organisation’s Microsoft authentication setup for Drive Sync.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">Assistant owner or editor</td>\n<td style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">Create and manage sync configurations, use their own connection for a sync, run syncs and view the sync log.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">Assistant viewer</td>\n<td style=\"border: 1px solid #ccc; text-align: left; vertical-align: top; padding: 2px;\">View the sync log only.</td>\n</tr>\n</tbody>\n</table>\n<p>&nbsp;</p></body></html>","description":"Keep assistant knowledge files up to date from SharePoint. Set up a sync, manage its Microsoft connection, review sync results and recover from connection problems.","isMarkdown":false,"publishedOnUtc":"2026-11-11T21:05:00.1269454","modifiedOnUtc":"2026-05-28T04:13:36.5473089"}