Skip to main content
POST
/
assistants
/
search
Search Assistants
curl --request POST \
  --url https://api.b-bot.space/v2/assistants/search \
  --header 'Content-Type: application/json' \
  --data '{
  "metadata": {},
  "graph_id": "<string>",
  "limit": 10,
  "offset": 0,
  "sort_by": "assistant_id",
  "sort_order": "asc",
  "select": [
    "assistant_id"
  ]
}'
[
  {
    "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 listing assistants.

metadata
object

Metadata to filter by. Exact match filter for each KV pair.

graph_id
string

The ID of the graph to filter by. The graph ID is normally set in your langgraph.json configuration.

limit
integer
default:10

The maximum number of results to return.

Required range: 1 <= x <= 1000
offset
integer
default:0

The number of results to skip.

Required range: x >= 0
sort_by
enum<string>

The field to sort by.

Available options:
assistant_id,
created_at,
updated_at,
name,
graph_id
sort_order
enum<string>

The order to sort by.

Available options:
asc,
desc
select
enum<string>[]

Specify which fields to return. If not provided, all fields are returned.

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