How to retrieve Genie's narrative text summary (final_summary) via API?

[OliverMini]

Dear Databricks Community,

I am trying to programmatically access the narrative text summary that Databricks Genie displays in the UI, but I cannot find it in the public API responses.

What I see in the UI: When I ask Genie a question, the UI displays a helpful narrative summary like:

"The top 10 records from the sales order lines table have been retrieved. Examples include:- OrderLineID: 231412, CustomerName: Example Customer, StockItemName: Example Stock Item, Quantity: 8, LineNetAmount: 252.0"

What I've tried:

1. Using the public API endpoint: /api/2.0/genie/spaces/{space_id}/conversations/{conversation_id}/messages/{message_id}
   • This returns attachments with query.description (e.g., "You want to see the top 10 sales order lines...") but NOT the full narrative summary
2. Checked the Databricks SDK (WorkspaceClient().genie.start_conversation_and_wait())
   • Same issue - only returns query description, not the narrative text
3. Used browser network inspection and found the text in: /ajax-api/2.0/data-rooms/{space_id}/conversations/{conversation_id}/messages/{message_id}
   • This endpoint returns attachments[].final_summary.result_summary with the full narrative
   • However, this endpoint requires CSRF tokens and is meant for browser use only (returns 403 error from Python)

What I have discovered: The narrative summary exists in a final_summary field that appears in the /ajax-api/ endpoint but not in the public /api/ endpoints.

Question: Is there a supported way to retrieve Genie's final_summary narrative text programmatically? Or is this feature only available through the web UI currently?

Thank you for the help!

[stbjelcevic · Accepted solution]

Hi @OliverMini ,

The “answer summary”/“final summary” shown in the UI is a newer attachment type and is not yet exposed in the public API. It is being tracked internally as a potential enhancement as there appears to be a good amount of demand for it, but I cannot guarantee if/when if will be added.

[no2]

I understand that this is a fast moving world right now, but the limitations of the Genie API are a constant source of frustration for my company. 

I find it strange that your response says "as there appears to be a good amount of demand for it." 

You just need to assume that any feature released in the UI is also in-demand for the API. Ideally the features should be released at the same time. 

[tulga-orosoo]

Dear Databricks Community,

My team is trying the exact same thing and facing this limitation. Is there any timeline for the enhancement? 

[stbjelcevic]

@OliverMini and @tulga-orosoo I just got notified that text answer summaries will now return in the get message API as a text attachment! See https://docs.databricks.com/api/workspace/genie/getmessage

[tulga-orosoo]

Hey, thank you very much! Confirm the text summary is in the response now.