ESC
Type to search...

SearchConfiguration.Read.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read All Resources

Allows the app to read search configurations, without a signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read your organization's search configuration

Allows the app to read search configurations, without a signed-in user.

Delegated Permission Admin consent required

Read your organization's search configuration

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

Properties

Microsoft Graph v1.0 endpoint-derived

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
description stringNullable 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 for an entity. Read-only.
lastModifiedBy object Details of the user who created or last modified the search answer. Read-only.
lastModifiedDateTime date-timeNullable 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.
standsFor stringNullable What the acronym stands for.
state search.answerState
webUrl stringNullable The URL link for the search answer. When users select this search answer from the search results, they are directed to the specified URL.

JSON Representation

Microsoft Graph v1.0 endpoint-derived

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation
{
  "description": "String",
  "displayName": "String",
  "id": "String",
  "lastModifiedBy": {
    "sample": "value"
  },
  "lastModifiedDateTime": "2026-01-01T00:00:00Z",
  "standsFor": "String",
  "state": {
    "@type": "search.answerState",
    "id": "00000000-0000-0000-0000-000000000000"
  },
  "webUrl": "String"
}

Relationships

Microsoft Graph v1.0 schema-derived

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
state search.answerState Related state data exposed by this resource.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /search/acronyms
GET /search/acronyms/{acronymsId}
GET /search/bookmarks
GET /search/bookmarks/{bookmarksId}
GET /search/qnas
GET /search/qnas/{qnaId}
POST /search/acronyms
POST /search/bookmarks
POST /search/qnas
PATCH /search/acronyms/{acronymsId}
PATCH /search/bookmarks/{bookmarksId}
PATCH /search/qnas/{qnaId}
DELETE /search/acronyms/{acronymsId}
DELETE /search/bookmarks/{bookmarksId}
DELETE /search/qnas/{qnaId}
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /search/acronyms
GET /search/acronyms/{acronymsId}
GET /search/bookmarks
GET /search/bookmarks/{bookmarksId}
GET /search/qnas
GET /search/qnas/{qnaId}
POST /search/acronyms
POST /search/bookmarks
POST /search/qnas
PATCH /search/acronyms/{acronymsId}
PATCH /search/bookmarks/{bookmarksId}
PATCH /search/qnas/{qnaId}
DELETE /search/acronyms/{acronymsId}
DELETE /search/bookmarks/{bookmarksId}
DELETE /search/qnas/{qnaId}
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgSearchAcronym /search/acronyms
List acronyms
Get-MgSearchAcronym /search/acronyms/{acronymsId}
Get acronym
Get-MgSearchBookmark /search/bookmarks
List bookmarks
Get-MgSearchBookmark /search/bookmarks/{bookmarksId}
Get bookmark
Get-MgSearchQna /search/qnas
List qnas
Get-MgSearchQna /search/qnas/{qnaId}
Get qna
New-MgSearchAcronym /search/acronyms
Create acronym
New-MgSearchBookmark /search/bookmarks
Create bookmark
New-MgSearchQna /search/qnas
Create qna
Remove-MgSearchAcronym /search/acronyms/{acronymsId}
Delete acronym
Remove-MgSearchBookmark /search/bookmarks/{bookmarksId}
Delete bookmark
Remove-MgSearchQna /search/qnas/{qnaId}
Delete qna
Update-MgSearchAcronym /search/acronyms/{acronymsId}
Update acronym
Update-MgSearchBookmark /search/bookmarks/{bookmarksId}
Update bookmark
Update-MgSearchQna /search/qnas/{qnaId}
Update qna
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaSearchAcronym /search/acronyms
List acronyms
Get-MgBetaSearchAcronym /search/acronyms/{acronymsId}
Get acronym
Get-MgBetaSearchBookmark /search/bookmarks
List bookmarks
Get-MgBetaSearchBookmark /search/bookmarks/{bookmarksId}
Get bookmark
Get-MgBetaSearchQna /search/qnas
List qnas
Get-MgBetaSearchQna /search/qnas/{qnaId}
Get qna
New-MgBetaSearchAcronym /search/acronyms
Create acronym
New-MgBetaSearchBookmark /search/bookmarks
Create bookmark
New-MgBetaSearchQna /search/qnas
Create qna
Remove-MgBetaSearchAcronym /search/acronyms/{acronymsId}
Delete acronym
Remove-MgBetaSearchBookmark /search/bookmarks/{bookmarksId}
Delete bookmark
Remove-MgBetaSearchQna /search/qnas/{qnaId}
Delete qna
Update-MgBetaSearchAcronym /search/acronyms/{acronymsId}
Update acronym
Update-MgBetaSearchBookmark /search/bookmarks/{bookmarksId}
Update bookmark
Update-MgBetaSearchQna /search/qnas/{qnaId}
Update qna

Code Examples

C# / .NET SDK
Create acronym
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models.Search;

var requestBody = new Acronym
{
	DisplayName = "DNN",
	StandsFor = "Deep Neural Network",
	Description = "A deep neural network is a neural network with a certain level of complexity, a neural network with more than two layers.",
	WebUrl = "http://microsoft.com/deep-neural-network",
	State = AnswerState.Draft,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Search.Acronyms.PostAsync(requestBody);
JavaScript
Create acronym
const options = {
	authProvider,
};

const client = Client.init(options);

const acronym = {
  displayName: 'DNN',
  standsFor: 'Deep Neural Network',
  description: 'A deep neural network is a neural network with a certain level of complexity, a neural network with more than two layers.',
  webUrl: 'http://microsoft.com/deep-neural-network',
  state: 'draft'
};

await client.api('/search/acronyms')
	.post(acronym);
PowerShell
Create acronym
Import-Module Microsoft.Graph.Search

$params = @{
	displayName = "DNN"
	standsFor = "Deep Neural Network"
	description = "A deep neural network is a neural network with a certain level of complexity, a neural network with more than two layers."
	webUrl = "http://microsoft.com/deep-neural-network"
	state = "draft"
}

New-MgSearchAcronym -BodyParameter $params
Python
Create acronym
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.search.acronym import Acronym
from msgraph.generated.models.answer_state import AnswerState
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Acronym(
	display_name = "DNN",
	stands_for = "Deep Neural Network",
	description = "A deep neural network is a neural network with a certain level of complexity, a neural network with more than two layers.",
	web_url = "http://microsoft.com/deep-neural-network",
	state = AnswerState.Draft,
)

result = await graph_client.search.acronyms.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for SearchConfiguration.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.