GenieService (Databricks SDK for Java 0.94.0 API)

```
@Generated
public interface GenieService
```
Genie provides a no-code experience for business users, powered by AI/BI. Analysts set up spaces that business users can use to ask questions using natural language. Genie uses data registered to Unity Catalog and requires at least CAN USE permission on a Pro or Serverless SQL warehouse. Also, Databricks Assistant must be enabled.
This is the high-level interface, that contains generated methods.
Evolving: this interface is under development. Method signatures may change.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`GenieMessage`	`createMessage(GenieCreateConversationMessageRequest genieCreateConversationMessageRequest)` Create new message in a [conversation](:method:genie/startconversation).
`GenieSpace`	`createSpace(GenieCreateSpaceRequest genieCreateSpaceRequest)` Creates a Genie space from a serialized payload.
`void`	`deleteConversation(GenieDeleteConversationRequest genieDeleteConversationRequest)` Delete a conversation.
`void`	`deleteConversationMessage(GenieDeleteConversationMessageRequest genieDeleteConversationMessageRequest)` Delete a conversation message.
`GenieGetMessageQueryResultResponse`	`executeMessageAttachmentQuery(GenieExecuteMessageAttachmentQueryRequest genieExecuteMessageAttachmentQueryRequest)` Execute the SQL for a message query attachment.
`GenieGetMessageQueryResultResponse`	`executeMessageQuery(GenieExecuteMessageQueryRequest genieExecuteMessageQueryRequest)` DEPRECATED: Use [Execute Message Attachment Query](:method:genie/executemessageattachmentquery) instead.
`GenieGenerateDownloadFullQueryResultResponse`	`generateDownloadFullQueryResult(GenieGenerateDownloadFullQueryResultRequest genieGenerateDownloadFullQueryResultRequest)` Initiates a new SQL execution and returns a `download_id` and `download_id_signature` that you can use to track the progress of the download.
`GenieGetDownloadFullQueryResultResponse`	`getDownloadFullQueryResult(GenieGetDownloadFullQueryResultRequest genieGetDownloadFullQueryResultRequest)` After [Generating a Full Query Result Download](:method:genie/generatedownloadfullqueryresult) and successfully receiving a `download_id` and `download_id_signature`, use this API to poll the download progress.
`GenieMessage`	`getMessage(GenieGetConversationMessageRequest genieGetConversationMessageRequest)` Get message from conversation.
`GenieGetMessageQueryResultResponse`	`getMessageAttachmentQueryResult(GenieGetMessageAttachmentQueryResultRequest genieGetMessageAttachmentQueryResultRequest)` Get the result of SQL query if the message has a query attachment.
`GenieGetMessageQueryResultResponse`	`getMessageQueryResult(GenieGetMessageQueryResultRequest genieGetMessageQueryResultRequest)` DEPRECATED: Use [Get Message Attachment Query Result](:method:genie/getmessageattachmentqueryresult) instead.
`GenieGetMessageQueryResultResponse`	`getMessageQueryResultByAttachment(GenieGetQueryResultByAttachmentRequest genieGetQueryResultByAttachmentRequest)` DEPRECATED: Use [Get Message Attachment Query Result](:method:genie/getmessageattachmentqueryresult) instead.
`GenieSpace`	`getSpace(GenieGetSpaceRequest genieGetSpaceRequest)` Get details of a Genie Space.
`GenieListConversationMessagesResponse`	`listConversationMessages(GenieListConversationMessagesRequest genieListConversationMessagesRequest)` List messages in a conversation
`GenieListConversationsResponse`	`listConversations(GenieListConversationsRequest genieListConversationsRequest)` Get a list of conversations in a Genie Space.
`GenieListSpacesResponse`	`listSpaces(GenieListSpacesRequest genieListSpacesRequest)` Get list of Genie Spaces.
`void`	`sendMessageFeedback(GenieSendMessageFeedbackRequest genieSendMessageFeedbackRequest)` Send feedback for a message.
`GenieStartConversationResponse`	`startConversation(GenieStartConversationMessageRequest genieStartConversationMessageRequest)` Start a new conversation.
`void`	`trashSpace(GenieTrashSpaceRequest genieTrashSpaceRequest)` Move a Genie Space to the trash.
`GenieSpace`	`updateSpace(GenieUpdateSpaceRequest genieUpdateSpaceRequest)` Updates a Genie space with a serialized payload.

- Method Detail
  - createMessage
```
GenieMessage createMessage(GenieCreateConversationMessageRequest genieCreateConversationMessageRequest)
```
    Create new message in a [conversation](:method:genie/startconversation). The AI response uses all previously created messages in the conversation to respond.
  - createSpace
```
GenieSpace createSpace(GenieCreateSpaceRequest genieCreateSpaceRequest)
```
    Creates a Genie space from a serialized payload.
  - deleteConversation
```
void deleteConversation(GenieDeleteConversationRequest genieDeleteConversationRequest)
```
    Delete a conversation.
  - deleteConversationMessage
```
void deleteConversationMessage(GenieDeleteConversationMessageRequest genieDeleteConversationMessageRequest)
```
    Delete a conversation message.
  - executeMessageAttachmentQuery
