Skip to main content
POST
/
assistants
Create Assistant
curl --request POST \
  --url https://api.b-bot.space/v2/assistants \
  --header 'Content-Type: application/json' \
  --data '{
  "assistant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "graph_id": "<string>",
  "config": {},
  "context": {},
  "metadata": {},
  "if_exists": "raise",
  "name": "<string>",
  "description": "<string>"
}'
{
  "assistant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "graph_id": "<string>",
  "config": {
    "tags": [
      "<string>"
    ],
    "recursion_limit": 123,
    "configurable": {}
  },
  "context": {},
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "version": 123,
  "name": "<string>",
  "description": "<string>"
}

Body

application/json

Payload for creating an assistant.

​
graph_id
string
required

The ID of the graph the assistant should use. The graph ID is normally set in your langgraph.json configuration.

​
assistant_id
string<uuid>

The ID of the assistant. If not provided, a random UUID will be generated.

​
config
object

Configuration to use for the graph. Useful when graph is configurable and you want to create different assistants based on different configurations.

​
context
object

Static context added to the assistant.

​
metadata
object

Metadata to add to assistant.

​
if_exists
enum<string>
default:raise

How to handle duplicate creation. Must be either 'raise' (raise error if duplicate), or 'do_nothing' (return existing assistant).

Available options:
raise,
do_nothing
​
name
string

The name of the assistant. Defaults to 'Untitled'.

​
description
string | null

The description of the assistant. Defaults to null.

Response

Success

​
assistant_id
string<uuid>
required

The ID of the assistant.

​
graph_id
string
required

The ID of the graph.

​
config
object
required

The assistant config.

​
created_at
string<date-time>
required

The time the assistant was created.

​
updated_at
string<date-time>
required

The last time the assistant was updated.

​
metadata
object
required

The assistant metadata.

​
context
object

Static context added to the assistant.

​
version
integer

The version of the assistant

​
name
string

The name of the assistant

​
description
string | null

The description of the assistant

⌘I