AgentCommunicationConfiguration.ReadWrite
Allows the app to read and update the communication configuration of agent blueprints on behalf of the signed-in user.
In short
AgentCommunicationConfiguration.ReadWrite is a delegated permission in the Microsoft Graph API, grouped under the AgentCommunicationConfiguration category. Allows the app to read and update the communication configuration of agent blueprints on behalf of the signed-in user. It grants read and write access to resources. This delegated permission requires admin consent.
Permission Details
Read and write agent communication configuration
Allows the app to read and update the communication configuration of agent blueprints on behalf of the signed-in user.
15e0db35-0641-4175-b014-c2cb39286338
Properties
Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Property | Type | Description |
|---|---|---|
endpointConfiguration |
agentEndpointConfiguration |
The endpoint binding (bot ID or callback URI) that the agent uses to receive messages. |
isOverridableAtAgentIdLevel |
Boolean |
Indicates whether individual agent instances created from this blueprint can override the endpointConfiguration. When true, each instance can override it; when false, every instance inherits it. Not nullable. |
teamworkConfiguration |
agentTeamworkConfiguration |
The per-conversation-context message notification settings (group chat, channel, one-on-one chat, and meeting chat) that agents use. |
id |
string |
The unique identifier for an entity. Read-only. |
JSON Representation
JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
{
"@odata.type": "#microsoft.graph.agentCommunicationConfiguration",
"isOverridableAtAgentIdLevel": "Boolean",
"endpointConfiguration": {
"@odata.type": "microsoft.graph.agentEndpointConfiguration"
},
"teamworkConfiguration": {
"@odata.type": "microsoft.graph.agentTeamworkConfiguration"
}
}
Relationships
Relationships metadata is not available for this permission mapping.
View resource documentationGraph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
No API methods available for this version.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph PowerShell v1.0 commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsMicrosoft Graph PowerShell beta commands are not available from refreshed Microsoft Learn PowerShell snippets for this permission.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsCode Examples
using Azure.Identity;
using Microsoft.Graph;
var scopes = new[] { "AgentCommunicationConfiguration.ReadWrite" };
var credential = new InteractiveBrowserCredential(
new InteractiveBrowserCredentialOptions
{
ClientId = "YOUR_CLIENT_ID",
TenantId = "YOUR_TENANT_ID",
RedirectUri = new Uri("http://localhost")
});
var graphClient = new GraphServiceClient(credential, scopes);
var response = await graphClient
.WithUrl("https://graph.microsoft.com/v1.0/applications/{id}/microsoft.graph.agentIdentityBlueprint/communicationConfiguration")
.GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/servicePrincipals/microsoft.graph.agentIdentity/1f554dbf-8c7a-42dc-8f92-1a3b4c5d6e7f/communicationConfiguration/reset')
.version('beta')
.post();
Connect-MgGraph -Scopes "AgentCommunicationConfiguration.ReadWrite"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/applications/{id}/microsoft.graph.agentIdentityBlueprint/communicationConfiguration"
from azure.identity import InteractiveBrowserCredential
import requests
credential = InteractiveBrowserCredential(
client_id="YOUR_CLIENT_ID",
tenant_id="YOUR_TENANT_ID"
)
token = credential.get_token("AgentCommunicationConfiguration.ReadWrite")
response = requests.get(
"https://graph.microsoft.com/v1.0/applications/{id}/microsoft.graph.agentIdentityBlueprint/communicationConfiguration",
headers={"Authorization": f"Bearer {token.token}"}
)
print(response.json())
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Delegated permissions and search for AgentCommunicationConfiguration.ReadWrite
Grant Admin Consent
This delegated permission requires admin consent.
Frequently asked questions
What is the AgentCommunicationConfiguration.ReadWrite Microsoft Graph permission?
AgentCommunicationConfiguration.ReadWrite is a delegated permission in the Microsoft Graph API, grouped under the AgentCommunicationConfiguration category. Allows the app to read and update the communication configuration of agent blueprints on behalf of the signed-in user. It grants read and write access to resources. This delegated permission requires admin consent. It is mapped to the Microsoft Graph agentcommunicationconfiguration resource type. 5 documented Microsoft Graph REST methods require it.
Is AgentCommunicationConfiguration.ReadWrite an application or a delegated permission?
AgentCommunicationConfiguration.ReadWrite is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.
Does AgentCommunicationConfiguration.ReadWrite require admin consent?
This delegated permission requires admin consent.
What is the permission ID (GUID) for AgentCommunicationConfiguration.ReadWrite?
For AgentCommunicationConfiguration.ReadWrite, the delegated (OAuth2 scope) ID is 15e0db35-0641-4175-b014-c2cb39286338. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.