Skip to content
dbx tools

Type Alias: GenieMessage

GenieMessage = z.infer<typeof GenieMessageSchema>

Genie message snapshot widened with typed attachments and regeneration count.

GenieMessage fields

Section titled “GenieMessage fields”
  • content: User message content
  • conversation_id: Conversation ID
  • created_timestamp (optional): Timestamp when the message was created
  • error (optional): Error message if Genie failed to respond to the message
  • feedback (optional): User feedback for the message if provided
  • feedback.rating (optional): The feedback rating
  • id: Message ID. Legacy identifier, use message_id instead
  • last_updated_timestamp (optional): Timestamp when the message was last updated
  • message_id: Message ID
  • query_result (optional): The result of SQL query if the message includes a query attachment. Deprecated. Use query_result_metadata in GenieQueryAttachment instead.
  • query_result.is_truncated (optional): If result is truncated
  • query_result.row_count (optional): Row count of the result
  • query_result.statement_id (optional): Statement Execution API statement id. Use Get status, manifest, and result first chunk to get the full result data.
  • query_result.statement_id_signature (optional): JWT corresponding to the statement contained in this result
  • space_id: Genie space ID
  • status (optional): MessageStatus. The possible values are: * FETCHING_METADATA: Fetching metadata from the data sources. * FILTERING_CONTEXT: Running smart context step to determine relevant context. * ASKING_AI: Waiting for the LLM to respond to the user’s question. * PENDING_WAREHOUSE: Waiting for warehouse before the SQL query can start executing. * EXECUTING_QUERY: Executing a generated SQL query. Get the SQL query result by calling getMessageAttachmentQueryResult API. * FAILED: The response generation or query execution failed. See error field. * COMPLETED: Message processing is completed. Results are in the attachments field. Get the SQL query result by calling getMessageAttachmentQueryResult API. * SUBMITTED: Message has been submitted. * QUERY_RESULT_EXPIRED: SQL result is not available anymore. The user needs to rerun the query. Rerun the SQL query result by calling executeMessageAttachmentQuery API. * CANCELLED: Message has been cancelled.
  • user_id (optional): ID of the user who created the message