Microsoft Graph Search is the unified enterprise search capability for Microsoft 365, exposed via the Microsoft Graph API, that lets apps query and discover content across services like SharePoint, OneDrive, Outlook, Teams, and more—as well as external systems connected through Graph connectors. It returns security‑trimmed, relevance‑ranked, and personalized results based on the user’s permissions and work signals.
openapi: 3.1.0
info:
title: Microsoft Graph Search
description: Needs a description.
paths:
/drives/{drive-id}/items/{driveItem-id}/search(q='{q}'):
description: Provides operations to call the search method.
get:
tags:
- drives.driveItem
summary: Microsoft Graph Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: drives.drive.items.driveItem.search
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
allOf:
- $ref: '#/components/schemas/BaseCollectionPaginationCountResponse'
- type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
schema:
type: string
x-ms-docs-key-type: drive
- name: driveItem-id
in: path
description: The unique identifier of driveItem
required: true
schema:
type: string
x-ms-docs-key-type: driveItem
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
schema:
type: string
nullable: true
x-ms-docs-grouped-path:
- /drives/{drive-id}/search(q='{q}')
/drives/{drive-id}/search(q='{q}'):
description: Provides operations to call the search method.
get:
tags:
- drives.drive.Functions
summary: Microsoft Graph Invoke function search
description: "Search the hierarchy of items for items matching a query.\r\nYou can search within a folder hierarchy, a whole drive, or files shared with the current user."
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/driveitem-search?view=graph-rest-1.0
operationId: drives.drive.search
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Success
content:
application/json:
schema:
title: Collection of driveItem
type: object
allOf:
- $ref: '#/components/schemas/BaseCollectionPaginationCountResponse'
- type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.driveItem'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: function
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
parameters:
- name: drive-id
in: path
description: The unique identifier of drive
required: true
schema:
type: string
x-ms-docs-key-type: drive
- name: q
in: path
description: 'Usage: q=''{q}'''
required: true
schema:
type: string
nullable: true
x-ms-docs-grouped-path:
- /drives/{drive-id}/items/{driveItem-id}/search(q='{q}')
/search:
description: Provides operations to manage the searchEntity singleton.
get:
tags:
- search.searchEntity
summary: Microsoft Graph Get search
operationId: search.searchEntity.GetSearchEntity
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved entity
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.searchEntity'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- search.searchEntity
summary: Microsoft Graph Update search
operationId: search.searchEntity.UpdateSearchEntity
requestBody:
description: New property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.searchEntity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.searchEntity'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/search/acronyms:
description: >-
Provides operations to manage the acronyms property of the
microsoft.graph.searchEntity entity.
get:
tags:
- Search.acronym
summary: Microsoft Graph List acronyms
description: Get a list of the acronym objects and their properties.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-searchentity-list-acronyms?view=graph-rest-1.0
operationId: search.ListAcronyms
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.search.acronymCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- Search.acronym
summary: Microsoft Graph Create acronym
description: Create a new acronym object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-searchentity-post-acronyms?view=graph-rest-1.0
operationId: search.CreateAcronyms
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.acronym'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.acronym'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/search/acronyms/{acronym-id}:
description: >-
Provides operations to manage the acronyms property of the
microsoft.graph.searchEntity entity.
get:
tags:
- Search.acronym
summary: Microsoft Graph Get acronym
description: Read the properties and relationships of an acronym object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-acronym-get?view=graph-rest-1.0
operationId: search.GetAcronyms
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.acronym'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Search.acronym
summary: Microsoft Graph Update acronym
description: Update the properties of an acronym object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-acronym-update?view=graph-rest-1.0
operationId: search.UpdateAcronyms
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.acronym'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.acronym'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Search.acronym
summary: Microsoft Graph Delete acronym
description: Delete an acronym object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-acronym-delete?view=graph-rest-1.0
operationId: search.DeleteAcronyms
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: acronym-id
in: path
description: The unique identifier of acronym
required: true
schema:
type: string
x-ms-docs-key-type: acronym
/search/acronyms/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- Search.acronym
summary: Microsoft Graph Get the number of the resource
operationId: search.acronyms.GetCount-b41d
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
/search/bookmarks:
description: >-
Provides operations to manage the bookmarks property of the
microsoft.graph.searchEntity entity.
get:
tags:
- Search.bookmark
summary: Microsoft Graph List bookmarks
description: Get a list of bookmark objects and their properties.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-searchentity-list-bookmarks?view=graph-rest-1.0
operationId: search.ListBookmarks
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.search.bookmarkCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- Search.bookmark
summary: Microsoft Graph Create bookmark
description: Create a new bookmark object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-searchentity-post-bookmarks?view=graph-rest-1.0
operationId: search.CreateBookmarks
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.bookmark'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.bookmark'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/search/bookmarks/{bookmark-id}:
description: >-
Provides operations to manage the bookmarks property of the
microsoft.graph.searchEntity entity.
get:
tags:
- Search.bookmark
summary: Microsoft Graph Get bookmark
description: Read the properties and relationships of a bookmark object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-bookmark-get?view=graph-rest-1.0
operationId: search.GetBookmarks
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.bookmark'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Search.bookmark
summary: Microsoft Graph Update bookmark
description: Update the properties of a bookmark object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-bookmark-update?view=graph-rest-1.0
operationId: search.UpdateBookmarks
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.bookmark'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.bookmark'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Search.bookmark
summary: Microsoft Graph Delete bookmark
description: Delete a bookmark object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-bookmark-delete?view=graph-rest-1.0
operationId: search.DeleteBookmarks
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: bookmark-id
in: path
description: The unique identifier of bookmark
required: true
schema:
type: string
x-ms-docs-key-type: bookmark
/search/bookmarks/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- Search.bookmark
summary: Microsoft Graph Get the number of the resource
operationId: search.bookmarks.GetCount-b2b7
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
/search/query:
description: Provides operations to call the query method.
post:
tags:
- search.searchEntity.Actions
summary: Microsoft Graph Invoke action query
description: >-
Runs the query specified in the request body. Search results are
provided in the response.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/search-query?view=graph-rest-1.0
operationId: search.query
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
requests:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.searchRequest'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
allOf:
- $ref: '#/components/schemas/BaseCollectionPaginationCountResponse'
- type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.searchResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
/search/qnas:
description: >-
Provides operations to manage the qnas property of the
microsoft.graph.searchEntity entity.
get:
tags:
- Search.qna
summary: Microsoft Graph List qnas
description: Get a list of the qna objects and their properties.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-searchentity-list-qnas?view=graph-rest-1.0
operationId: search.ListQnas
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.search.qnaCollectionResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- Search.qna
summary: Microsoft Graph Create qna
description: Create a new qna object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-searchentity-post-qnas?view=graph-rest-1.0
operationId: search.CreateQnas
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.qna'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.qna'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/search/qnas/{qna-id}:
description: >-
Provides operations to manage the qnas property of the
microsoft.graph.searchEntity entity.
get:
tags:
- Search.qna
summary: Microsoft Graph Get qna
description: Read the properties and relationships of a qna object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-qna-get?view=graph-rest-1.0
operationId: search.GetQnas
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.qna'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Search.qna
summary: Microsoft Graph Update qna
description: Update the properties of a qna object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-qna-update?view=graph-rest-1.0
operationId: search.UpdateQnas
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.qna'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.search.qna'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Search.qna
summary: Microsoft Graph Delete qna
description: Delete a qna object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/search-qna-delete?view=graph-rest-1.0
operationId: search.DeleteQnas
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: qna-id
in: path
description: The unique identifier of qna
required: true
schema:
type: string
x-ms-docs-key-type: qna
/search/qnas/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- Search.qna
summary: Microsoft Graph Get the number of the resource
operationId: search.qnas.GetCount-ef94
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
/security/cases/ediscoveryCases/{ediscoveryCase-id}/searches:
description: >-
Provides operations to manage the searches property of the
microsoft.graph.security.ediscoveryCase entity.
get:
tags:
- security.casesRoot
summary: Microsoft Graph List searches
description: >-
Get the list of ediscoverySearch resources from an eDiscoveryCase
object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/security-ediscoverycase-list-searches?view=graph-rest-1.0
operationId: security.cases.ediscoveryCases.ListSearches
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.security.ediscoverySearchCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- security.casesRoot
summary: Microsoft Graph Create searches
description: Create a new ediscoverySearch object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/security-ediscoverycase-post-searches?view=graph-rest-1.0
operationId: security.cases.ediscoveryCases.CreateSearches
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/compon
# --- truncated at 32 KB (111 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/search-openapi-original.yml