Create Dashboard

Create Chat

curl --request POST \
  --url https://app.textql.com/v2/chats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "model": "gemini_3_5_flash",
  "tools": {
    "connector_ids": [
      123
    ],
    "sql_enabled": true,
    "python_enabled": true,
    "web_search_enabled": true,
    "ontology_enabled": true,
    "tableau_enabled": true,
    "powerbi_enabled": true,
    "google_drive_enabled": true
  },
  "connector_ids": [
    123
  ]
}
'

import requests

url = "https://app.textql.com/v2/chats"

payload = {
    "question": "<string>",
    "chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "model": "gemini_3_5_flash",
    "tools": {
        "connector_ids": [123],
        "sql_enabled": True,
        "python_enabled": True,
        "web_search_enabled": True,
        "ontology_enabled": True,
        "tableau_enabled": True,
        "powerbi_enabled": True,
        "google_drive_enabled": True
    },
    "connector_ids": [123]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    question: '<string>',
    chat_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    model: 'gemini_3_5_flash',
    tools: {
      connector_ids: [123],
      sql_enabled: true,
      python_enabled: true,
      web_search_enabled: true,
      ontology_enabled: true,
      tableau_enabled: true,
      powerbi_enabled: true,
      google_drive_enabled: true
    },
    connector_ids: [123]
  })
};

fetch('https://app.textql.com/v2/chats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.textql.com/v2/chats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'chat_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'model' => 'gemini_3_5_flash',
    'tools' => [
        'connector_ids' => [
                123
        ],
        'sql_enabled' => true,
        'python_enabled' => true,
        'web_search_enabled' => true,
        'ontology_enabled' => true,
        'tableau_enabled' => true,
        'powerbi_enabled' => true,
        'google_drive_enabled' => true
    ],
    'connector_ids' => [
        123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.textql.com/v2/chats"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"gemini_3_5_flash\",\n  \"tools\": {\n    \"connector_ids\": [\n      123\n    ],\n    \"sql_enabled\": true,\n    \"python_enabled\": true,\n    \"web_search_enabled\": true,\n    \"ontology_enabled\": true,\n    \"tableau_enabled\": true,\n    \"powerbi_enabled\": true,\n    \"google_drive_enabled\": true\n  },\n  \"connector_ids\": [\n    123\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.textql.com/v2/chats")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"gemini_3_5_flash\",\n  \"tools\": {\n    \"connector_ids\": [\n      123\n    ],\n    \"sql_enabled\": true,\n    \"python_enabled\": true,\n    \"web_search_enabled\": true,\n    \"ontology_enabled\": true,\n    \"tableau_enabled\": true,\n    \"powerbi_enabled\": true,\n    \"google_drive_enabled\": true\n  },\n  \"connector_ids\": [\n    123\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.textql.com/v2/chats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"gemini_3_5_flash\",\n  \"tools\": {\n    \"connector_ids\": [\n      123\n    ],\n    \"sql_enabled\": true,\n    \"python_enabled\": true,\n    \"web_search_enabled\": true,\n    \"ontology_enabled\": true,\n    \"tableau_enabled\": true,\n    \"powerbi_enabled\": true,\n    \"google_drive_enabled\": true\n  },\n  \"connector_ids\": [\n    123\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "model": "<string>",
  "response": "<string>",
  "chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assets": [
    {
      "name": "<string>",
      "type": "<string>",
      "url": "<string>",
      "content": "<string>",
      "cell_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "message_cell_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body"
  }
}

{
  "error": {
    "code": "unauthenticated",
    "message": "Authentication required"
  }
}

{
  "error": {
    "code": "permission_denied",
    "message": "Insufficient permissions"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "code": "internal",
    "message": "Internal server error"
  }
}

POST

chats

Create Chat

curl --request POST \
  --url https://app.textql.com/v2/chats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "model": "gemini_3_5_flash",
  "tools": {
    "connector_ids": [
      123
    ],
    "sql_enabled": true,
    "python_enabled": true,
    "web_search_enabled": true,
    "ontology_enabled": true,
    "tableau_enabled": true,
    "powerbi_enabled": true,
    "google_drive_enabled": true
  },
  "connector_ids": [
    123
  ]
}
'

import requests

url = "https://app.textql.com/v2/chats"

