{"versionId":"2c5705ec-1f9b-4eef-2791-08def3604858","articleId":"46fb4d2a-329e-4b23-06fc-08dec5c39c9c","title":"Save files to Microsoft 365 with Theta Assist","tags":["All articles"],"content":"<html><head></head><body><p>Use this feature to let Theta Assist save files to a managed Microsoft 365 working folder (also known as AI working folder) in&nbsp;OneDrive or SharePoint. It helps your team save AI-generated files more safely while keeping writes inside an approved folder structure.</p>\n<div class=\"mce-toc\">\n<h2>In this article</h2>\n<ul>\n<li><a href=\"#what-this-feature-does\">What this feature does</a></li>\n<li><a href=\"#before-you-start\">Before you start</a>\n<ul>\n<li><a href=\"#mcetoc_1jru5n73fu4\">Admin set-up requirements</a></li>\n</ul>\n</li>\n<li><a href=\"#save-a-file-to-microsoft-365\">Save a file to Microsoft 365</a>\n<ul>\n<li><a href=\"#mcetoc_1jru5n73fu5\">Ask Theta Assist to save the file</a></li>\n</ul>\n</li>\n<li><a href=\"#choose-a-folder-with-the-drive-picker\">Choose a folder with the drive picker</a>\n<ul>\n<li><a href=\"#mcetoc_1jru5n73fu6\">Browse OneDrive</a></li>\n<li><a href=\"#mcetoc_1jru5n73fu7\">Browse SharePoint</a></li>\n<li><a href=\"#mcetoc_1jru5n73fu8\">Continue in chat</a></li>\n</ul>\n</li>\n<li><a href=\"#how-folder-creation-works\">How folder creation works</a></li>\n<li><a href=\"#what-file-types-are-allowed\">What file types are allowed</a></li>\n<li><a href=\"#what-happens-in-background-jobs\">What happens in background jobs</a></li>\n<li><a href=\"#limitations-when-updating-existing-files\">Limitations when updating existing files</a></li>\n<li><a href=\"#troubleshooting\">Troubleshooting</a>\n<ul>\n<li><a href=\"#mcetoc_1jru5n73fu9\">I cannot see the drive picker</a></li>\n<li><a href=\"#mcetoc_1jru5n73fua\">Theta Assist says it cannot write this file type</a></li>\n<li><a href=\"#mcetoc_1jru5n73fub\">I can browse, but I cannot save to the folder</a></li>\n<li><a href=\"#mcetoc_1jru5n73fuc\">Theta Assist saved the file in the wrong place</a></li>\n</ul>\n</li>\n</ul>\n</div>\n<h2 id=\"what-this-feature-does\">What this feature does</h2>\n<p>This feature gives Theta Assist a safer way to save files to Microsoft 365.</p>\n<p>Instead of saving files anywhere, Theta Assist can only save them to an approved workspace location. If needed, Theta Assist can ask you to choose a folder using a built-in drive picker.</p>\n<p>Theta Assist writes to a configured working folder and can create subfolders inside that folder when needed. If the required folder already exists, Theta Assist uses it rather than creating a duplicate.</p>\n<p>This helps by:</p>\n<ul>\n<li>keeping saved files in an approved location</li>\n<li>limiting which file types can be written</li>\n<li>making it easier to choose a folder without using technical paths or IDs</li>\n</ul>\n<h2 id=\"before-you-start\">Before you start</h2>\n<p>Your administrator manages this feature in <strong>Admin &gt; Tools &gt; M365 Tools</strong>.</p>\n<p>Before you begin, make sure:</p>\n<ul>\n<li>your organisation has Microsoft 365 tools enabled in Theta Assist</li>\n<li>your Microsoft 365 app registration includes the required permission</li>\n<li>your administrator has turned on Microsoft 365 workspace file writing</li>\n<li>your administrator has configured the working folder name and allowed file extensions</li>\n<li>you have access to the relevant OneDrive or SharePoint location</li>\n</ul>\n<h3 id=\"mcetoc_1jru5n73fu4\">Admin set-up requirements</h3>\n<p>Your administrator needs to:</p>\n<ul>\n<li>add the required Microsoft 365 app permission</li>\n<li>enable workspace file writing in <strong>Admin &gt; Tools &gt; M365 Tools</strong></li>\n<li>configure the working folder name</li>\n<li>configure the allowed file extensions</li>\n</ul>\n<p>&nbsp;</p>\n<div><img src=\"https://storage.faqbot.nz/prod/0d5220bc9ad14992d05108dccd460f35/files/pasted_image_article_save-files-to-microsoft-365-with-theta-assist_339ee25e-7c7f-456c-b8e8-9051d6725251.png\" width=\"800\"></div>\n<p>&nbsp;</p>\n<p>Your team may also need prompt guidance so Theta Assist saves files to the intended location.</p>\n<h2 id=\"save-a-file-to-microsoft-365\">Save a file to Microsoft 365</h2>\n<h3 id=\"mcetoc_1jru5n73fu5\">Ask Theta Assist to save the file</h3>\n<ol>\n<li>In chat, ask Theta Assist to create or save a file to Microsoft 365.</li>\n<li>Review the file type and destination Theta Assist suggests.</li>\n<li>If Theta Assist needs you to choose a location, open the Microsoft 365 drive picker when prompted.</li>\n<li>Select your folder and choose <strong>Use selection</strong>.</li>\n<li>Theta Assist will continue using the folder you selected.</li>\n</ol>\n<p>For example, you might ask Theta Assist to:</p>\n<ul>\n<li>save a summary as a Word document</li>\n<li>write a CSV file to a SharePoint folder</li>\n<li>create a report in your OneDrive workspace</li>\n</ul>\n<h2 id=\"choose-a-folder-with-the-drive-picker\">Choose a folder with the drive picker</h2>\n<p>The drive picker lets you choose a location without manually entering folder paths.</p>\n<p>You can also prompt Theta Assist to use the drive picker if you want to choose a specific OneDrive or SharePoint location.</p>\n<h3 id=\"mcetoc_1jru5n73fu6\">Browse OneDrive</h3>\n<ol>\n<li>Open the drive picker when prompted.</li>\n<li>Choose <strong>My OneDrive</strong>.</li>\n<li>Browse to the folder you want.</li>\n<li>Select <strong>Use selection</strong>.</li>\n</ol>\n<h3 id=\"mcetoc_1jru5n73fu7\">Browse SharePoint</h3>\n<ol>\n<li>Open the drive picker when prompted.</li>\n<li>Search for the SharePoint site by name, URL, sharing link, or drive ID.</li>\n<li>Open the correct document library and folder.</li>\n<li>Select <strong>Use selection</strong>.</li>\n</ol>\n<h3 id=\"mcetoc_1jru5n73fu8\">Continue in chat</h3>\n<p>Once you have selected a location, Theta Assist uses that location to complete the file-writing step.</p>\n<h2 id=\"how-folder-creation-works\">How folder creation works</h2>\n<p>Theta Assist writes inside the configured working folder. It can create subfolders within that workspace when needed.</p>\n<p>This means:</p>\n<ul>\n<li>it does not write directly to the selected root folder</li>\n<li>it can create a subfolder for the task if needed</li>\n<li>it will not create a duplicate folder if the folder already exists</li>\n</ul>\n<p>For example, if you choose a OneDrive folder, Theta Assist may create and use a subfolder within the approved working area rather than writing directly to the top level.</p>\n<h2 id=\"what-file-types-are-allowed\">What file types are allowed</h2>\n<p>Theta Assist can only write approved file types.</p>\n<p>Your administrator controls the allowed file extensions. This means some file types may be blocked even if Theta Assist can generate them.</p>\n<p>Riskier file types are excluded. This includes executable or script-style formats.</p>\n<p>If a file type is not allowed, ask your administrator whether that extension should be enabled.</p>\n<h2 id=\"what-happens-in-background-jobs\">What happens in background jobs</h2>\n<p>The drive picker only works when a person is present in the chat.</p>\n<p>It is not available in:</p>\n<ul>\n<li>scheduled jobs</li>\n<li>background jobs</li>\n<li>batch runs</li>\n<li>unattended agent workflows</li>\n</ul>\n<p>This is because those workflows cannot pause and wait for someone to choose a folder.</p>\n<p>If you need a file saved from a non-interactive workflow, specify the location it should save to as part of the instruction.</p>\n<h2 id=\"limitations-when-updating-existing-files\">Limitations when updating existing files</h2>\n<p>Creating a new file is the simplest use case.</p>\n<p>Updating an existing Word file is more complex. Theta Assist may need to:</p>\n<ul>\n<li>fetch the existing file</li>\n<li>create a new version based on that file</li>\n<li>preserve formatting and styles</li>\n<li>replace or overwrite the earlier version if appropriate</li>\n</ul>\n<p>If you need reliable updates to an existing Word document, test the workflow carefully first.</p>\n<h2 id=\"troubleshooting\">Troubleshooting</h2>\n<h3 id=\"mcetoc_1jru5n73fu9\">I cannot see the drive picker</h3>\n<p>This may happen if Microsoft 365 tools are not enabled, workspace file writing is turned off, you are in a background or scheduled run, or your session does not have the required Microsoft 365 access.</p>\n<p>Try again in a normal interactive chat. If the issue continues, contact your administrator.</p>\n<h3 id=\"mcetoc_1jru5n73fua\">Theta Assist says it cannot write this file type</h3>\n<p>This usually means the file extension is not on the allowed list.</p>\n<ul>\n<li>Ask Theta Assist to use a different file type.</li>\n<li>Ask your administrator to review the allowed extensions.</li>\n</ul>\n<h3 id=\"mcetoc_1jru5n73fub\">I can browse, but I cannot save to the folder</h3>\n<p>You may not have permission to write to that OneDrive or SharePoint location.</p>\n<p>Check that:</p>\n<ul>\n<li>you have access to the site or folder</li>\n<li>the selected location is the correct one</li>\n<li>your Microsoft 365 access is connected correctly</li>\n</ul>\n<h3 id=\"mcetoc_1jru5n73fuc\">Theta Assist saved the file in the wrong place</h3>\n<p>Try being more specific in your prompt. For example:</p>\n<ul>\n<li>tell Theta Assist to use the workspace write tool</li>\n<li>ask it to use the drive picker</li>\n<li>name the OneDrive or SharePoint location you want</li>\n</ul>\n<p>If needed, select the location yourself using the drive picker.</p>\n<p>&nbsp;</p></body></html>","description":"","isMarkdown":false,"publishedOnUtc":"2026-08-14T01:15:40.5635686","modifiedOnUtc":"2026-06-09T01:08:26.9811401"}