← API reference
CANONICAL TYPE REFERENCE

ChatMessageState

A single message in a chat session

Unique message identifier

Message role (user, assistant, system)

contentString

Plain text content

Structured custom app content (for app dev context)

Tool calls made during this message (assistant messages only)

Input tokens used for this message (assistant messages only)

Output tokens generated for this message (assistant messages only)

Message creation timestamp (ISO8601)

View exact SDL
"""A single message in a chat session"""
type ChatMessageState {
  """Unique message identifier"""
  id: ChatMessageID!
  """Message role (user, assistant, system)"""
  role: ChatMessageRole!
  """Plain text content"""
  content: String
  """Structured custom app content (for app dev context)"""
  customAppContent: CustomAppContent
  """Tool calls made during this message (assistant messages only)"""
  toolCalls: [ChatToolCall!]
  """Input tokens used for this message (assistant messages only)"""
  inputTokens: Int
  """Output tokens generated for this message (assistant messages only)"""
  outputTokens: Int
  """Message creation timestamp (ISO8601)"""
  createdAt: ISO8601!
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.