Edit

Share via


processConversationMetadata

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents metadata for a content entry that is part of a conversation, for example, a chat message, and an AI interaction.

Inherits from processContentMetadataBase.

Properties

Property Type Description
accessedResources_v2 resourceAccessDetail collection Indicates the details about resources accessed by AI agents, including identifiers, access type, and status.
agents aiAgentInfo collection Indicates the information about an AI agent that participated in the preparation of the message.
content contentBase Represents the actual content, either as text (textContent) or binary data (binaryContent). Optional if metadata alone is sufficient for policy evaluation. Do not use for contentActivities. Inherited from processContentMetadataBase.
correlationId String An identifier used to group multiple related content entries (for example, different parts of the same file upload, messages in a conversation). Inherited from processContentMetadataBase.
createdDateTime DateTimeOffset Required. Timestamp when the original content was created (for example, file creation time, message sent time). Inherited from processContentMetadataBase.
identifier String Required. A unique identifier for this specific content entry within the context of the calling application or enforcement plane (for example, message ID, file path/URL). Inherited from processContentMetadataBase.
isTruncated Boolean Required. Indicates if the provided content has been truncated from its original form (for example, due to size limits). Inherited from processContentMetadataBase.
length Int64 The length of the original content in bytes. Inherited from processContentMetadataBase.
modifiedDateTime DateTimeOffset Required. Timestamp when the original content was last modified. For ephemeral content like messages, this might be the same as createdDateTime. Inherited from processContentMetadataBase.
name String Required. A descriptive name for the content (for example, file name, web page title, or chat message). Inherited from processContentMetadataBase.
parentMessageId String Identifier of the parent message in a threaded conversation, if applicable.
plugins aiInteractionPlugin collection List of plugins used during the generation of this message (relevant for AI/bot interactions).
sequenceNumber Int64 A sequence number indicating the order in which content was generated or should be processed, required when correlationId is used. Inherited from processContentMetadataBase.
accessedResources (deprecated) String collection List of resources (for example, file URLs, web URLs) accessed during the generation of this message (relevant for bot interactions). The accessedResources property is deprecated and stopped returning data on August 20, 2025. Going forward, use the accessedResources_v2 property.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.processConversationMetadata",
  "accessedResources": ["String"],
  "accessedResources_v2": [{"@odata.type": "microsoft.graph.resourceAccessDetail"}],
  "agents": [{"@odata.type": "microsoft.graph.aiAgentInfo"}],
  "content": {"@odata.type": "microsoft.graph.contentBase"},
  "correlationId": "String",
  "createdDateTime": "String (timestamp)",
  "identifier": "String",
  "isTruncated": "Boolean",
  "length": "Int64",
  "modifiedDateTime": "String (timestamp)",
  "name": "String",
  "parentMessageId": "String",
  "plugins": [{"@odata.type": "microsoft.graph.aiInteractionPlugin"}],
  "sequenceNumber": "Int64"
}