Skip to main content
POST
Search Assistants

Body

application/json

Request model for assistant search

name
string | null

Filter by assistant name

description
string | null

Filter by assistant description

graph_id
string | null

Filter by graph ID

limit
integer | null
default:20

Maximum results

Required range: 1 <= x <= 100
offset
integer | null
default:0

Results offset

Required range: x >= 0
metadata
Metadata · object | null

Metadata to use for searching and filtering assistants.

sort_by
enum<string> | null

Field to sort by (SDK-compatible).

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

Sort direction (SDK-compatible). Defaults to 'desc' when sort_by is set.

Available options:
asc,
desc

Response

Successful Response

assistant_id
string
required

Unique identifier for the assistant.

name
string
required

Human-readable name of the assistant.

graph_id
string
required

Identifier of the graph this assistant executes.

user_id
string
required

Identifier of the user who owns this assistant.

version
integer
required

The version of the assistant.

created_at
string<date-time>
required

Timestamp when the assistant was created.

updated_at
string<date-time>
required

Timestamp when the assistant was last updated.

description
string | null

Optional description of the assistant's purpose.

config
Config · object

Configuration passed to the graph at runtime.

context
Context · object

Context variables available to the graph during execution.

metadata_dict
Metadata Dict · object

Arbitrary metadata for searching and filtering.