> ## Documentation Index > Fetch the complete documentation index at: https://docs.gennia.ai/llms.txt > Use this file to discover all available pages before exploring further. # List AI models > Returns the union of (a) global catalog models and (b) custom models owned by the workspace bound to the API key. Optional filters apply in memory. ## OpenAPI ````yaml /api-reference/openapi.json get /public/api/v1/ai-models openapi: 3.1.0 info: contact: email: support@gennia.ai name: Gennia Support url: https://gennia.ai description: >- Workspace-scoped API authenticated via workspace API key (header `X-Api-Key: gsk_...` or `Authorization: Bearer gsk_...`). title: Gennia Public API version: v1 servers: - description: Production url: https://api.gennia.ai security: - workspaceApiKey: [] tags: - description: Slash commands available inside the agent chat. name: Agent Commands - description: Link skills to an agent. name: Agent Skills - description: Read/rename/delete workspace knowledge sources. name: Knowledge Sources - description: Link knowledge sources to an agent. name: Agent Knowledge Sources - description: Workspace CRUD for HTTP/DB/Custom tools. name: HTTP Tools - description: Read/write the agent's model selection + capabilities. name: Agent Model - description: Discover trigger types available for Native MCP toolkits. name: Native MCP Triggers - description: Discover and toggle capability features. name: Agent Features - description: Hub access settings. name: Hub Access - description: Read conversation history and delete conversations. name: Conversations - description: Send messages to a published agent. name: Messages - description: Workspace CRUD for External MCP servers. name: External MCPs - description: Hub billing — plans, coupons, credit packages. name: Billing - description: External links shown in the hub menu. name: Hub External Links - description: Link Native MCP (Composio) instances to an agent. name: Agent Native MCPs - description: Manage AI agents in the workspace bound to the API key. name: Agents - description: Read published version snapshots and restore. name: Agent Versions - description: Read/rename/delete workspace skills. name: Skills - description: Manage hub end-customers (client workspaces). name: Clients - description: Hub domain (subdomain) management. name: Hub Domain - description: Read/write the agent's prompt context. name: Agent Prompt - description: Scheduled / trigger-based runs of an agent. name: Agent Automations - description: Link HTTP/DB/Custom tools to an agent. name: Agent HTTP Tools - description: Hub identity, branding, logos and overall configuration. name: Hub - description: Discover AI models available to this workspace. name: AI Models - description: Discover channel types and their config schemas. name: Channel Types - description: Connect agents to messaging surfaces. name: Agent Channels - description: Link workspace-registered External MCP servers to an agent. name: Agent External MCPs - description: Workspace-scoped public API (API key authentication) name: Public API - description: Dynamic-prompt variable definitions. name: Agent Variables - description: Link sub-agents as delegation targets. name: Agent Sub-agents paths: /public/api/v1/ai-models: get: tags: - AI Models summary: List AI models description: >- Returns the union of (a) global catalog models and (b) custom models owned by the workspace bound to the API key. Optional filters apply in memory. operationId: listAIModels parameters: - description: Only models with isActive=true (default true). in: query name: activeOnly required: false schema: default: true type: boolean - description: Filter by provider key (e.g. openai, anthropic). in: query name: provider required: false schema: type: string - description: Filter to models that ingest images. in: query name: supportsImage required: false schema: type: boolean - description: Filter to models that ingest documents. in: query name: supportsDocument required: false schema: type: boolean - description: '`global` or `workspace`. Omit to return both.' in: query name: scope required: false schema: enum: - global - workspace type: string responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/PublicAIModelDTO' type: array description: OK '401': content: application/json: schema: items: $ref: '#/components/schemas/PublicAIModelDTO' type: array description: Missing or invalid API key security: - workspaceApiKey: [] components: schemas: PublicAIModelDTO: description: AI model available to this workspace (global catalog + custom). properties: active: type: boolean contextWindow: description: Maximum context window in tokens. format: int32 type: integer createdAt: format: date-time type: string description: description: Free-form description. type: string displayProvider: description: Display label for the model creator/group. type: string iconUrl: description: Absolute URL to the model's icon. type: string inputCostPer1MTokens: description: Input price per 1M tokens, USD. type: number maxTemperature: description: Maximum allowed temperature (when supported). format: float type: number minTemperature: description: Minimum allowed temperature (when supported). format: float type: number modelId: description: Provider-specific model identifier. example: gpt-4.1 type: string name: description: Display name. example: GPT-4.1 type: string outputCostPer1MTokens: description: Output price per 1M tokens, USD. type: number provider: description: Inference provider key. example: openai type: string publicId: description: Stable external UUID for the model. format: uuid type: string scope: description: '`global` for catalog models, `workspace` for custom ones.' enum: - global - workspace type: string supportsDocument: description: Whether the model can ingest documents (PDF/DOCX/etc). type: boolean supportsImage: description: Whether the model can ingest images. type: boolean supportsTemperature: description: Whether the model accepts a temperature parameter. type: boolean supportsThinking: description: Whether the model supports thinking/reasoning mode. type: boolean updatedAt: format: date-time type: string type: object securitySchemes: workspaceApiKey: in: header name: X-Api-Key type: apiKey ````