← API reference
CANONICAL TYPE REFERENCE

ChatSessionState

A chat session for AI-assisted conversations

Unique session identifier

User who owns this session

Associated custom app (if any)

AI adapter used for this session

titleString!

Session title

Session context/purpose

Optional system prompt override

modelString

Optional model override

Messages in this session (visible to user)

Cumulative input tokens used across all messages

Cumulative output tokens generated across all messages

createdAtString!

Session creation timestamp (ISO8601)

updatedAtString!

Last update timestamp (ISO8601)

View exact SDL
"""A chat session for AI-assisted conversations"""
type ChatSessionState {
  """Unique session identifier"""
  id: ChatSessionID!
  """User who owns this session"""
  userId: UserID!
  """Associated custom app (if any)"""
  customAppId: CustomAppID
  """AI adapter used for this session"""
  adapterId: AIAdapterID!
  """Session title"""
  title: String!
  """Session context/purpose"""
  context: ChatSessionContext!
  """Optional system prompt override"""
  systemPrompt: String
  """Optional model override"""
  model: String
  """Messages in this session (visible to user)"""
  messages: [ChatMessageState!]!
  """Cumulative input tokens used across all messages"""
  totalInputTokens: Int!
  """Cumulative output tokens generated across all messages"""
  totalOutputTokens: Int!
  """Session creation timestamp (ISO8601)"""
  createdAt: String!
  """Last update timestamp (ISO8601)"""
  updatedAt: String!
}

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