Skip to main content
POST
/
genie
/
sessions
/
{sessionId}
/
messages
TypeScript
const response: Promise<FireblocksResponse<GenieSendMessageResponse>> = fireblocks.genieBeta.sendGenieMessage(genieBetaApiSendGenieMessageRequest);
{
  "id": "0a237534-399f-4487-a869-72567b71511a",
  "sessionId": "7c1b2e1c-1c2a-4f3a-9c2d-2e0a8a1f8e1a",
  "role": "ASSISTANT",
  "content": "The latest balance on the BTC vault is 0.4231 BTC.",
  "createdAt": 1735603200000
}

Documentation Index

Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Idempotency-Key
string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Path Parameters

​
sessionId
string
required

The Genie session ID returned from POST /genie/sessions.

Example:

"7c1b2e1c-1c2a-4f3a-9c2d-2e0a8a1f8e1a"

Body

application/json
​
content
string
required

The natural-language question or instruction to send to Genie.

Example:

"What is the latest balance on my BTC vault?"

Response

Genie response

​
id
string
required

The unique identifier of the message.

Example:

"0a237534-399f-4487-a869-72567b71511a"

​
sessionId
string
required

The Genie session this message belongs to.

Example:

"7c1b2e1c-1c2a-4f3a-9c2d-2e0a8a1f8e1a"

​
role
string
required

Who produced the message — USER for the customer-supplied query, ASSISTANT for the Genie response.

Example:

"ASSISTANT"

​
content
string
required

The natural-language body of the message.

Example:

"The latest balance on the BTC vault is 0.4231 BTC."

​
createdAt
integer<int64>

Message creation timestamp in epoch milliseconds.

Example:

1735603200000