Skip to main content
POST
Python (SDK)

Authorizations

tql_api_key
string
header
required

Headers

Connect-Protocol-Version
enum<number>
default:1
required

Define the version of the Connect protocol

Available options:
1
Connect-Timeout-Ms
number

Define the timeout, in ms

Body

application/json
chatId
string
includeCosts
boolean

Response

Success

usage
LlmUsage · object[]
contextWindowUsed
number<double>

range: [0, 1]

estimatedCost
number<double> | null

Estimated LLM-token cost (USD, list model prices). LLM only.

estimatedComputeCost
number<double> | null

Estimated sandbox/compute cost for this chat (USD): chat sandbox-seconds → ACUs → USD at the org's effective rate. Add to estimated_cost for the thread's total cost. Requires the console rate (0/omitted if unavailable).

sandboxId
string | null

The chat's sandbox id ({orgID}-{chatID}), set when the thread used any sandbox compute. Lets the UI deep-link to the sandbox detail. Empty/omitted when the thread had no sandbox usage.

estimatedComputeAcus
number<double> | null

Sandbox compute usage for this chat in ACUs (sandbox-seconds / 3600 × ACUs per instance-hour). The metered unit behind estimated_compute_cost; shown alongside the dollars. Independent of the console $ rate, so present whenever the thread used a sandbox.