{"id":24424,"date":"2025-06-27T10:30:22","date_gmt":"2025-06-27T17:30:22","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=24424"},"modified":"2025-06-27T08:53:17","modified_gmt":"2025-06-27T15:53:17","slug":"microsoft-365-copilot-apis-unlocking-enterprise-knowledge-for-ai-with-the-retrieval-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-365-copilot-apis-unlocking-enterprise-knowledge-for-ai-with-the-retrieval-api\/","title":{"rendered":"Microsoft 365 Copilot APIs: Unlocking\u00a0enterprise\u00a0knowledge\u00a0for AI\u00a0with the Retrieval API\u00a0\u2014 Now in Public Preview"},"content":{"rendered":"<p><span data-contrast=\"auto\">At Build 2025, we introduced the <a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-365-copilot-apis\/\">Microsoft 365 Copilot APIs<\/a>. Developers now have an extensibility layer that empowers them to create intelligent, AI-driven experiences deeply integrated with the Microsoft 365 ecosystem. These APIs unlock powerful capabilities like content retrieval, meeting summarization, and user interaction export and accelerate innovation while ensuring enterprise-grade security and compliance.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Today,\u202fwe\u2019re\u202fexcited to announce that the\u202f<\/span><b><span data-contrast=\"auto\">Retrieval API<\/span><\/b><span data-contrast=\"auto\">, one of the most requested APIs in the set, is now available in\u202f<\/span><b><span data-contrast=\"auto\">Public Preview<\/span><\/b><span data-contrast=\"auto\">.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">The Retrieval API gives developers a\u202fsecure,\u202fcompliant\u202fand scalable\u202fway to integrate enterprise content into their AI workflows. Whether\u202fyou\u2019re\u202fbuilding RAG pipelines, domain-specific\u202fagents\u202for\u202fmining\u202finsights,\u202fit\u202fprovides\u202fa powerful\u202ffoundation\u202ffor grounding large language models in\u202ftrusted\u202forganization\u2019s\u202fknowledge\u202fwith minimal setup\u202fand maximum\u202fflexibility.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Early adopters such as Accenture, Thomson Reuters, Peppermint, Templafy, and Petrobras are already putting the Retrieval API to work and powering value across a range of enterprise AI use cases.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<blockquote><p><i><span data-contrast=\"auto\">\u201cAt Accenture, we view the Retrieval API as a transformative advancement in our multi-platform agentic strategy. It extends the capabilities of our\u202fsubstantial\u202fMicrosoft 365 Copilot footprint by enabling intelligent, context-aware agents to\u202foperate\u202fseamlessly across various environments. This API allows our custom applications and agents to securely access Microsoft 365 data while\u202fmaintaining\u202fexisting permissions, simplifying development and ensuring built-in compliance.\u201d\u202f\u2013\u202f<strong>Accenture<\/strong><\/span><\/i><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p><\/blockquote>\n<h2>Why\u202fit\u202fmatters: Built for\u202fenterprise-grade AI<\/h2>\n<p><span data-contrast=\"auto\">Building AI experiences in the enterprise\u202fisn\u2019t\u202fjust about model\u202fquality;\u202fit\u2019s\u202fabout trust, scale, and seamless integration with how your organization works. The Retrieval API is designed to meet that bar, enabling developers to innovate confidently with secure, scalable access to enterprise knowledge.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">The Retrieval API enables natural language queries over Microsoft 365 content, returning relevant, permission-trimmed\u202fsnippets ready\u202fto ground AI experiences. With a simple REST call, developers can retrieve knowledge from\u202fSharePoint Online\u202fand\u202fCopilot\u202fconnector\u2013indexed content, making it easy to build intelligent, context-aware solutions.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<blockquote><p><i><span data-contrast=\"auto\">\u201cAs a customer who is heavily invested in Microsoft&#8217;s storage, SharePoint Online and OneDrive, the main benefit of\u202fthe Retrieval API is relieving\u202fus\u202fof the weight of managing content indexing. With the Retrieval API,\u202fwe\u202fcan\u202fmaintain\u202four\u202fown post processing flows and create agents while still being\u202fable to access raw content and\u202fleverage\u202fit through the gen AI platform of\u202four\u202fchoice.\u201d\u202f\u2013\u202f<strong>Petrobras<\/strong><\/span><\/i><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p><\/blockquote>\n<p><span data-contrast=\"auto\">Here\u2019s\u202fwhat makes the Retrieval API stand out:\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"4\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Secure and trustworthy by design<\/span><\/b><span data-contrast=\"auto\">:\u202fAll results are permission-trimmed at query time, reflect Microsoft Entra ID access controls, and carry sensitivity label metadata,\u202fensuring your\u202fagents and orchestrators\u202fnever surface unauthorized or misclassified content.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"5\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Less infrastructure overhead:\u202f<\/span><\/b><span data-contrast=\"auto\">You no longer need to build and\u202fmaintain\u202fyour own retrieval infrastructure or vector indexes. The Retrieval API uses the same semantic index that powers Microsoft 365 Copilot, so you can ground LLM responses without\u202fadditional\u202fpipelines or duplication.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"6\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Developer control\u202fwith\u202fenterprise flexibility<\/span><\/b><span data-contrast=\"auto\">: With support for <\/span><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/Reference\/Filter-Examples\"><span data-contrast=\"none\">custom filters<\/span><\/a><span data-contrast=\"auto\">\u202fusing\u202f<\/span><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/Reference\/ResourceMetadata\"><span data-contrast=\"none\">metadata\u202ffields\u202fand\u202fconnector labels<\/span><\/a><span data-contrast=\"auto\">, the API gives developers fine-grained control over what content is retrieved and how\u202fit\u2019s\u202fused in downstream\u202flogic.\u202f\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"7\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Faster performance with fewer API calls<\/span><\/b><span data-contrast=\"auto\">: The Retrieval API supports <\/span><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/Reference\/Batch\"><span data-contrast=\"none\">JSON batching<\/span><\/a><span data-contrast=\"auto\">, allowing multiple queries to be sent\u202fthrough\u202fa single request. This makes it easier to power concurrent grounding workflows while keeping API calls efficient and scalable in large applications.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">The Retrieval API brings the semantic richness of Microsoft 365 to your AI stack,\u202fwithout\u202fcompromising\u202fsecurity, governance, or developer agility.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<h2>What can you build with the Retrieval API<\/h2>\n<p><span data-contrast=\"auto\">The Retrieval API unlocks powerful, real-world scenarios by providing a secure, scalable semantic access layer to enterprise content. It expands what&#8217;s possible for pro-code developers, enabling use cases that previously were only possible with low-code tools like Copilot Studio through Tenant Graph grounding, while still supporting a range of approaches to building agents in Microsoft 365.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<blockquote><p><i><span data-contrast=\"auto\">\u201cThomson Reuters is pioneering the integration of its AI assistant,\u202fCoCounsel, with Microsoft 365 via the Retrieval API to enhance legal workflows. In document review scenarios,\u202fCoCounsel\u202fenables legal professionals to query batches of contracts stored in SharePoint or OneDrive\u2014extracting key clauses like indemnity or confidentiality\u2014grounded in actual document content for accuracy and compliance. Simultaneously,\u202fCoCounsel\u202fcan search<\/span><\/i><i><span data-contrast=\"auto\">\u202f<\/span><\/i><i><span data-contrast=\"auto\">and pull value from<\/span><\/i><i><span data-contrast=\"auto\">\u202f<\/span><\/i><i><span data-contrast=\"auto\">internal legal databases and Microsoft 365 content to answer complex legal queries, such as\u202fidentifying\u202fstandard clauses or retrieving documents tied to specific clients or legal issues.<\/span><\/i><i><span data-contrast=\"auto\">\u202f<\/span><\/i><i><span data-contrast=\"auto\">Thomson Reuters early adoption underscores its commitment to transforming legal operations through AI, without compromising on security, context sensitivity, or compliance.\u201d\u202f\u2013 <strong>Thomson Reuters<\/strong><\/span><\/i><strong>\u202f<\/strong><span data-ccp-props=\"{}\">\u00a0<\/span><\/p><\/blockquote>\n<p><span data-contrast=\"auto\">Here are a few\u202fexamples of\u202fwhat\u2019s\u202fpossible\u202fwith the Retrieval API:\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"8\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Policy and process\u202fagents<\/span><\/b><span data-contrast=\"auto\">: Build agents that can answer questions like \u201cWhat\u2019s our latest expense policy?\u201d by retrieving relevant snippets from SharePoint and connector-indexed documents, ensuring responses are grounded in real, up-to-date internal content.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"9\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Meeting-aware workflows<\/span><\/b><span data-contrast=\"auto\">:\u202fUse the Retrieval API alongside the Meeting Insights API to surface documents or decisions related to a meeting topic,\u202fhelping teams follow up more effectively without having to search manually.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"10\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">Domain-specific knowledge assistants<\/span><\/b><span data-contrast=\"auto\">: Create agents tailored for legal, HR, or finance teams that pull content from curated sites and filtered fields using metadata, content source, or connector tags.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"11\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><b><span data-contrast=\"auto\">RAG-based applications<\/span><\/b><span data-contrast=\"auto\">:\u202fUse the Retrieval API as the retrieval layer in retrieval-augmented generation (RAG) pipelines, grounding model responses in tenant-specific content while preserving full compliance with organizational security and access policies.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<p><span data-contrast=\"auto\">By combining natural language queries with live, governed enterprise data, the Retrieval API brings intelligence closer to where work gets done,\u202fwithout adding infrastructure burden or governance risk.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<h2>Get\u202fstarted<\/h2>\n<p><span data-contrast=\"auto\">The Retrieval API is now available\u202ffor\u202fpublic\u202fpreview via Microsoft Graph. Getting started is simple.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><b><span data-contrast=\"auto\">Prerequisites:<\/span><\/b><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"12\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">You\u2019ll\u202fneed a Microsoft 365 tenant with Copilot licenses assigned to any users making API calls.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"13\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">Make sure your tenant has access to SharePoint Online or indexed entities via Copilot\u202fconnectors.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"13\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"2\" data-aria-level=\"1\"><span data-contrast=\"auto\">\u202fThe Copilot Retrieval API will adhere to <\/span><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval\/Restricted-SharePoint-Search\"><span data-contrast=\"none\">Restricted SharePoint Search<\/span><\/a><span data-contrast=\"auto\"> and <\/span><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/Staged-Rollout\"><span data-contrast=\"none\">Copilot connector staged rollout<\/span><\/a><span data-contrast=\"auto\"> settings.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<p><b><span data-contrast=\"auto\">Try it out:<\/span><\/b><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"14\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">Use Graph Explorer or any REST client to test requests against the\u202f`\/beta\/copilot\/retrieval`\u202fendpoint.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"15\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">Start with a simple POST request\u202fcontaining\u202fa natural language query and the data source you are targeting.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"16\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">Access the API via\u202f<\/span><a href=\"https:\/\/aka.ms\/M365CopilotAPIsLibraries\"><span data-contrast=\"none\">client libraries<\/span><\/a><span data-contrast=\"auto\">\u202fincluded in the\u202fMicrosoft\u202f365 Agents SDK under the Microsoft.Agents.M365Copilot namespace. Libraries are available for\u202f<\/span><a href=\"https:\/\/aka.ms\/m365copilotapislibraries\/dotnet\"><span data-contrast=\"none\">.NET<\/span><\/a><span data-contrast=\"auto\">,\u202f<\/span><a href=\"https:\/\/aka.ms\/m365copilotapislibraries\/typescript\"><span data-contrast=\"none\">TypeScript<\/span><\/a><span data-contrast=\"auto\">, and\u202f<\/span><a href=\"https:\/\/aka.ms\/m365copilotapislibraries\/python\"><span data-contrast=\"none\">Python<\/span><\/a><span data-contrast=\"auto\">.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"17\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span data-contrast=\"auto\">Explore filters, batching, and response fields to\u202fcustomize for\u202fyour scenario.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<p><b><span data-contrast=\"auto\">Provide feedback:<\/span><\/b><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"19\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;multilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/Microsoft-Answers\"><span data-contrast=\"none\">Microsoft Q&amp;A<\/span><\/a><span data-contrast=\"auto\">\u202fis the site for technical questions and answers for Microsoft products. Use the\u202f<\/span><a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/M365-Copilot-Tag\"><span data-contrast=\"none\">Microsoft 365 Copilot Development<\/span><\/a><span data-contrast=\"auto\">\u202ftag to ask questions, connect with other developers, and submit answers.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/li>\n<\/ul>\n<p><b><span data-contrast=\"auto\">Learn more:<\/span><\/b><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Check out\u202f<\/span><span data-contrast=\"none\">the Retrieval API <a href=\"https:\/\/aka.ms\/Copilot-APIs\/Retrieval-API\/Reference\">documentation<\/a><\/span><span data-contrast=\"auto\">\u202fto learn about the capabilities\u202favailable today\u202ffor\u202fpublic\u202fpreview.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<table data-tablestyle=\"MsoNormalTable\" data-tablelook=\"1184\" aria-rowcount=\"8\">\n<tbody>\n<tr aria-rowindex=\"1\">\n<td data-celllook=\"0\"><b><span data-contrast=\"auto\">Capability<\/span><\/b><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><b><span data-contrast=\"auto\">Description<\/span><\/b><span data-contrast=\"auto\">\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"2\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Data sources\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">SharePoint Online\u202fand Copilot\u202fconnector\u2013indexed entities.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"3\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Filtering support\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Use standard\u202fSharePoint\u202fqueryable\u202ffields and\u202fCopilot\u202fconnector metadata for precise targeting.\u202fIncludes support for KQL expressions.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"4\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Request metadata\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Each snippet includes contextual metadata to support traceability and UI rendering.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"5\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Scalability\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Up to 25 documents returned per query, with\u202fone or more snippets returned\u202fper document.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"6\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Grounding\u202fFile size support\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Up\u202fto 512 MB\u202ffor DOCX, PPTX, PDF and 150MB for all other file\u202ftypes.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"7\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Batch support\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Query multiple prompts or workflows in a single API call.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<tr aria-rowindex=\"8\">\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Sensitivity labels\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<td data-celllook=\"0\"><span data-contrast=\"auto\">Results include label metadata for downstream policy enforcement.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>&nbsp;<\/p>\n<p><span data-contrast=\"auto\">We\u2019re\u202fexcited to see what you build with the Microsoft 365 Copilot APIs, and we look forward to learning from your feedback.\u202f<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Read how the Retrieval API gives developers a\u00a0secure,\u00a0compliant\u00a0and scalable\u00a0way to integrate enterprise content into their AI workflows.<\/p>\n","protected":false},"author":76351,"featured_media":24433,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[411],"tags":[409,414],"class_list":["post-24424","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-365-copilot-microsoft-365-developer","tag-microsoft-365-copilot-apis","tag-retrieval-api"],"acf":[],"blog_post_summary":"<p>Read how the Retrieval API gives developers a\u00a0secure,\u00a0compliant\u00a0and scalable\u00a0way to integrate enterprise content into their AI workflows.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/24424","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/76351"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=24424"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/24424\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/24433"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=24424"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=24424"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=24424"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}