> ## Documentation Index > Fetch the complete documentation index at: https://docs.quiva.ai/llms.txt > Use this file to discover all available pages before exploring further. # List assistant templates > Retrieves a list of assistants ## OpenAPI ````yaml /api-reference/endpoint/assistants/openapi.json get /hub/agent openapi: 3.0.0 info: title: Quiva Assistants API x-gateway-name: API Gateway description: >- API for managing Quiva Assistants. Every endpoint requires either a Bearer JWT or an API key — the gateway resolves an API key into the user/account context these endpoints read. A restricted API key must explicitly allow the /hub/agent* paths it's used against, or requests are rejected before they reach this API. version: 0.1.1 contact: name: quiva.ai Support servers: - url: https://api.quiva.ai description: Production API server security: - bearerAuth: [] - apiKeyAuth: [] paths: /hub/agent: get: tags: - Assistants summary: List assistant templates description: Retrieves a list of assistants operationId: listAgentTemplates responses: '200': description: Assistants retrieved successfully content: application/json: schema: $ref: '#/components/schemas/ListAgentsResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: invalid request components: schemas: ListAgentsResponse: type: object properties: results: type: array items: type: object properties: subject: type: string description: Subject identifier for the assistant config: $ref: '#/components/schemas/AgentConfig' modified: $ref: '#/components/schemas/Modified' results_total: type: integer description: Total number of results ErrorResponse: type: object properties: error: type: string description: Error message AgentConfig: type: object required: - name - llm_provider - model - behaviour properties: id: type: string description: >- Optional human-facing label (alphanumeric, dashes, underscores). This is NOT the identifier and is not used for routing — the real identifier is the server-generated `subject`. The GET/PUT/DELETE path {id} is the uuid suffix of that subject, not this field. example: EMAIL_DRAFT name: type: string description: >- Human-readable assistant name. (e.g., 'Knowledge Researcher' or 'Claude Chat'). If a name already exists, there is no need to update it unless the purpose of the assistant has completely changed example: Helper Agent description: type: string description: >- Assistant description.Human-readable explanation of what the assistant does and its purpose. example: Analyzes data patterns agent_type: type: string enum: - '' - deep-research description: >- Built-in assistant type - empty for standard LLM assistant, 'deep-research' for research workflow assistant. behaviour: type: string description: >- System prompt defining assistant behaviour - this may be augmented by internal prompts. example: You are a data analysis expert llm_provider: type: string enum: - claude - anthropic description: >- LLM service provider. invoke accepts only "claude" or "anthropic"; any other value returns 400 "unsupported provider". model: type: string default: claude-haiku-4-5 description: >- Model identifier from available Claude models: claude-haiku-4-5 (default), claude-sonnet-4, claude-sonnet-4-5, claude-opus-4-5, claude-opus-4-1 example: claude-haiku-4-5 api_key: type: string description: >- Secret key for the LLM provider API key. If none is provided, a system key will be used. Only accounts with a TEAM subscription are allowed to use their own key. This property will be ignored for other subscription types and a system key will be used. example: CLAUDE_API_KEY output_schema: type: object additionalProperties: true description: >- Response structure with field descriptions - helps the LLM understand expected output format. has_tools: type: boolean default: false description: Whether this assistant has access to external tools/functions. knowledge: type: array items: type: string description: >- Knowledge sources using URI schemes: kv://bucket/document, obj://bucket/document, str://stream/start/end, sid://session_id, dta://data tools: type: array items: type: string description: >- Available tools using URI schemes: mcp://integration, fun://function, bit://tool tool_definitions: type: array items: $ref: '#/components/schemas/ToolDefinition' description: >- Full tool definitions for dynamic registration from MCP or other sources. timeout: type: integer default: 60000 description: Maximum request duration in milliseconds before timeout. context_limit: type: integer default: 200000 description: Maximum conversation context in tokens. message_history_limit: type: integer default: 2000 description: Number of historical messages to retain in conversation. smart_context: type: boolean default: false description: Enable intelligent context curation for token optimization. ai_smart_context: type: boolean default: false description: Enable AI-powered context summarization using Claude. ai_summary_threshold: type: number format: float minimum: 0.5 maximum: 0.95 default: 0.7 description: >- Trigger AI summarization when context reaches this capacity ratio (0.5-0.95). ai_summary_model: type: string default: claude-haiku-4-5 description: Model to use for AI-powered summarization. preserve_most_recent: type: integer minimum: 2 maximum: 20 default: 5 description: Number of recent messages to always keep unsummarized. ai_prompt: type: boolean default: false description: >- Enable AI-powered prompt and behaviour enhancement using Claude Haiku. instructions: type: array items: type: string description: >- Optional guidance instructions for response validation and refinement. context_variables: type: object additionalProperties: true description: >- Key-value pairs injected into assistant system prompt. WARNING: Values are not sanitized and can enable prompt injection. mcp_base_urls: type: object additionalProperties: type: string description: Override base URLs for MCP servers indexed by server ID. auth: type: object additionalProperties: $ref: '#/components/schemas/AgentAuth' description: Authentication configurations for various services. llm_config: $ref: '#/components/schemas/LLMConfigOverride' description: Optional LLM configuration overrides for this assistant. agent_settings: $ref: '#/components/schemas/AgentSettings' description: >- Advanced assistant configuration for memory, context, verification, and debugging. allowed_agents: type: array items: $ref: '#/components/schemas/AllowedAgent' description: >- List of assistants this assistant may invoke - empty means no invocation permitted invocation_depth: type: integer minimum: 0 maximum: 1 default: 0 description: Current invocation depth - 0 for main assistant and 1 for sub-agent agent_template_subject: type: string description: Assistant template subject identifier appearance: $ref: '#/components/schemas/AgentAppearance' description: Visual appearance configuration for the assistant api_key_source: type: string enum: - personal - system description: Source of the API key - 'personal' or 'system' shared: type: string enum: - private - team - public default: private description: >- Sharing state of the assistant - 'private' (only owner), 'team' (team members), or 'public' (anyone). Modified: type: integer description: Timestamp of last modification ToolDefinition: type: object required: - uri - name - description - schema properties: uri: type: string description: Unique tool identifier URI (e.g., 'mcp://local/file_read'). example: mcp://local/file_read name: type: string description: Tool name for invocation. example: file_read description: type: string description: Human-readable explanation of what the tool does. example: Reads content from a file schema: type: object additionalProperties: true description: JSON Schema defining the tool's input parameters. AgentAuth: type: object properties: bearer: type: string description: Bearer token for authentication. api_key: type: string description: API key for authentication. username: type: string description: Username for basic authentication. password: type: string description: Password for basic authentication. oauth: type: string description: OAuth subject/connection identifier. scheme_name: type: string description: Security scheme name from OpenAPI specification. private_auth: type: boolean description: >- If true, the MCP auth has to be set per user, otherwise the auth is shared. LLMConfigOverride: type: object properties: temperature: type: number format: float minimum: 0 maximum: 2 description: >- Sampling temperature override - higher values make output more random. max_tokens: type: integer minimum: 1 description: Maximum tokens override for model output. max_turns: type: integer minimum: 1 description: Maximum turn count for LLM conversations. AgentSettings: type: object description: >- Advanced assistant configuration options for memory, context, verification, and debugging. properties: memory: $ref: '#/components/schemas/MemorySettings' description: >- Smart memory system configuration for learning from historical resolutions. smart_context_advanced: $ref: '#/components/schemas/SmartContextAdvancedSettings' description: Advanced smart context configuration for token management. verification: $ref: '#/components/schemas/VerificationSettings' description: Consensus-based verification configuration. human_in_the_loop: $ref: '#/components/schemas/HumanInTheLoopSettings' description: Human-in-the-loop configuration for escalation. branching: $ref: '#/components/schemas/BranchingSettings' description: Conversation branching and checkpointing. observability: $ref: '#/components/schemas/ObservabilitySettings' description: Observability, instrumentation, and debugging. knowledge_advanced: $ref: '#/components/schemas/KnowledgeAdvancedSettings' description: Advanced knowledge system configuration. AllowedAgent: type: object required: - subject properties: subject: type: string description: Unique identifier for the invocable assistant description: type: string description: Human-readable description of the assistant's purpose description: >- Represents an assistant that can be invoked by another assistant. This enables richer metadata about permitted assistants for dynamic tool documentation. AgentAppearance: type: object properties: avatar: type: boolean description: Whether to display an avatar for the assistant avatar_bg_size: type: string description: Background size setting for the avatar color: type: string description: Color scheme for the assistant's visual representation fit_avatar: type: boolean description: Whether to fit the avatar to its container description: Visual appearance configuration for the assistant MemorySettings: type: object properties: enabled: type: boolean default: false description: Enable smart memory system for learning from historical resolutions. marker_types: type: array items: type: string enum: - error - question - escalation - tool_call - success description: Types of markers to capture in memory. query_enabled: type: boolean default: true description: Enable querying memory bank for similar historical problems. max_memory_entries: type: integer minimum: 1 maximum: 1000 default: 100 description: Maximum number of memory entries to retain. similarity_threshold: type: number format: float minimum: 0 maximum: 1 default: 0.7 description: Minimum similarity score for memory retrieval (0.0-1.0). SmartContextAdvancedSettings: type: object properties: token_limit_auto_adjust: type: boolean default: true description: Enable dynamic token allocation based on query complexity. complexity_detection: type: boolean default: true description: Enable automatic query complexity analysis. complexity_detection_method: type: string enum: - keyword - llm - rubric default: keyword description: Method for complexity detection. message_summarization: type: boolean default: true description: Enable summarizing multiple large messages. ephemeral_streams: type: boolean default: false description: Enable ephemeral streams for context-relevant message queuing. min_messages_for_summary: type: integer minimum: 2 maximum: 20 default: 3 description: Minimum messages before summarization is triggered. VerificationSettings: type: object properties: enabled: type: boolean default: false description: Enable consensus-based verification. consensus_runs: type: integer minimum: 2 maximum: 10 default: 3 description: Number of runs for consensus (typically 3 or 5). consensus_threshold: type: number format: float minimum: 0.5 maximum: 1 default: 0.66 description: Agreement threshold for consensus validation. verifier_agent: type: string description: Specific assistant name to use for verification runs. HumanInTheLoopSettings: type: object properties: enabled: type: boolean default: false description: Enable human-in-the-loop escalation. auto_escalate_on_error: type: boolean default: false description: Automatically escalate to human when errors occur. checkpoints: type: array items: type: string enum: - pre_tool_call - post_tool_call - pre_response - post_validation description: Specific checkpoints requiring human review. escalation_threshold: $ref: '#/components/schemas/EscalationThreshold' description: Conditions that trigger human escalation. BranchingSettings: type: object properties: enabled: type: boolean default: false description: Enable conversation branching for testing approaches. auto_checkpoint: type: boolean default: true description: Automatically create checkpoints at critical points. checkpoint_interval: type: integer minimum: 1 default: 5 description: Create checkpoint every N turns. max_branches: type: integer minimum: 1 maximum: 10 default: 3 description: Maximum number of active conversation branches. ObservabilitySettings: type: object properties: debug_mode: type: boolean default: false description: Enable detailed debug logging and instrumentation. capture_thinking: type: boolean default: true description: Capture and log LLM reasoning processes. capture_tool_calls: type: boolean default: true description: Capture detailed tool call information. metrics_enabled: type: boolean default: true description: Enable performance metrics collection. tracing_enabled: type: boolean default: true description: Enable distributed tracing with OpenTelemetry. log_level: type: string enum: - debug - info - warn - error default: info description: Logging level. KnowledgeAdvancedSettings: type: object properties: semantic_indexing: type: boolean default: true description: Enable semantic indexing with llms.txt-style summaries. image_detail_level: type: string enum: - low - high - auto default: low description: Initial image detail level. adaptive_image_resolution: type: boolean default: true description: Allow LLM to request higher resolution regions. bucket_semantic_search: type: boolean default: true description: Enable semantic search across knowledge buckets. section_based_retrieval: type: boolean default: true description: Enable section-based retrieval from documents. max_retrieval_tokens: type: integer minimum: 100 maximum: 100000 default: 10000 description: Maximum tokens to retrieve from knowledge sources. EscalationThreshold: type: object properties: error_count: type: integer minimum: 1 default: 3 description: Escalate after N consecutive errors. confidence_score: type: number format: float minimum: 0 maximum: 1 default: 0.5 description: Escalate when confidence drops below this threshold. turn_count: type: integer minimum: 1 default: 10 description: Escalate after N turns without resolution. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT Authorization header using the Bearer scheme. apiKeyAuth: type: apiKey in: header name: X-Api-Key description: API key authentication via X-Api-Key header. ````