Search Threads
curl --request POST \
--url https://api.b-bot.space/api/v2/threads/search \
--header 'Content-Type: application/json' \
--header 'bbot-api-key: <api-key>' \
--data '
{
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"metadata": {},
"values": {},
"limit": 10,
"offset": 0,
"select": []
}
'import requests
url = "https://api.b-bot.space/api/v2/threads/search"
payload = {
"ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"metadata": {},
"values": {},
"limit": 10,
"offset": 0,
"select": []
}
headers = {
"bbot-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'bbot-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
metadata: {},
values: {},
limit: 10,
offset: 0,
select: []
})
};
fetch('https://api.b-bot.space/api/v2/threads/search', 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://api.b-bot.space/api/v2/threads/search",
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([
'ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'metadata' => [
],
'values' => [
],
'limit' => 10,
'offset' => 0,
'select' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"bbot-api-key: <api-key>"
],
]);
$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://api.b-bot.space/api/v2/threads/search"
payload := strings.NewReader("{\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"metadata\": {},\n \"values\": {},\n \"limit\": 10,\n \"offset\": 0,\n \"select\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("bbot-api-key", "<api-key>")
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://api.b-bot.space/api/v2/threads/search")
.header("bbot-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"metadata\": {},\n \"values\": {},\n \"limit\": 10,\n \"offset\": 0,\n \"select\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.b-bot.space/api/v2/threads/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["bbot-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"metadata\": {},\n \"values\": {},\n \"limit\": 10,\n \"offset\": 0,\n \"select\": []\n}"
response = http.request(request)
puts response.read_body[
{
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"metadata": {},
"status": "idle",
"config": {},
"values": {},
"interrupts": {}
}
]"<string>"Threads
Search Threads
Search for threads.
This endpoint also functions as the endpoint to list all threads.
POST
/
threads
/
search
Search Threads
curl --request POST \
--url https://api.b-bot.space/api/v2/threads/search \
--header 'Content-Type: application/json' \
--header 'bbot-api-key: <api-key>' \
--data '
{
"ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"metadata": {},
"values": {},
"limit": 10,
"offset": 0,
"select": []
}
'import requests
url = "https://api.b-bot.space/api/v2/threads/search"
payload = {
"ids": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"metadata": {},
"values": {},
"limit": 10,
"offset": 0,
"select": []
}
headers = {
"bbot-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'bbot-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
ids: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
metadata: {},
values: {},
limit: 10,
offset: 0,
select: []
})
};
fetch('https://api.b-bot.space/api/v2/threads/search', 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://api.b-bot.space/api/v2/threads/search",
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([
'ids' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'metadata' => [
],
'values' => [
],
'limit' => 10,
'offset' => 0,
'select' => [
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"bbot-api-key: <api-key>"
],
]);
$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://api.b-bot.space/api/v2/threads/search"
payload := strings.NewReader("{\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"metadata\": {},\n \"values\": {},\n \"limit\": 10,\n \"offset\": 0,\n \"select\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("bbot-api-key", "<api-key>")
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://api.b-bot.space/api/v2/threads/search")
.header("bbot-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"metadata\": {},\n \"values\": {},\n \"limit\": 10,\n \"offset\": 0,\n \"select\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.b-bot.space/api/v2/threads/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["bbot-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"ids\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"metadata\": {},\n \"values\": {},\n \"limit\": 10,\n \"offset\": 0,\n \"select\": []\n}"
response = http.request(request)
puts response.read_body[
{
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"metadata": {},
"status": "idle",
"config": {},
"values": {},
"interrupts": {}
}
]"<string>"Authorizations
API key for authentication
Body
application/json
Payload for listing threads.
List of thread IDs to include. Others are excluded.
Thread metadata to filter on.
State values to filter on.
Thread status to filter on.
Available options:
idle, busy, interrupted, error Maximum number to return.
Required range:
1 <= x <= 1000Offset to start from.
Required range:
x >= 0Sort by field.
Available options:
thread_id, status, created_at, updated_at Sort order.
Available options:
asc, desc Specify which fields to return. If not provided, all fields are returned.
Available options:
thread_id, created_at, updated_at, metadata, config, context, status, values, interrupts Response
Success
The ID of the thread.
The time the thread was created.
The last time the thread was updated.
The thread metadata.
The status of the thread.
Available options:
idle, busy, interrupted, error The thread config.
The current state of the thread.
The current interrupts of the thread.