CopilotConversation.Delete
Allows the app to delete Microsoft 365 Copilot conversations on behalf of the signed-in user.
Permission Details
Delete Microsoft 365 Copilot conversations
Allows the app to delete Microsoft 365 Copilot conversations on behalf of the signed-in user.
ed510a02-ac32-45f9-93e6-04864f7f7e47
Properties
Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Property | Type | Description |
|---|---|---|
createdDateTime |
date-timeRead-only |
The date and time when the conversation was created. |
displayName |
stringRead-only |
The display name of the conversation. |
id |
string |
The unique identifier for an entity. Read-only. |
messages |
copilotConversationMessage collection |
The ordered list of messages in the conversation. |
state |
copilotConversationState |
|
turnCount |
int32Read-only |
The number of turns in the conversation. |
JSON Representation
JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
{
"createdDateTime": "2026-01-01T00:00:00Z",
"displayName": "String",
"id": "String",
"messages": [
{
"@type": "copilotConversationMessage",
"id": "00000000-0000-0000-0000-000000000000"
}
],
"state": {
"@type": "copilotConversationState",
"id": "00000000-0000-0000-0000-000000000000"
},
"turnCount": 0
}
Relationships
Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Relationship | Type | Description |
|---|---|---|
messages |
copilotConversationMessage collection |
The ordered list of messages in the conversation. |
state |
copilotConversationState |
Related state data exposed by this resource. |
Graph Methods
Microsoft Graph v1.0 endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.
No API methods available for this version.
Microsoft Graph beta endpoints are not available from refreshed Microsoft Learn or Microsoft Graph OpenAPI metadata for this permission.
No API methods available for this version.
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[] { "CopilotConversation.Delete" };
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/copilotconversation")
.GetAsync();
import { Client } from "@microsoft/microsoft-graph-client";
import { InteractiveBrowserCredential } from "@azure/identity";
const credential = new InteractiveBrowserCredential({
clientId: "YOUR_CLIENT_ID",
tenantId: "YOUR_TENANT_ID",
redirectUri: "http://localhost"
});
const token = await credential.getToken(["CopilotConversation.Delete"]);
const client = Client.init({
authProvider: (done) => done(null, token.token)
});
const response = await client.api("/copilotconversation").get();
Connect-MgGraph -Scopes "CopilotConversation.Delete"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/copilotconversation"
from azure.identity import InteractiveBrowserCredential
import requests
credential = InteractiveBrowserCredential(
client_id="YOUR_CLIENT_ID",
tenant_id="YOUR_TENANT_ID"
)
token = credential.get_token("CopilotConversation.Delete")
response = requests.get(
"https://graph.microsoft.com/v1.0/copilotconversation",
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 CopilotConversation.Delete
Grant Admin Consent
Users can consent to this permission during sign-in.