FIfireblocks
Genie (Beta)

Send a message to a Genie session

Sends a question to Genie and returns a single answer. Reuse the sessionId from the original session on follow-up messages to continue the conversation with prior context.

Note: This endpoint is currently in beta and might be subject to changes.

post/genie/sessions/{sessionId}/messages

Request

Path parameters

sessionIdstring required
Example:7c1b2e1c-1c2a-4f3a-9c2d-2e0a8a1f8e1a

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

Headers

Idempotency-Keystring

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.

Request body

contentstring required

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

Example request

{
  "content": "What is the latest balance on my BTC vault?"
}

Response

Genie response

idstring required

The unique identifier of the message.

sessionIdstring required

The Genie session this message belongs to.

rolestring required

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

contentstring required

The natural-language body of the message.

createdAtinteger

Message creation timestamp in epoch milliseconds.

Example response

{
  "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
}

Changes

No recorded changes to this operation across all 1 revision of this API.