- Assistants
- List Assistants
Assistants
List Assistants
curl --request GET \
--url https://app.backboard.io/api/assistants \
--header 'X-API-Key: <api-key>' \
--header 'authorization: <authorization>' \
--header 'x_session_token: <x_session_token>'List all assistants for the currently authenticated user with pagination support.
Filtering by name
Pass name to return only assistants with that exact name:
curl "https://app.backboard.io/api/assistants?name=Support%20Bot" \
-H "X-API-Key: YOUR_API_KEY"
This is an exact match, not a search — partial names and wildcards do not match. The filter is applied before pagination, so skip and limit page through the filtered results.
Use this when looking up a known assistant by name. Assistant records include their full system prompt, so fetching one record instead of a full page is significantly faster and smaller.
Omitting name returns all assistants. Passing an empty value (?name=) filters for assistants whose name is literally empty, which normally returns nothing.
The name filter is not yet exposed by the Python or JavaScript SDKs — call the endpoint directly if you need it.
curl --request GET \
--url https://app.backboard.io/api/assistants \
--header 'X-API-Key: <api-key>' \
--header 'authorization: <authorization>' \
--header 'x_session_token: <x_session_token>'