> ## Documentation Index > Fetch the complete documentation index at: https://docs.threetone.in/llms.txt > Use this file to discover all available pages before exploring further. # List Available Llms > Returns a list of available LLM models that can be used with agents, including their capabilities and any deprecation status. The response is filtered based on the data residency of the deployment and any compliance requirements (e.g. HIPAA) of the workspace subscription. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/convai/llm/list openapi: 3.1.0 info: title: Threetone API Documentation description: >- This is the documentation for the Threetone API. You can use this API to use our service programmatically with API keys sent in the x-api-key header. You can create and manage API keys in the dashboard at https://threetone.in/app/developers/api-keys. version: '1.0' servers: - url: https://api.threetone.in description: Production security: [] paths: /v1/convai/llm/list: get: tags: - Agents Platform summary: List Available Llms description: >- Returns a list of available LLM models that can be used with agents, including their capabilities and any deprecation status. The response is filtered based on the data residency of the deployment and any compliance requirements (e.g. HIPAA) of the workspace subscription. operationId: list_available_llms parameters: - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. title: X-Api-Key description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LLMListResponseModel' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: LLMListResponseModel: properties: llms: items: $ref: '#/components/schemas/LLMInfoModel' type: array title: Llms description: List of all available LLM models that can be used with agents. default_deprecation_config: $ref: '#/components/schemas/LLMDeprecationConfigModel' description: >- The default deprecation timing configuration used for models without a custom override. type: object required: - llms - default_deprecation_config title: LLMListResponseModel example: default_deprecation_config: fallback_complete_days: 7 fallback_complete_percentage: 100 fallback_start_days: 14 fallback_start_percentage: 25 warning_start_days: 30 llms: - is_checkpoint: false llm: gemini-2.5-flash max_context_limit: 1048576 max_tokens_limit: 8192 supports_document_input: true supports_image_input: true supports_parallel_tool_calls: true HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError LLMInfoModel: properties: llm: $ref: '#/components/schemas/LLM' description: The model identifier. is_checkpoint: type: boolean title: Is Checkpoint description: >- Whether this is a pinned checkpoint version of a model rather than a top-level alias. max_tokens_limit: type: integer title: Max Tokens Limit description: Maximum number of output tokens the model can generate. max_context_limit: type: integer title: Max Context Limit description: Maximum number of input context tokens the model supports. supports_image_input: type: boolean title: Supports Image Input description: Whether the model supports image file inputs during conversations. supports_document_input: type: boolean title: Supports Document Input description: >- Whether the model supports document (PDF) file inputs during conversations. supports_parallel_tool_calls: type: boolean title: Supports Parallel Tool Calls description: Whether the model supports calling multiple tools in parallel. available_reasoning_efforts: anyOf: - items: $ref: '#/components/schemas/LLMReasoningEffort' type: array - type: 'null' title: Available Reasoning Efforts description: >- Available reasoning effort levels for this model. Null if the model does not support configurable reasoning. deprecation_info: anyOf: - $ref: '#/components/schemas/LLMDeprecationInfoModel' - type: 'null' description: >- Deprecation information if this model is deprecated or scheduled for deprecation. Null if the model is not affected. regional_processing_surcharge: anyOf: - $ref: '#/components/schemas/RegionalProcessingSurchargeInfo' - type: 'null' description: >- Regional processing surcharge details if this model has additional costs in the current deployment region. Null if no surcharge applies. type: object required: - llm - is_checkpoint - max_tokens_limit - max_context_limit - supports_image_input - supports_document_input - supports_parallel_tool_calls title: LLMInfoModel example: is_checkpoint: false llm: gemini-2.5-flash max_context_limit: 1048576 max_tokens_limit: 8192 supports_document_input: true supports_image_input: true supports_parallel_tool_calls: true LLMDeprecationConfigModel: properties: warning_start_days: type: integer title: Warning Start Days description: >- Number of days before the provider deprecation date when warnings start being shown. fallback_start_days: type: integer title: Fallback Start Days description: >- Number of days before the provider deprecation date when traffic starts being routed to the replacement model. fallback_complete_days: type: integer title: Fallback Complete Days description: >- Number of days before the provider deprecation date when all traffic is routed to the replacement model. fallback_start_percentage: type: integer title: Fallback Start Percentage description: >- Percentage of traffic routed to the replacement model when fallback begins. fallback_complete_percentage: type: integer title: Fallback Complete Percentage description: >- Percentage of traffic routed to the replacement model when fallback is complete. type: object required: - warning_start_days - fallback_start_days - fallback_complete_days - fallback_start_percentage - fallback_complete_percentage title: LLMDeprecationConfigModel example: fallback_complete_days: 7 fallback_complete_percentage: 100 fallback_start_days: 14 fallback_start_percentage: 25 warning_start_days: 30 ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError LLM: type: string enum: - gpt-4o-mini - gpt-4o - gpt-4 - gpt-4-turbo - gpt-4.1 - gpt-4.1-mini - gpt-4.1-nano - gpt-5 - gpt-5.1 - gpt-5.2 - gpt-5.2-chat-latest - gpt-5.4 - gpt-5.5 - gpt-5.6-sol - gpt-5.6-terra - gpt-5.6-luna - gpt-5-mini - gpt-5-nano - gpt-3.5-turbo - gemini-1.5-pro - gemini-1.5-flash - gemini-2.0-flash - gemini-2.0-flash-lite - gemini-2.5-flash-lite - gemini-2.5-flash - gemini-3-pro-preview - gemini-3-flash-preview - gemini-3.1-pro-preview - gemini-3.1-flash-lite-preview - gemini-3.6-flash - gemini-3.7-flash - claude-sonnet-4-5 - claude-opus-4-7 - claude-sonnet-4-6 - claude-sonnet-4 - claude-haiku-4-5 - claude-3-7-sonnet - claude-3-5-sonnet - claude-3-5-sonnet-v1 - claude-3-haiku - grok-beta - custom-llm - qwen3-4b - qwen3-30b-a3b - qwen36-35b-a3b - gpt-oss-20b - gpt-oss-120b - glm-45-air-fp8 - gemini-2.5-flash-preview-09-2025 - gemini-2.5-flash-lite-preview-09-2025 - gemini-2.5-flash-preview-05-20 - gemini-2.5-flash-preview-04-17 - gemini-2.5-flash-lite-preview-06-17 - gemini-2.0-flash-lite-001 - gemini-2.0-flash-001 - gemini-1.5-flash-002 - gemini-1.5-flash-001 - gemini-1.5-pro-002 - gemini-1.5-pro-001 - claude-sonnet-4@20250514 - claude-sonnet-4-5@20250929 - claude-haiku-4-5@20251001 - claude-3-7-sonnet@20250219 - claude-3-5-sonnet@20240620 - claude-3-5-sonnet-v2@20241022 - claude-3-haiku@20240307 - gpt-5-2025-08-07 - gpt-5.1-2025-11-13 - gpt-5.2-2025-12-11 - gpt-5.4-2026-03-05 - gpt-5.5-2026-04-23 - gpt-5-mini-2025-08-07 - gpt-5-nano-2025-08-07 - gpt-4.1-2025-04-14 - gpt-4.1-mini-2025-04-14 - gpt-4.1-nano-2025-04-14 - gpt-4o-mini-2024-07-18 - gpt-4o-2024-11-20 - gpt-4o-2024-08-06 - gpt-4o-2024-05-13 - gpt-4-0613 - gpt-4-0314 - gpt-4-turbo-2024-04-09 - gpt-3.5-turbo-0125 - gpt-3.5-turbo-1106 - watt-tool-8b - watt-tool-70b title: LLM LLMReasoningEffort: type: string enum: - none - minimal - low - medium - high - xhigh - max title: LLMReasoningEffort LLMDeprecationInfoModel: properties: llm: $ref: '#/components/schemas/LLM' description: The identifier of the deprecated LLM model. is_deprecated: type: boolean title: Is Deprecated description: >- Whether this model is currently deprecated. True if the model is immediately deprecated or within the warning period. is_in_warning_period: type: boolean title: Is In Warning Period description: >- Whether this model is currently in the warning period before deprecation. default: false is_in_fallback_period: type: boolean title: Is In Fallback Period description: >- Whether traffic is currently being progressively routed to the replacement model. default: false fallback_percentage: type: integer title: Fallback Percentage description: >- Current percentage of traffic being routed to the replacement model (0-100). default: 0 provider_deprecation_date: anyOf: - type: string format: date-time - type: 'null' title: Provider Deprecation Date description: >- The date when the model provider will deprecate this model. Null for immediately deprecated models. replacement_model: anyOf: - $ref: '#/components/schemas/LLM' - type: 'null' description: >- The model that replaces this deprecated model. Traffic will be automatically routed to this model. deprecation_config: anyOf: - $ref: '#/components/schemas/LLMDeprecationConfigModel' - type: 'null' description: >- Custom deprecation timing configuration for this model. Null if using the default configuration. type: object required: - llm - is_deprecated title: LLMDeprecationInfoModel example: fallback_percentage: 0 is_deprecated: true is_in_fallback_period: false is_in_warning_period: true llm: gpt-4o-mini provider_deprecation_date: '2025-06-01T00:00:00Z' replacement_model: gpt-4o RegionalProcessingSurchargeInfo: properties: multiplier: type: number title: Multiplier description: >- The surcharge multiplier applied to this model's pricing (e.g. 1.1 for a 10% surcharge). type: object required: - multiplier title: RegionalProcessingSurchargeInfo example: multiplier: 1.1 ````