```
GenieGetMessageQueryResultResponse executeMessageAttachmentQuery(GenieExecuteMessageAttachmentQueryRequest genieExecuteMessageAttachmentQueryRequest)
```
    Execute the SQL for a message query attachment. Use this API when the query attachment has expired and needs to be re-executed.
  - executeMessageQuery
```
GenieGetMessageQueryResultResponse executeMessageQuery(GenieExecuteMessageQueryRequest genieExecuteMessageQueryRequest)
```
    DEPRECATED: Use [Execute Message Attachment Query](:method:genie/executemessageattachmentquery) instead.
  - generateDownloadFullQueryResult
```
GenieGenerateDownloadFullQueryResultResponse generateDownloadFullQueryResult(GenieGenerateDownloadFullQueryResultRequest genieGenerateDownloadFullQueryResultRequest)
```
    Initiates a new SQL execution and returns a `download_id` and `download_id_signature` that you can use to track the progress of the download. The query result is stored in an external link and can be retrieved using the [Get Download Full Query Result](:method:genie/getdownloadfullqueryresult) API. Both `download_id` and `download_id_signature` must be provided when calling the Get endpoint.
    ----
    ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.**
    When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be used to download the results directly from . As a short-lived is embedded in this URL, you should protect the URL.
    Because URLs are already generated with embedded temporary s, you must not set an `Authorization` header in the download requests.
    See [Execute Statement](:method:statementexecution/executestatement) for more details.
    ----
  - getDownloadFullQueryResult
```
GenieGetDownloadFullQueryResultResponse getDownloadFullQueryResult(GenieGetDownloadFullQueryResultRequest genieGetDownloadFullQueryResultRequest)
```
    After [Generating a Full Query Result Download](:method:genie/generatedownloadfullqueryresult) and successfully receiving a `download_id` and `download_id_signature`, use this API to poll the download progress. Both `download_id` and `download_id_signature` are required to call this endpoint. When the download is complete, the API returns the result in the `EXTERNAL_LINKS` disposition, containing one or more external links to the query result files.
    ----
    ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.**
    When you use the `EXTERNAL_LINKS` disposition, a short-lived, URL is generated, which can be used to download the results directly from . As a short-lived is embedded in this URL, you should protect the URL.
    Because URLs are already generated with embedded temporary s, you must not set an `Authorization` header in the download requests.
    See [Execute Statement](:method:statementexecution/executestatement) for more details.
    ----
  - getMessage
```
GenieMessage getMessage(GenieGetConversationMessageRequest genieGetConversationMessageRequest)
```
    Get message from conversation.
  - getMessageAttachmentQueryResult
```
GenieGetMessageQueryResultResponse getMessageAttachmentQueryResult(GenieGetMessageAttachmentQueryResultRequest genieGetMessageAttachmentQueryResultRequest)
```
    Get the result of SQL query if the message has a query attachment. This is only available if a message has a query attachment and the message status is `EXECUTING_QUERY` OR `COMPLETED`.
  - getMessageQueryResult
```
GenieGetMessageQueryResultResponse getMessageQueryResult(GenieGetMessageQueryResultRequest genieGetMessageQueryResultRequest)
```
    DEPRECATED: Use [Get Message Attachment Query Result](:method:genie/getmessageattachmentqueryresult) instead.
  - getMessageQueryResultByAttachment
```
GenieGetMessageQueryResultResponse getMessageQueryResultByAttachment(GenieGetQueryResultByAttachmentRequest genieGetQueryResultByAttachmentRequest)
```
    DEPRECATED: Use [Get Message Attachment Query Result](:method:genie/getmessageattachmentqueryresult) instead.
  - getSpace
```
GenieSpace getSpace(GenieGetSpaceRequest genieGetSpaceRequest)
```
    Get details of a Genie Space.
  - listConversationMessages
```
GenieListConversationMessagesResponse listConversationMessages(GenieListConversationMessagesRequest genieListConversationMessagesRequest)
```
    List messages in a conversation
  - listConversations
```
GenieListConversationsResponse listConversations(GenieListConversationsRequest genieListConversationsRequest)
```
    Get a list of conversations in a Genie Space.
  - listSpaces
```
GenieListSpacesResponse listSpaces(GenieListSpacesRequest genieListSpacesRequest)
```
    Get list of Genie Spaces.
  - sendMessageFeedback
```
void sendMessageFeedback(GenieSendMessageFeedbackRequest genieSendMessageFeedbackRequest)
```
    Send feedback for a message.
  - startConversation
```
GenieStartConversationResponse startConversation(GenieStartConversationMessageRequest genieStartConversationMessageRequest)
```
    Start a new conversation.
  - trashSpace
```
void trashSpace(GenieTrashSpaceRequest genieTrashSpaceRequest)
```
    Move a Genie Space to the trash.
  - updateSpace
```
GenieSpace updateSpace(GenieUpdateSpaceRequest genieUpdateSpaceRequest)
```
    Updates a Genie space with a serialized payload.

Interface GenieService

Method Summary

Method Detail

createMessage

createSpace

deleteConversation

deleteConversationMessage

executeMessageAttachmentQuery

executeMessageQuery

generateDownloadFullQueryResult

getDownloadFullQueryResult

getMessage

getMessageAttachmentQueryResult

getMessageQueryResult

getMessageQueryResultByAttachment

getSpace

listConversationMessages

listConversations

listSpaces

sendMessageFeedback

startConversation

trashSpace

updateSpace