Dec 2025 - New! Caching input tokens unlocks immediate, automatic ~30% credit savings on supported models
cURL
curl --request POST \ --url http://localhost:3000/api/admin/assistants \ --header 'Content-Type: application/json' \ --header 'x-access-token: <api-key>' \ --data ' { "minimum": true, "institution": "665653e9f7e4f4f1b5c6ef1b" } '
{ "success": true, "data": [ { "_id": "<string>", "name": "<string>", "description": "<string>", "instructions": "<string>", "picture_url": "<string>", "status": "active", "liked_count": 123, "admin_only": true, "institution_shared": true, "remember_history": 123, "created": "2023-11-07T05:31:56Z", "argument_1": "<string>", "argument_5": "<string>", "editable_others": true } ] }
Fetches a list of AI assistants based on specified filters, with optional minimal data return
JWT token passed in x-access-token header
Whether to return minimal assistant data
Institution ID to filter assistants by
Successfully retrieved assistants list
Indicates if the request was successful
Array of assistant objects
Show child attributes
Unique identifier for the assistant
Name of the assistant
Detailed description of the assistant's capabilities
Detailed instructions for the assistant's behavior
URL path to the assistant's profile picture
Current status of the assistant
active
inactive
Number of likes the assistant has received
Whether the assistant is restricted to admin users only
Whether the assistant is shared across institutions
Number of conversation history items to remember
Creation timestamp
Optional argument parameter
Whether others can edit this assistant
Was this page helpful?