Microsoft Copilot · Example Payload

Microsoft Copilot Copilotretrieval Example

AgentsAI AssistantArtificial IntelligenceChatbotsCopilotExtensibilityGenerative AIMicrosoft-365Productivity

Microsoft Copilot Copilotretrieval Example is an example object payload from Microsoft Copilot, with 6 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

operationIdmethodpathsummaryrequestExamplesresponseExamples

Example Payload

Raw ↑
{
  "operationId": "copilot.retrieval",
  "method": "POST",
  "path": "/copilot/retrieval",
  "summary": "Microsoft Copilot Retrieve Grounding Data",
  "requestExamples": [
    {
      "contentType": "application/json",
      "name": "sharePointRetrieval",
      "example": {
        "queryString": "How to setup corporate VPN?",
        "dataSource": "sharePoint",
        "resourceMetadata": [
          "title",
          "author"
        ],
        "maximumNumberOfResults": 10
      }
    },
    {
      "contentType": "application/json",
      "name": "filteredRetrieval",
      "example": {
        "queryString": "How to setup corporate VPN?",
        "dataSource": "sharePoint",
        "filterExpression": "path:\"https://contoso.sharepoint.com/sites/HR1/\"",
        "resourceMetadata": [
          "title",
          "author"
        ],
        "maximumNumberOfResults": 4
      }
    },
    {
      "contentType": "application/json",
      "name": "connectorRetrieval",
      "example": {
        "queryString": "How to setup corporate VPN?",
        "dataSource": "externalItem",
        "dataSourceConfiguration": {
          "externalItem": {
            "connections": [
              {
                "connectionId": "ContosoITServiceNowKB"
              },
              {
                "connectionId": "ContosoHRServiceNowKB"
              }
            ]
          }
        },
        "resourceMetadata": [
          "title",
          "author"
        ],
        "maximumNumberOfResults": 10
      }
    }
  ],
  "responseExamples": [
    {
      "status": "200",
      "contentType": "application/json",
      "name": "sharePointResults",
      "example": {
        "retrievalHits": [
          {
            "webUrl": "https://contoso.sharepoint.com/sites/HR/VPNAccess.docx",
            "extracts": [
              {
                "text": "To configure the VPN, click the Wi-Fi icon on your corporate device and select the VPN option.",
                "relevanceScore": 0.8374363553387588
              },
              {
                "text": "You will need to sign in with 2FA to access the corporate VPN.",
                "relevanceScore": 0.746547264249868
              }
            ],
            "resourceType": "listItem",
            "resourceMetadata": {
              "title": "VPN Access",
              "author": "John Doe"
            },
            "sensitivityLabel": {
              "sensitivityLabelId": "f71f1f74-bf1f-4e6b-b266-c777ea76e2s8",
              "displayName": "Confidential\\Any User (No Protection)",
              "priority": 4,
              "color": "#FF8C00"
            }
          }
        ]
      }
    }
  ]
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this
  • find_examplesBrowse and filter every example in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This example
curl "https://apis.io/api/v1/examples/microsoft-copilot-copilotretrieval-example"
All examples
curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.