Skip to content
/
List assistants
Last updated

List assistants

Get all assistants the user has access to across organizations with pagination, search, and filtering capabilities.

GEThttps://api.aitronos.com/v1/assistants

Query Parameters

organization_id string required

The unique identifier of the organization to list assistants from. Find your organization ID in Freddy Hub → Settings → Organization.

limit integer optional · Defaults to 50

Maximum number of assistants to return (1-100).

offset integer optional · Defaults to 0

Number of assistants to skip for pagination.

search string optional

Search assistants by name or description.

access_mode string optional

Filter by access mode. One of private, organization, public.

include_inactive boolean optional · Defaults to false

Whether to include inactive assistants in results.

sort_by string optional · Defaults to name

Sort field. One of name, created_at, updated_at.

sort_order string optional · Defaults to asc

Sort direction. One of asc, desc.

fields string optional · Defaults to summary

Control the amount of data returned per assistant. Values:

  • summary - Minimal fields for list views (id, name, description, icon_id, icon_url, is_default, created_at, updated_at, access_mode, api_enabled, is_active, temperature, user_access_level)
  • standard - Summary + model configuration (default_model_key, allowed_model_providers, context_strategy)
  • full - Complete Assistant object with all fields including detailed tool configurations, permissions, and metadata

Use summary for list views to minimize payload size. Use full only when displaying individual assistant details.

vector_store_id string optional

Filter by vector store ID. Only return assistants using this vector store.

Returns

assistants array

Array of Assistant objects. The fields included depend on the fields query parameter.

total integer

Total number of assistants matching the query across all pages.

organization_id string or null

The organization ID for the current context. Can be null for cross-organization queries.

pagination object

Pagination information for navigating through results.

  • total - Total number of items matching the query
  • limit - Maximum number of items returned
  • offset - Number of items skipped
  • has_more - Whether more results exist

filters_applied object

Summary of filters applied to the query.

  • search - Search term used (if any)
  • access_mode - Access mode filter (if any)
  • include_inactive - Whether inactive assistants are included
  • sort_by - Field used for sorting
  • sort_order - Sort direction (asc or desc)

user_context object

Information about the current user's context.

  • user_id - Current user's ID
  • organization_count - Number of organizations the user has access to
Bash
curl "https://api.aitronos.com/v1/assistants?organization_id=org_abc123" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

{
  "assistants": [
    {
      "id": "asst_abc123",
      "name": "Customer Support Bot",
      "description": "Handles customer inquiries",
      "organization_id": "org_abc123",
      "model": "gpt-4o",
      "is_active": true,
      "access_mode": "public",
      "created_at": "2025-11-11T10:30:00Z",
      "updated_at": "2025-11-11T10:30:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}
Previous page
Next page