Create Background Run
curl --request POST \
--url https://api.b-bot.space/api/v2/threads/{thread_id}/runs \
--header 'Content-Type: application/json' \
--header 'bbot-api-key: <api-key>' \
--data '
{
"channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"checkpoint": {
"thread_id": "<string>",
"checkpoint_ns": "<string>",
"checkpoint_id": "<string>",
"checkpoint_map": {}
},
"input": {},
"command": {
"update": {},
"resume": {},
"goto": {
"node": "<string>",
"input": {}
}
},
"metadata": {},
"config": {
"tags": [
"<string>"
],
"recursion_limit": 123,
"configurable": {}
},
"context": {},
"webhook": "<string>",
"interrupt_before": "*",
"interrupt_after": "*",
"stream_mode": [
"values"
],
"stream_subgraphs": false,
"stream_resumable": false,
"on_disconnect": "cancel",
"feedback_keys": [
"<string>"
],
"multitask_strategy": "enqueue",
"if_not_exists": "reject",
"after_seconds": 123,
"checkpoint_during": false,
"durability": "async"
}
'import requests
url = "https://api.b-bot.space/api/v2/threads/{thread_id}/runs"
payload = {
"channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"checkpoint": {
"thread_id": "<string>",
"checkpoint_ns": "<string>",
"checkpoint_id": "<string>",
"checkpoint_map": {}
},
"input": {},
"command": {
"update": {},
"resume": {},
"goto": {
"node": "<string>",
"input": {}
}
},
"metadata": {},
"config": {
"tags": ["<string>"],
"recursion_limit": 123,
"configurable": {}
},
"context": {},
"webhook": "<string>",
"interrupt_before": "*",
"interrupt_after": "*",
"stream_mode": ["values"],
"stream_subgraphs": False,
"stream_resumable": False,
"on_disconnect": "cancel",
"feedback_keys": ["<string>"],
"multitask_strategy": "enqueue",
"if_not_exists": "reject",
"after_seconds": 123,
"checkpoint_during": False,
"durability": "async"
}
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({
channel_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
checkpoint: {
thread_id: '<string>',
checkpoint_ns: '<string>',
checkpoint_id: '<string>',
checkpoint_map: {}
},
input: {},
command: {update: {}, resume: {}, goto: {node: '<string>', input: {}}},
metadata: {},
config: {tags: ['<string>'], recursion_limit: 123, configurable: {}},
context: {},
webhook: '<string>',
interrupt_before: '*',
interrupt_after: '*',
stream_mode: ['values'],
stream_subgraphs: false,
stream_resumable: false,
on_disconnect: 'cancel',
feedback_keys: ['<string>'],
multitask_strategy: 'enqueue',
if_not_exists: 'reject',
after_seconds: 123,
checkpoint_during: false,
durability: 'async'
})
};
fetch('https://api.b-bot.space/api/v2/threads/{thread_id}/runs', 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/{thread_id}/runs",
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([
'channel_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'checkpoint' => [
'thread_id' => '<string>',
'checkpoint_ns' => '<string>',
'checkpoint_id' => '<string>',
'checkpoint_map' => [
]
],
'input' => [
],
'command' => [
'update' => [
],
'resume' => [
],
'goto' => [
'node' => '<string>',
'input' => [
]
]
],
'metadata' => [
],
'config' => [
'tags' => [
'<string>'
],
'recursion_limit' => 123,
'configurable' => [
]
],
'context' => [
],
'webhook' => '<string>',
'interrupt_before' => '*',
'interrupt_after' => '*',
'stream_mode' => [
'values'
],
'stream_subgraphs' => false,
'stream_resumable' => false,
'on_disconnect' => 'cancel',
'feedback_keys' => [
'<string>'
],
'multitask_strategy' => 'enqueue',
'if_not_exists' => 'reject',
'after_seconds' => 123,
'checkpoint_during' => false,
'durability' => 'async'
]),
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/{thread_id}/runs"
payload := strings.NewReader("{\n \"channel_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"checkpoint\": {\n \"thread_id\": \"<string>\",\n \"checkpoint_ns\": \"<string>\",\n \"checkpoint_id\": \"<string>\",\n \"checkpoint_map\": {}\n },\n \"input\": {},\n \"command\": {\n \"update\": {},\n \"resume\": {},\n \"goto\": {\n \"node\": \"<string>\",\n \"input\": {}\n }\n },\n \"metadata\": {},\n \"config\": {\n \"tags\": [\n \"<string>\"\n ],\n \"recursion_limit\": 123,\n \"configurable\": {}\n },\n \"context\": {},\n \"webhook\": \"<string>\",\n \"interrupt_before\": \"*\",\n \"interrupt_after\": \"*\",\n \"stream_mode\": [\n \"values\"\n ],\n \"stream_subgraphs\": false,\n \"stream_resumable\": false,\n \"on_disconnect\": \"cancel\",\n \"feedback_keys\": [\n \"<string>\"\n ],\n \"multitask_strategy\": \"enqueue\",\n \"if_not_exists\": \"reject\",\n \"after_seconds\": 123,\n \"checkpoint_during\": false,\n \"durability\": \"async\"\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/{thread_id}/runs")
.header("bbot-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"checkpoint\": {\n \"thread_id\": \"<string>\",\n \"checkpoint_ns\": \"<string>\",\n \"checkpoint_id\": \"<string>\",\n \"checkpoint_map\": {}\n },\n \"input\": {},\n \"command\": {\n \"update\": {},\n \"resume\": {},\n \"goto\": {\n \"node\": \"<string>\",\n \"input\": {}\n }\n },\n \"metadata\": {},\n \"config\": {\n \"tags\": [\n \"<string>\"\n ],\n \"recursion_limit\": 123,\n \"configurable\": {}\n },\n \"context\": {},\n \"webhook\": \"<string>\",\n \"interrupt_before\": \"*\",\n \"interrupt_after\": \"*\",\n \"stream_mode\": [\n \"values\"\n ],\n \"stream_subgraphs\": false,\n \"stream_resumable\": false,\n \"on_disconnect\": \"cancel\",\n \"feedback_keys\": [\n \"<string>\"\n ],\n \"multitask_strategy\": \"enqueue\",\n \"if_not_exists\": \"reject\",\n \"after_seconds\": 123,\n \"checkpoint_during\": false,\n \"durability\": \"async\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.b-bot.space/api/v2/threads/{thread_id}/runs")
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 \"channel_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"checkpoint\": {\n \"thread_id\": \"<string>\",\n \"checkpoint_ns\": \"<string>\",\n \"checkpoint_id\": \"<string>\",\n \"checkpoint_map\": {}\n },\n \"input\": {},\n \"command\": {\n \"update\": {},\n \"resume\": {},\n \"goto\": {\n \"node\": \"<string>\",\n \"input\": {}\n }\n },\n \"metadata\": {},\n \"config\": {\n \"tags\": [\n \"<string>\"\n ],\n \"recursion_limit\": 123,\n \"configurable\": {}\n },\n \"context\": {},\n \"webhook\": \"<string>\",\n \"interrupt_before\": \"*\",\n \"interrupt_after\": \"*\",\n \"stream_mode\": [\n \"values\"\n ],\n \"stream_subgraphs\": false,\n \"stream_resumable\": false,\n \"on_disconnect\": \"cancel\",\n \"feedback_keys\": [\n \"<string>\"\n ],\n \"multitask_strategy\": \"enqueue\",\n \"if_not_exists\": \"reject\",\n \"after_seconds\": 123,\n \"checkpoint_during\": false,\n \"durability\": \"async\"\n}"
response = http.request(request)
puts response.read_body{
"run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"status": "pending",
"metadata": {},
"kwargs": {},
"multitask_strategy": "reject"
}"<string>""<string>""<string>"Thread Runs
Create Background Run
Create a run in existing thread, return the run ID immediately. Don’t wait for the final run output.
POST
/
threads
/
{thread_id}
/
runs
Create Background Run
curl --request POST \
--url https://api.b-bot.space/api/v2/threads/{thread_id}/runs \
--header 'Content-Type: application/json' \
--header 'bbot-api-key: <api-key>' \
--data '
{
"channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"checkpoint": {
"thread_id": "<string>",
"checkpoint_ns": "<string>",
"checkpoint_id": "<string>",
"checkpoint_map": {}
},
"input": {},
"command": {
"update": {},
"resume": {},
"goto": {
"node": "<string>",
"input": {}
}
},
"metadata": {},
"config": {
"tags": [
"<string>"
],
"recursion_limit": 123,
"configurable": {}
},
"context": {},
"webhook": "<string>",
"interrupt_before": "*",
"interrupt_after": "*",
"stream_mode": [
"values"
],
"stream_subgraphs": false,
"stream_resumable": false,
"on_disconnect": "cancel",
"feedback_keys": [
"<string>"
],
"multitask_strategy": "enqueue",
"if_not_exists": "reject",
"after_seconds": 123,
"checkpoint_during": false,
"durability": "async"
}
'import requests
url = "https://api.b-bot.space/api/v2/threads/{thread_id}/runs"
payload = {
"channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"checkpoint": {
"thread_id": "<string>",
"checkpoint_ns": "<string>",
"checkpoint_id": "<string>",
"checkpoint_map": {}
},
"input": {},
"command": {
"update": {},
"resume": {},
"goto": {
"node": "<string>",
"input": {}
}
},
"metadata": {},
"config": {
"tags": ["<string>"],
"recursion_limit": 123,
"configurable": {}
},
"context": {},
"webhook": "<string>",
"interrupt_before": "*",
"interrupt_after": "*",
"stream_mode": ["values"],
"stream_subgraphs": False,
"stream_resumable": False,
"on_disconnect": "cancel",
"feedback_keys": ["<string>"],
"multitask_strategy": "enqueue",
"if_not_exists": "reject",
"after_seconds": 123,
"checkpoint_during": False,
"durability": "async"
}
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({
channel_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
checkpoint: {
thread_id: '<string>',
checkpoint_ns: '<string>',
checkpoint_id: '<string>',
checkpoint_map: {}
},
input: {},
command: {update: {}, resume: {}, goto: {node: '<string>', input: {}}},
metadata: {},
config: {tags: ['<string>'], recursion_limit: 123, configurable: {}},
context: {},
webhook: '<string>',
interrupt_before: '*',
interrupt_after: '*',
stream_mode: ['values'],
stream_subgraphs: false,
stream_resumable: false,
on_disconnect: 'cancel',
feedback_keys: ['<string>'],
multitask_strategy: 'enqueue',
if_not_exists: 'reject',
after_seconds: 123,
checkpoint_during: false,
durability: 'async'
})
};
fetch('https://api.b-bot.space/api/v2/threads/{thread_id}/runs', 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/{thread_id}/runs",
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([
'channel_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'checkpoint' => [
'thread_id' => '<string>',
'checkpoint_ns' => '<string>',
'checkpoint_id' => '<string>',
'checkpoint_map' => [
]
],
'input' => [
],
'command' => [
'update' => [
],
'resume' => [
],
'goto' => [
'node' => '<string>',
'input' => [
]
]
],
'metadata' => [
],
'config' => [
'tags' => [
'<string>'
],
'recursion_limit' => 123,
'configurable' => [
]
],
'context' => [
],
'webhook' => '<string>',
'interrupt_before' => '*',
'interrupt_after' => '*',
'stream_mode' => [
'values'
],
'stream_subgraphs' => false,
'stream_resumable' => false,
'on_disconnect' => 'cancel',
'feedback_keys' => [
'<string>'
],
'multitask_strategy' => 'enqueue',
'if_not_exists' => 'reject',
'after_seconds' => 123,
'checkpoint_during' => false,
'durability' => 'async'
]),
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/{thread_id}/runs"
payload := strings.NewReader("{\n \"channel_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"checkpoint\": {\n \"thread_id\": \"<string>\",\n \"checkpoint_ns\": \"<string>\",\n \"checkpoint_id\": \"<string>\",\n \"checkpoint_map\": {}\n },\n \"input\": {},\n \"command\": {\n \"update\": {},\n \"resume\": {},\n \"goto\": {\n \"node\": \"<string>\",\n \"input\": {}\n }\n },\n \"metadata\": {},\n \"config\": {\n \"tags\": [\n \"<string>\"\n ],\n \"recursion_limit\": 123,\n \"configurable\": {}\n },\n \"context\": {},\n \"webhook\": \"<string>\",\n \"interrupt_before\": \"*\",\n \"interrupt_after\": \"*\",\n \"stream_mode\": [\n \"values\"\n ],\n \"stream_subgraphs\": false,\n \"stream_resumable\": false,\n \"on_disconnect\": \"cancel\",\n \"feedback_keys\": [\n \"<string>\"\n ],\n \"multitask_strategy\": \"enqueue\",\n \"if_not_exists\": \"reject\",\n \"after_seconds\": 123,\n \"checkpoint_during\": false,\n \"durability\": \"async\"\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/{thread_id}/runs")
.header("bbot-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"channel_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"checkpoint\": {\n \"thread_id\": \"<string>\",\n \"checkpoint_ns\": \"<string>\",\n \"checkpoint_id\": \"<string>\",\n \"checkpoint_map\": {}\n },\n \"input\": {},\n \"command\": {\n \"update\": {},\n \"resume\": {},\n \"goto\": {\n \"node\": \"<string>\",\n \"input\": {}\n }\n },\n \"metadata\": {},\n \"config\": {\n \"tags\": [\n \"<string>\"\n ],\n \"recursion_limit\": 123,\n \"configurable\": {}\n },\n \"context\": {},\n \"webhook\": \"<string>\",\n \"interrupt_before\": \"*\",\n \"interrupt_after\": \"*\",\n \"stream_mode\": [\n \"values\"\n ],\n \"stream_subgraphs\": false,\n \"stream_resumable\": false,\n \"on_disconnect\": \"cancel\",\n \"feedback_keys\": [\n \"<string>\"\n ],\n \"multitask_strategy\": \"enqueue\",\n \"if_not_exists\": \"reject\",\n \"after_seconds\": 123,\n \"checkpoint_during\": false,\n \"durability\": \"async\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.b-bot.space/api/v2/threads/{thread_id}/runs")
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 \"channel_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"checkpoint\": {\n \"thread_id\": \"<string>\",\n \"checkpoint_ns\": \"<string>\",\n \"checkpoint_id\": \"<string>\",\n \"checkpoint_map\": {}\n },\n \"input\": {},\n \"command\": {\n \"update\": {},\n \"resume\": {},\n \"goto\": {\n \"node\": \"<string>\",\n \"input\": {}\n }\n },\n \"metadata\": {},\n \"config\": {\n \"tags\": [\n \"<string>\"\n ],\n \"recursion_limit\": 123,\n \"configurable\": {}\n },\n \"context\": {},\n \"webhook\": \"<string>\",\n \"interrupt_before\": \"*\",\n \"interrupt_after\": \"*\",\n \"stream_mode\": [\n \"values\"\n ],\n \"stream_subgraphs\": false,\n \"stream_resumable\": false,\n \"on_disconnect\": \"cancel\",\n \"feedback_keys\": [\n \"<string>\"\n ],\n \"multitask_strategy\": \"enqueue\",\n \"if_not_exists\": \"reject\",\n \"after_seconds\": 123,\n \"checkpoint_during\": false,\n \"durability\": \"async\"\n}"
response = http.request(request)
puts response.read_body{
"run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"channel_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"status": "pending",
"metadata": {},
"kwargs": {},
"multitask_strategy": "reject"
}"<string>""<string>""<string>"Authorizations
API key for authentication
Path Parameters
The ID of the thread.
Body
application/json
Payload for creating a run.
The distribution channel ID or graph name to run. If using graph name, will default to first distribution channel created from that graph.
The checkpoint to resume from.
Show child attributes
Show child attributes
The input to the graph.
The command to run.
Show child attributes
Show child attributes
Metadata to assign to the run.
The configuration for the assistant.
Show child attributes
Show child attributes
Static context added to the assistant.
Webhook to call after LangGraph API call is done.
Required string length:
1 - 65536Nodes to interrupt immediately before they get executed.
Available options:
* Nodes to interrupt immediately after they get executed.
Available options:
* The stream mode(s) to use.
Available options:
values, messages, messages-tuple, tasks, checkpoints, updates, events, debug, custom Whether to stream output from subgraphs.
Whether to persist the stream chunks in order to resume the stream later.
The disconnect mode to use. Must be one of 'cancel' or 'continue'.
Available options:
cancel, continue Feedback keys to assign to run.
Multitask strategy to use. Must be one of 'reject', 'interrupt', 'rollback', or 'enqueue'.
Available options:
reject, rollback, interrupt, enqueue How to handle missing thread. Must be either 'reject' (raise error if missing), or 'create' (create new thread).
Available options:
create, reject The number of seconds to wait before starting the run. Use to schedule future runs.
Whether to checkpoint during the run.
Durability level for the run. Must be one of 'sync', 'async', or 'exit'.
Available options:
sync, async, exit Response
Success
The ID of the run.
The ID of the thread.
The assistant that was used for this run.
The time the run was created.
The last time the run was updated.
The status of the run. One of 'pending', 'running', 'error', 'success', 'timeout', 'interrupted'.
Available options:
pending, running, error, success, timeout, interrupted The run metadata.
Strategy to handle concurrent runs on the same thread.
Available options:
reject, rollback, interrupt, enqueue