| title | session resource type |
|---|---|
| description | Represents a session in Security Copilot. |
| author | spunukol |
| ms.date | 07/17/2025 |
| ms.localizationpriority | medium |
| ms.subservice | security-copilot |
| doc_type | resourcePageType |
Namespace: microsoft.graph.security.securityCopilot
[!INCLUDE beta-disclaimer]
Represents a session within a workspace in Security Copilot.
| Method | Return type | Description |
|---|---|---|
| List | microsoft.graph.security.securityCopilot.session collection | Get a list of the session objects and their properties. |
| Create | microsoft.graph.security.securityCopilot.session | Create a new session object. |
| Get | microsoft.graph.security.securityCopilot.session | Read the properties and relationships of microsoft.graph.security.securityCopilot.session object. |
| Update | microsoft.graph.security.securityCopilot.session | Update the properties of a session object. |
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | Created time of the session (UTC). |
| displayName | String | Display name for the session. |
| id | String | Represents the unique ID of the Security Copilot session. Inherits from entity. |
| lastModifiedDateTime | DateTimeOffset | Last modified time of the session (UTC). Updated when displayName changes. |
| Relationship | Type | Description |
|---|---|---|
| prompts | microsoft.graph.security.securityCopilot.prompt collection | The collection of prompts in the session. |
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.security.securityCopilot.session",
"id": "String (identifier)",
"displayName": "String",
"lastModifiedDateTime": "String (timestamp)",
"createdDateTime": "String (timestamp)"
}