Send a follow-up message
curl --request POST \
--url https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"message": "<string>"
}
'import requests
url = "https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages"
payload = { "message": "<string>" }
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({message: '<string>'})
};
fetch('https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages', 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://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages",
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([
'message' => '<string>'
]),
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://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages"
payload := strings.NewReader("{\n \"message\": \"<string>\"\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://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"message\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages")
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 \"message\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"chat": {
"id": "<string>",
"organizationId": "<string>",
"name": "<string>",
"status": "generating",
"source": "api",
"memberId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"userMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"assistantMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
}{
"data": {
"chat": {
"id": "<string>",
"organizationId": "<string>",
"name": "<string>",
"status": "generating",
"source": "api",
"memberId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"userMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"assistantMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "RateLimitExceeded",
"detail": "<string>",
"retryAfterMs": 123
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}Chats
Send a follow-up message
Sends the next message in an existing chat, continuing the conversation. Works like “Start a chat”: use the wait parameter to receive the finished response directly, or poll the assistant message (or stream its events) after receiving HTTP 202. Only one response can be generating per chat at a time; sending while the assistant is busy returns HTTP 409.
POST
/
api
/
public
/
organizations
/
{orgId}
/
chats
/
{chatId}
/
messages
Send a follow-up message
curl --request POST \
--url https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"message": "<string>"
}
'import requests
url = "https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages"
payload = { "message": "<string>" }
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({message: '<string>'})
};
fetch('https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages', 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://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages",
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([
'message' => '<string>'
]),
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://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages"
payload := strings.NewReader("{\n \"message\": \"<string>\"\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://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"message\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://charts.basedash.com/api/public/organizations/{orgId}/chats/{chatId}/messages")
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 \"message\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"chat": {
"id": "<string>",
"organizationId": "<string>",
"name": "<string>",
"status": "generating",
"source": "api",
"memberId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"userMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"assistantMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
}{
"data": {
"chat": {
"id": "<string>",
"organizationId": "<string>",
"name": "<string>",
"status": "generating",
"source": "api",
"memberId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"userMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"assistantMessage": {
"id": "<string>",
"chatId": "<string>",
"role": "user",
"status": "generating",
"parentId": "<string>",
"text": "<string>",
"parts": [
{
"id": "<string>",
"type": "text",
"content": "<string>",
"externalId": "<string>",
"name": "<string>",
"phase": "commentary",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"charts": [
{
"chartId": "<string>",
"chartVersionId": "<string>",
"title": "<string>",
"imageUrl": "<string>",
"mimeType": "<string>",
"width": 123,
"height": 123
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}{
"error": {
"title": "RateLimitExceeded",
"detail": "<string>",
"retryAfterMs": 123
}
}{
"error": {
"title": "<string>",
"detail": "<string>"
}
}Authorizations
API key authentication using Bearer token format: Bearer <basedash_api_key>
Headers
A unique key (up to 255 characters) that makes retries safe: repeating a request with the same key and body within 30 days returns the original result instead of creating a duplicate. Reusing a key with a different body returns HTTP 409; repeating one whose chat was since deleted returns HTTP 404.
Maximum string length:
255Query Parameters
Maximum number of seconds (1-300) to hold the request open while the assistant responds. If the response finishes in time the completed message is returned; otherwise the request returns HTTP 202 with the in-progress message. Omit to return immediately.
Required range:
1 <= x <= 300Body
application/json
The follow-up message to send to the AI agent. Maximum 10,000 characters.
Required string length:
1 - 10000Response
The assistant finished responding
Show child attributes
Show child attributes