SearchConfiguration.ReadWrite.All

Allows the app to read and write search configuration, on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the SearchConfiguration.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	0e778b85-fefa-466d-9eec-750569d92122	b1a7d408-cab0-47d2-a2a5-a74a3733600d
DisplayText	Read and write your organization's search configuration	Read and write your organization's search configuration
Description	Allows the app to read and write search configurations, without a signed-in user.	Allows the app to read and write search configuration, on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /search/acronyms/{acronymsId}
	DELETE /search/bookmarks/{bookmarksId}
	DELETE /search/qnas/{qnaId}
	GET /search/acronyms
	GET /search/acronyms/{acronymsId}
	GET /search/bookmarks
	GET /search/bookmarks/{bookmarksId}
	GET /search/qnas
	GET /search/qnas/{qnaId}
	PATCH /search/acronyms/{acronymsId}
	PATCH /search/bookmarks/{bookmarksId}
	PATCH /search/qnas/{qnaId}
	POST /search/acronyms
	POST /search/bookmarks
	POST /search/qnas

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /search/acronyms/{acronymsId}
	DELETE /search/bookmarks/{bookmarksId}
	DELETE /search/qnas/{qnaId}
	GET /search/acronyms
	GET /search/acronyms/{acronymsId}
	GET /search/bookmarks
	GET /search/bookmarks/{bookmarksId}
	GET /search/qnas
	GET /search/qnas/{qnaId}
	PATCH /search/acronyms/{acronymsId}
	PATCH /search/bookmarks/{bookmarksId}
	PATCH /search/qnas/{qnaId}
	POST /search/acronyms
	POST /search/bookmarks
	POST /search/qnas

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgSearchAcronym
	Get-MgSearchBookmark
	Get-MgSearchQna
	New-MgSearchAcronym
	New-MgSearchBookmark
	New-MgSearchQna
	Remove-MgSearchAcronym
	Remove-MgSearchBookmark
	Remove-MgSearchQna
	Update-MgSearchAcronym
	Update-MgSearchBookmark
	Update-MgSearchQna

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaSearchAcronym
	Get-MgBetaSearchBookmark
	Get-MgBetaSearchQna
	New-MgBetaSearchAcronym
	New-MgBetaSearchBookmark
	New-MgBetaSearchQna
	Remove-MgBetaSearchAcronym
	Remove-MgBetaSearchBookmark
	Remove-MgBetaSearchQna
	Update-MgBetaSearchAcronym
	Update-MgBetaSearchBookmark
	Update-MgBetaSearchQna

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: acronym

Property	Type	Description
description	String	A brief description of the acronym that gives users more information about the acronym and what it stands for. Inherited from searchAnswer.
displayName	String	The actual short form or acronym. Inherited from searchAnswer.
id	String	The unique identifier (GUID) for the acronym. Inherited from entity.
lastModifiedBy	microsoft.graph.identitySet	Details of the user who created or last modified the acronym. Inherited from searchAnswer. Read-only.
lastModifiedDateTime	DateTimeOffset	Date and time when the acronym was created or last edited. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from searchAnswer. Read-only.
standsFor	String	What the acronym stands for.
state	microsoft.graph.search.answerState	State of the acronym. Possible values are: `published`, `draft`, `excluded`, `unknownFutureValue`.
webUrl	String	The URL of the page or website where users can go for more information about the acronym. Inherited from searchAnswer.

Graph reference: answerKeyword

Property	Type	Description
keywords	String collection	A collection of keywords used to trigger the search answer.
matchSimilarKeywords	Boolean	If `true`, indicates that the search term contains similar words to the keywords that should trigger the search answer.
reservedKeywords	String collection	Unique keywords that guarantee the search answer is triggered.

Graph reference: answerVariant

Property	Type	Description
description	String	The answer variation description that is shown on the search results page.
displayName	String	The answer variation name that is displayed in search results.
languageTag	String	The country or region that can view this answer variation.
platform	microsoft.graph.devicePlatformType	The device or operating system that can view this answer variation. Possible values are: `android`, `androidForWork`, `ios`, `macOS`, `windowsPhone81`, `windowsPhone81AndLater`, `windows10AndLater`, `androidWorkProfile`, `unknown`, `androidASOP`, `androidMobileApplicationManagement`, `iOSMobileApplicationManagement`, `unknownFutureValue`.
webUrl	String	The URL link for the answer variation. When users select this answer variation from the search results, they're directed to the specified URL.

Graph reference: bookmark

