Start a Conversation

Start a Conversation activity in the Databricks connector.

Project compatibility

Windows | Cross-platform

Overview

Description	API Method	API Path
Ask a natural-language question to open a new Genie conversation. Requires space_id and content; returns conversation_id and message_id for follow-up calls.	POST	/genie_conversations/{space_id}

Input

Parameter	Description	Data Type
Space Id *	ID of the Genie space. For example, 01f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4.	string
Message Content *	Natural-language question to send to the Genie space. For example, Which products had the highest revenue last quarter?.	string

* Required parameter.

Output

Parameter	Description	Data Type
Content	The content of the Genie message.	string
Conversation ID	ID of the Genie conversation.	string
Message ID	ID of the Genie message.	string
ID	Unique identifier of the returned record.	string
Space ID	ID of the Genie space.	string
Status	SUBMITTED, FETCHING_METADATA, ASKING_AI, EXECUTING_QUERY, COMPLETED, FAILED, CANCELLED.	string
Attachments	Genie response attachments (text answer and/or generated SQL query).	array
Query Result	Result of the SQL query that Genie generated for the message.	object
Conversation	The Genie conversation that contains the message.	object
Message	The Genie message, including its content and status.	object
Created Timestamp	Time the message was created, as a Unix timestamp in milliseconds.	integer

Note:

You might see variations in the output depending on where you run the activity. In API workflows and Maestro Flow, a single response object containing all the fields is returned. In RPA workflows, not all fields are exposed, but you can still retrieve them from the exposed response object.