payload = {
    "question": "<string>",
    "chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "model": "gemini_3_5_flash",
    "tools": {
        "connector_ids": [123],
        "sql_enabled": True,
        "python_enabled": True,
        "web_search_enabled": True,
        "ontology_enabled": True,
        "tableau_enabled": True,
        "powerbi_enabled": True,
        "google_drive_enabled": True
    },
    "connector_ids": [123]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    question: '<string>',
    chat_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    model: 'gemini_3_5_flash',
    tools: {
      connector_ids: [123],
      sql_enabled: true,
      python_enabled: true,
      web_search_enabled: true,
      ontology_enabled: true,
      tableau_enabled: true,
      powerbi_enabled: true,
      google_drive_enabled: true
    },
    connector_ids: [123]
  })
};

fetch('https://app.textql.com/v2/chats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.textql.com/v2/chats",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'chat_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'model' => 'gemini_3_5_flash',
    'tools' => [
        'connector_ids' => [
                123
        ],
        'sql_enabled' => true,
        'python_enabled' => true,
        'web_search_enabled' => true,
        'ontology_enabled' => true,
        'tableau_enabled' => true,
        'powerbi_enabled' => true,
        'google_drive_enabled' => true
    ],
    'connector_ids' => [
        123
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.textql.com/v2/chats"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"gemini_3_5_flash\",\n  \"tools\": {\n    \"connector_ids\": [\n      123\n    ],\n    \"sql_enabled\": true,\n    \"python_enabled\": true,\n    \"web_search_enabled\": true,\n    \"ontology_enabled\": true,\n    \"tableau_enabled\": true,\n    \"powerbi_enabled\": true,\n    \"google_drive_enabled\": true\n  },\n  \"connector_ids\": [\n    123\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.textql.com/v2/chats")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"gemini_3_5_flash\",\n  \"tools\": {\n    \"connector_ids\": [\n      123\n    ],\n    \"sql_enabled\": true,\n    \"python_enabled\": true,\n    \"web_search_enabled\": true,\n    \"ontology_enabled\": true,\n    \"tableau_enabled\": true,\n    \"powerbi_enabled\": true,\n    \"google_drive_enabled\": true\n  },\n  \"connector_ids\": [\n    123\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.textql.com/v2/chats")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"model\": \"gemini_3_5_flash\",\n  \"tools\": {\n    \"connector_ids\": [\n      123\n    ],\n    \"sql_enabled\": true,\n    \"python_enabled\": true,\n    \"web_search_enabled\": true,\n    \"ontology_enabled\": true,\n    \"tableau_enabled\": true,\n    \"powerbi_enabled\": true,\n    \"google_drive_enabled\": true\n  },\n  \"connector_ids\": [\n    123\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "model": "<string>",
  "response": "<string>",
  "chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assets": [
    {
      "name": "<string>",
      "type": "<string>",
      "url": "<string>",
      "content": "<string>",
      "cell_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "message_cell_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request body"
  }
}

{
  "error": {
    "code": "unauthenticated",
    "message": "Authentication required"
  }
}

{
  "error": {
    "code": "permission_denied",
    "message": "Insufficient permissions"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}

{
  "error": {
    "code": "internal",
    "message": "Internal server error"
  }
}

There is no dedicated dashboard creation endpoint. Dashboards are created by starting a chat and asking Ana to build one. Ana will generate the dashboard code, attach the relevant data sources, and return a link to the live dashboard.

To create a dashboard, use the Create Chat or Stream Chat endpoint and ask Ana to build a dashboard in your question.

curl -X POST "https://app.textql.com/v2/chats" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "Build a dashboard showing monthly revenue by region for the last 12 months",
    "connector_ids": [1]
  }'

Ana will respond with a chat that includes a dashboard asset. The response contains a dashboard_url in the assets array that links to the live dashboard.

Authorizations

Authorization

string

header

required

API key or JWT token

Body

question

string

required

The question to ask

chat_id

string<uuid>

Existing chat ID to continue a conversation

model

string

Optional model to run this chat on, as an id from GET /v2/models (e.g. gemini_3_5_flash). Omit to use the organization's default model. Only valid on new chats — supplying it together with chat_id returns 400, and a model the caller's org/role does not permit returns 403.

Example:

"gemini_3_5_flash"

tools

object

Tool configuration. Enable specific tools for this chat session.

Show child attributes

connector_ids

integer<int32>[]

Connector IDs to query (shorthand for tools.connector_ids)

Response

Chat response

string<uuid>

Message ID

created_at

string<date-time>

model

string

LLM model name (e.g. default, sonnet_4, opus_4)

response

string

Markdown-formatted answer

chat_id

string<uuid>

Chat session ID

assets

object[]

Assets produced by this response. Earlier turns' assets are available via Get Chat.

Show child attributes

Delete Playbook List Chats with Dashboards

Getting Started

API Keys

Members

Roles

Chat

Connectors

Playbooks

Dashboards

Sandcastles

Changes

Authorizations

Body

Response