Use the Microsoft Search API to index data
APIs under the
/beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
You can use Microsoft Graph to add custom items to search results in the Microsoft Search experience.
Requests to index data are performed on behalf of an application without the presence of a signed-in user, identified using an access token with application permission.
Microsoft Graph connectors and are currently in public preview status. To gain access to connectors functionality, you must turn on the Targeted release option in your tenant. See more details on the connectors preview program.
Common use cases
The use cases for the APIs in this section involve building Microsoft Graph connectors, which involves the following primary steps:
- Create a connection to an external data source.
- Create and register a schema that describes the type and how to index the external data.
- Index the data as an external item.
|Use cases||REST resources||See also|
|Create, update, or delete a connection||externalConnection||externalConnection methods|
|Register a schema for the external data||schema||schema methods|
|Add, update or delete a custom item in the index||externalItem||externalItem methods|
The following are current known limitations:
- Organizations are limited to a maximum of 10 connections.
- Only Azure Active Directory identities are supported.
- You can create only four
externalItemresources items per second.
- An application is limited to four concurrent operations on a connection.
- Connections have a capacity limit of 700,000 items or ~70 GB of data.
- Maximum size of an
externalItementity is 4 MB.
- Sorting results is not supported.
- Result ranking is best effort.
Find out about the latest new features and updates for this API set.