ESC
Type to search...

CopilotConversation.Delete

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the app to delete Microsoft 365 Copilot conversations on behalf of the signed-in user.

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

Permission Details

Delegated Permission User consent allowed

Delete Microsoft 365 Copilot conversations

Allows the app to delete Microsoft 365 Copilot conversations on behalf of the signed-in user.

Properties

Microsoft Graph beta exact-category

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

Microsoft Graph beta exact-category

JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.

JSON representation
{
  "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

Microsoft Graph beta schema-derived

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

Delegated access App-only access
No Learn or OpenAPI mapping available

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.

No Learn or OpenAPI mapping available

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.

No Microsoft Learn PowerShell mapping available

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 docs
No Microsoft Learn PowerShell mapping available

Microsoft 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 docs

Code Examples

C# / .NET SDK
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();
JavaScript
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();
PowerShell
Connect-MgGraph -Scopes "CopilotConversation.Delete"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/copilotconversation"
Python
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

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 Delegated permissions and search for CopilotConversation.Delete

4

Grant Admin Consent

Users can consent to this permission during sign-in.