Property	Type	Description
availabilityEndDateTime	DateTimeOffset	Date and time when the bookmark stops appearing as a search result. Set as `null` for always available. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
availabilityStartDateTime	DateTimeOffset	Date and time when the bookmark starts to appear as a search result. Set as `null` for always available. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
categories	String collection	Categories commonly used to describe this bookmark. For example, `IT` and `HR`.
description	String	The bookmark description that is shown on the search results page. Inherited from searchAnswer.
displayName	String	The bookmark name that is displayed in search results. Inherited from searchAnswer.
groupIds	String collection	The list of security groups that are able to view this bookmark.
isSuggested	Boolean	`True` if this bookmark was suggested to the admin, by a user, or was mined and suggested by Microsoft. Read-only.
id	String	The unique identifier (GUID) for the bookmark. Inherited from searchAnswer.
keywords	microsoft.graph.search.answerKeyword	Keywords that trigger this bookmark to appear in search results.
languageTags	String collection	A list of geographically specific language names in which this bookmark can be viewed. Each language tag value follows the pattern {language}-{region}. For example, `en-us` is English as used in the United States. For the list of possible values, see Supported language tags.
lastModifiedBy	microsoft.graph.identitySet	Details of the user who created or last modified the bookmark. Inherited from searchAnswer. Read-only.
lastModifiedDateTime	DateTimeOffset	Date and time when the bookmark was created or last edited. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Inherited from searchAnswer. Read-only.
platforms	microsoft.graph.devicePlatformType collection	List of devices and operating systems that are able to view this bookmark. Possible values are: `android`, `androidForWork`, `ios`, `macOS`, `windowsPhone81`, `windowsPhone81AndLater`, `windows10AndLater`, `androidWorkProfile`, `unknown`, `androidASOP`, `androidMobileApplicationManagement`, `iOSMobileApplicationManagement`, `unknownFutureValue`.
powerAppIds	String collection	List of Power Apps associated with this bookmark. If users add existing Power Apps to a bookmark, they can complete tasks directly on the search results page, such as entering vacation time or reporting expenses.
state	microsoft.graph.search.answerState	State of the bookmark. Possible values are: `published`, `draft`, `excluded`, `unknownFutureValue`.
targetedVariations	microsoft.graph.search.answerVariant collection	Variations of a bookmark for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings apply to all variations.
webUrl	String	The URL link for the bookmark. When users select this bookmark from the search results, they're directed to the specified URL. Inherited from searchAnswer.

Graph reference: qna

Property	Type	Description
availabilityEndDateTime	DateTimeOffset	Date and time when the QnA stops appearing as a search result. Set as `null` for always available. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
availabilityStartDateTime	DateTimeOffset	Date and time when the QnA starts to appear as a search result. Set as `null` for always available. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.
description	String	Answer that is displayed in search results. Inherited from searchAnswer.
displayName	String	Question that is displayed in search results. Inherited from searchAnswer.
groupIds	String collection	The list of security groups that are able to view this QnA.
id	String	The unique identifier (GUID) for the QnA. Inherited from searchAnswer.
isSuggested	Boolean	`True` if a user or Microsoft suggested this QnA to the admin. Read-only.
keywords	microsoft.graph.search.answerKeyword	Keywords that trigger this QnA to appear in search results.
languageTags	String collection	A list of geographically specific language names in which this QnA can be viewed. Each language tag value follows the pattern {language}-{region}. For example, `en-us` is English as used in the United States. For the list of possible values, see Supported language tags.
lastModifiedBy	microsoft.graph.identitySet	Details of the user who created or last modified the QnA. Inherited from searchAnswer. Read-only.
lastModifiedDateTime	DateTimeOffset	Date and time when the QnA was created or last edited. Inherited from searchAnswer. Read-only.
platforms	microsoft.graph.devicePlatformType collection	List of devices and operating systems that are able to view this QnA. Possible values are: `android`, `androidForWork`, `ios`, `macOS`, `windowsPhone81`, `windowsPhone81AndLater`, `windows10AndLater`, `androidWorkProfile`, `unknown`, `androidASOP`, `androidMobileApplicationManagement`, `iOSMobileApplicationManagement`, `unknownFutureValue`.
state	microsoft.graph.search.answerState	State of the QnA. Possible values are: `published`, `draft`, `excluded`, `unknownFutureValue`.
targetedVariations	microsoft.graph.search.answerVariant collection	Variations of a QnA for different countries or devices. Use when you need to show different content to users based on their device, country/region, or both. The date and group settings apply to all variations.
webUrl	String	The URL link for the QnA. When users select this QnA from the search results, they're directed to the specified URL. Inherited from searchAnswer.

Graph reference: searchAnswer

Property	Type	Description
description	String	The search answer description that is shown on the search results page.
displayName	String	The search answer name that is displayed in search results.
id	String	The unique identifier (GUID) for the search answer. Inherited from entity.
lastModifiedBy	microsoft.graph.identitySet	Details of the user who created or last modified the search answer. Read-only.
lastModifiedDateTime	DateTimeOffset	Date and time when the search answer was created or last edited. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.
webUrl	String	The URL link for the search answer. When users select this search answer from the search results, they are directed to the specified URL.

Table of Contents

SearchConfiguration.ReadWrite.All

Graph Methods

Resources