> ## Documentation Index > Fetch the complete documentation index at: https://docs.verbex.ai/llms.txt > Use this file to discover all available pages before exploring further. # List AI Agents > List AI agents with pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /v2/ai-agents/ openapi: 3.1.0 info: title: Verbex Platform API description: API for managing AI agents, calls, phone numbers, and more. version: 1.0.0 servers: [] security: [] paths: /v2/ai-agents/: get: tags: - AI Agents v2 summary: List AI Agents description: List AI agents with pagination. operationId: list_ai_agents_v2_ai_agents__get parameters: - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Page Size - name: page_token in: query required: false schema: type: string title: Page Token responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListAIAgentResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ListAIAgentResponse: properties: data: items: $ref: '#/components/schemas/AIAgentResponse' type: array title: Data description: List of AI agents matching the query criteria next_page_token: anyOf: - type: string - type: 'null' title: Next Page Token description: >- Token to retrieve the next page of results. Null if there are no more results type: object title: ListAIAgentResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError AIAgentResponse: properties: ai_agent_id: type: string title: Ai Agent Id description: Unique identifier for the AI agent agent_name: type: string title: Agent Name description: Name of the AI agent language_code: type: string title: Language Code description: Language code for the AI agent in BCP-47 format default: en-US llm: oneOf: - $ref: '#/components/schemas/SimplePiaLLMResponse' - $ref: '#/components/schemas/AgenticPiaLLMResponse' - $ref: '#/components/schemas/CustomPiaLLMResponse' title: Llm description: Language model configuration for the AI agent discriminator: propertyName: llm_type mapping: agentic: $ref: '#/components/schemas/AgenticPiaLLMResponse' custom: $ref: '#/components/schemas/CustomPiaLLMResponse' simple: $ref: '#/components/schemas/SimplePiaLLMResponse' stt: anyOf: - $ref: '#/components/schemas/DeepgramSTTResponse' - $ref: '#/components/schemas/GoogleSTTResponse' - $ref: '#/components/schemas/PiaSTTResponse' title: Stt description: Speech-to-text configuration for the AI agent tts: oneOf: - $ref: '#/components/schemas/ElevenLabsTTSResponse' - $ref: '#/components/schemas/GoogleTTSResponse' - $ref: '#/components/schemas/AzureTTSResponse' - $ref: '#/components/schemas/CartesiaTTSResponse' - $ref: '#/components/schemas/PiaTTSResponse' title: Tts description: Text-to-speech configuration for the AI agent discriminator: propertyName: provider mapping: azure: $ref: '#/components/schemas/AzureTTSResponse' cartesia: $ref: '#/components/schemas/CartesiaTTSResponse' elevenlabs: $ref: '#/components/schemas/ElevenLabsTTSResponse' google: $ref: '#/components/schemas/GoogleTTSResponse' pia: $ref: '#/components/schemas/PiaTTSResponse' knowledge_base_id: anyOf: - type: string - type: 'null' title: Knowledge Base Id description: ID of the associated knowledge base, if any enable_user_interruptions: type: boolean title: Enable User Interruptions description: Whether to allow users to interrupt the AI agent while speaking default: true minimum_speech_duration_for_interruptions: type: number maximum: 15 minimum: 0 title: Minimum Speech Duration For Interruptions description: >- Minimum duration of speech in seconds before interruptions are allowed default: 0.5 minimum_words_before_interruption: type: integer maximum: 5 minimum: 0 title: Minimum Words Before Interruption description: >- Minimum number of words that must be spoken before interruption is allowed default: 0 wait_time_before_detecting_end_of_speech: type: number maximum: 15 minimum: 0 title: Wait Time Before Detecting End Of Speech description: Time in seconds to wait before considering speech has ended default: 0.5 ambient_sound: type: string enum: - office - cafe - restaurant - park - street - home - library - airport - train_station - beach - none title: Ambient Sound description: Type of ambient background sound to use during calls default: none ambient_sound_volume: type: number maximum: 2 minimum: 0 title: Ambient Sound Volume description: Volume level for ambient sound, from 0 (muted) to 2 (loud) default: 1 webhook_url: anyOf: - type: string - type: 'null' title: Webhook Url description: URL to send webhook notifications about call events end_call_after_silence_seconds: type: number maximum: 30 minimum: 10 title: End Call After Silence Seconds description: Number of seconds of silence before automatically ending the call default: 10 max_call_duration_seconds: type: number maximum: 3600 minimum: 30 title: Max Call Duration Seconds description: Maximum duration of a call in seconds default: 1800 welcome_message: anyOf: - type: string - type: 'null' title: Welcome Message description: Custom welcome message to play at the start of calls voicemail_detection_timeout_seconds: type: number minimum: 0 title: Voicemail Detection Timeout Seconds description: Time in seconds to wait for voicemail detection default: 90 dynamic_data_config: anyOf: - items: $ref: '#/components/schemas/DynamicDataConfigItemResponse' type: array - type: 'null' title: Dynamic Data Config description: Configuration for dynamic data sources that can be used during calls post_call_analysis: anyOf: - items: anyOf: - $ref: '#/components/schemas/StringPostCallAnalysisItemResponse' - $ref: '#/components/schemas/EnumPostCallAnalysisItemResponse' - $ref: '#/components/schemas/BooleanPostCallAnalysisItemResponse' - $ref: '#/components/schemas/NumberPostCallAnalysisItemResponse' type: array - type: 'null' title: Post Call Analysis description: Configuration for analysis items to be processed after calls created_by_user_id: type: string title: Created By User Id description: ID of the user who created this AI agent type: object required: - ai_agent_id - agent_name - llm - stt - tts - created_by_user_id title: AIAgentResponse 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 SimplePiaLLMResponse: properties: llm_id: type: string title: Llm Id description: Unique identifier for the Language Learning Model (LLM) llm_type: type: string const: simple title: Llm Type description: >- Indicates this is a simple LLM type that uses standard model providers model_provider: type: string enum: - openai - anthropic - verbex - openai_compatible title: Model Provider description: >- The provider of the language model - OpenAI, Anthropic, verbex, or OpenAI Compatible model_name: type: string title: Model Name description: >- Name of the specific model from the provider (e.g. 'gpt-4', 'claude-2') model_temperature: type: number maximum: 1 minimum: 0 title: Model Temperature description: >- Controls randomness in model outputs - 0 is focused/deterministic, 1 is more creative/random default: 0 llm_name: anyOf: - type: string - type: 'null' title: Llm Name description: Name of the LLM to use llm_description: anyOf: - type: string - type: 'null' title: Llm Description description: Description of the LLM to use base_url: anyOf: - type: string - type: 'null' title: Base Url description: Base URL for the LLM API endpoint api_key: anyOf: - type: string - type: 'null' title: Api Key description: API key for authentication with the LLM service max_tokens: anyOf: - type: integer - type: 'null' title: Max Tokens description: Maximum number of tokens allowed in the response required_dynamic_data: anyOf: - items: type: string type: array - type: 'null' title: Required Dynamic Data description: >- List of dynamic data fields that must be provided to this LLM during operation system_prompt: type: string title: System Prompt description: >- The base prompt that defines the LLM's behavior, role and operating parameters tools: anyOf: - items: type: object type: array - type: 'null' title: Tools description: >- List of tools/functions available to the LLM for external interactions and API calls type: object required: - llm_id - llm_type - model_provider - model_name - system_prompt title: SimplePiaLLMResponse AgenticPiaLLMResponse: properties: llm_id: type: string title: Llm Id description: Unique identifier for the Language Learning Model (LLM) llm_type: type: string const: agentic title: Llm Type description: >- Indicates this is an agentic LLM that uses graph-based decision making graph_data: type: object title: Graph Data description: >- Graph structure defining the agent's behavior, decision-making flow and state transitions type: object required: - llm_id - llm_type - graph_data title: AgenticPiaLLMResponse CustomPiaLLMResponse: properties: llm_id: type: string title: Llm Id description: Unique identifier for the Language Learning Model (LLM) llm_type: type: string const: custom title: Llm Type description: Indicates this is a custom LLM implementation custom_llm_url: type: string title: Custom Llm Url description: URL endpoint where the custom LLM implementation is hosted model_name: anyOf: - type: string - type: 'null' title: Model Name description: >- Name of the specific model to use from the provider. It will be passed to the custom LLM implementation api_key: anyOf: - type: string - type: 'null' title: Api Key description: >- API key for the custom LLM implementation. It can be used to verify requests are coming from Verbex Platform type: object required: - llm_id - llm_type - custom_llm_url title: CustomPiaLLMResponse DeepgramSTTResponse: properties: provider: type: string const: deepgram title: Provider description: Indicates Deepgram is being used as the STT provider model: type: string enum: - nova-2-general - nova-2-phonecall - nova-meeting - nova-2-meeting - nova-2-finance - nova-2-conversationalai - nova-2-voicemail - nova-2-video - nova-2-medical - nova-2-drivethru - nova-2-automotive - enhanced-general - enhanced-meeting - enhanced-phonecall - enhanced-finance - base - meeting - phonecall - finance - conversationalai - voicemail - video - whisper-tiny - whisper-base - whisper-small - whisper-medium - whisper-large title: Model description: >- Specific Deepgram model being used for speech recognition, each optimized for different use cases type: object required: - provider - model title: DeepgramSTTResponse GoogleSTTResponse: properties: provider: type: string const: google title: Provider description: Indicates Google Speech-to-Text is being used as the STT provider model: type: string enum: - default - phone_call - long title: Model description: >- Specific Google STT model - 'default' for general use, 'phone_call' for telephony, 'long' for extended audio type: object required: - provider - model title: GoogleSTTResponse PiaSTTResponse: properties: provider: type: string const: pia title: Provider description: Indicates Pia's proprietary STT service is being used model: type: string const: pia_bangla_v1 title: Model description: Specific Pia STT model - currently supporting Bangla language type: object required: - provider - model title: PiaSTTResponse ElevenLabsTTSResponse: properties: provider: type: string const: elevenlabs title: Provider description: Indicates ElevenLabs is being used as the TTS provider voice_id: type: string title: Voice Id description: Unique identifier for the selected ElevenLabs voice voice_name: anyOf: - type: string - type: 'null' title: Voice Name description: Human-readable name of the selected voice model_name: anyOf: - type: string enum: - eleven_turbo_v2_5 - eleven_turbo_v2 - eleven_multilingual_v2 - eleven_monolingual_v1 - type: 'null' title: Model Name description: Specific ElevenLabs model version being used for voice synthesis voice_temperature: anyOf: - type: number maximum: 1 minimum: 0 - type: 'null' title: Voice Temperature description: >- Controls variation in voice output - higher values increase variability default: 0.2 type: object required: - provider - voice_id - voice_name title: ElevenLabsTTSResponse GoogleTTSResponse: properties: provider: type: string const: google title: Provider description: Indicates Google Cloud TTS is being used as the provider voice_id: type: string title: Voice Id description: Unique identifier for the selected Google TTS voice type: object required: - provider - voice_id title: GoogleTTSResponse AzureTTSResponse: properties: provider: type: string const: azure title: Provider description: Indicates Azure Cognitive Services is being used as the TTS provider voice_id: type: string title: Voice Id description: Unique identifier for the selected Azure voice type: object required: - provider - voice_id title: AzureTTSResponse CartesiaTTSResponse: properties: provider: type: string const: cartesia title: Provider description: Indicates Cartesia's TTS service is being used voice_id: type: string title: Voice Id description: Unique identifier for the selected Cartesia voice voice_name: anyOf: - type: string - type: 'null' title: Voice Name description: Human-readable name of the selected voice model_name: anyOf: - type: string enum: - sonic-multilingual - sonic-english - type: 'null' title: Model Name description: >- Specific Cartesia model being used - either multilingual or English-optimized voice_temperature: anyOf: - type: number maximum: 1 minimum: 0 - type: 'null' title: Voice Temperature description: >- Controls variation in voice output - higher values increase variability default: 0.2 type: object required: - provider - voice_id title: CartesiaTTSResponse PiaTTSResponse: properties: provider: type: string const: pia title: Provider description: Indicates Pia's proprietary TTS service is being used voice_id: type: string title: Voice Id description: Unique identifier for the selected Pia voice voice_name: anyOf: - type: string - type: 'null' title: Voice Name description: Human-readable name of the selected voice model_name: anyOf: - type: string - type: 'null' title: Model Name description: Name of the specific Pia TTS model being used type: object required: - provider - voice_id title: PiaTTSResponse DynamicDataConfigItemResponse: properties: url: type: string title: Url description: Endpoint URL for retrieving dynamic data method: type: string title: Method description: HTTP method to use when calling the endpoint (GET, POST, etc) timeout: type: integer title: Timeout description: Maximum time in seconds to wait for the endpoint response headers: additionalProperties: type: string type: object title: Headers description: HTTP headers to include in the request body: type: object title: Body description: Request body data to send to the endpoint query: additionalProperties: type: string type: object title: Query description: URL query parameters to include in the request cache: type: boolean title: Cache description: Whether to cache the response data for subsequent use response_data: items: $ref: '#/components/schemas/DynamicDataResponseConfigItemResponse' type: array title: Response Data description: Configuration for parsing and using the endpoint response data type: object required: - url - method - timeout - headers - body - query - cache - response_data title: DynamicDataConfigItemResponse StringPostCallAnalysisItemResponse: properties: type: type: string const: string title: Type description: Indicates this analysis item returns a text string name: type: string title: Name description: Identifier for this analysis item description: type: string title: Description description: >- Detailed description of what this analysis item measures or determines system_prompt: type: string title: System Prompt description: Prompt used to guide the AI in performing this analysis examples: anyOf: - items: type: string type: array - type: 'null' title: Examples description: Example responses to guide the analysis type: object required: - type - name - description - system_prompt title: StringPostCallAnalysisItemResponse EnumPostCallAnalysisItemResponse: properties: type: type: string const: enum title: Type description: >- Indicates this analysis item returns one of a predefined set of values name: type: string title: Name description: Identifier for this analysis item description: type: string title: Description description: >- Detailed description of what this analysis item measures or determines system_prompt: type: string title: System Prompt description: Prompt used to guide the AI in performing this analysis choices: items: type: string type: array title: Choices description: List of possible values this analysis item can return type: object required: - type - name - description - system_prompt - choices title: EnumPostCallAnalysisItemResponse BooleanPostCallAnalysisItemResponse: properties: type: type: string const: boolean title: Type description: Indicates this analysis item returns a true/false result name: type: string title: Name description: Identifier for this analysis item description: type: string title: Description description: >- Detailed description of what this analysis item measures or determines system_prompt: type: string title: System Prompt description: Prompt used to guide the AI in performing this analysis type: object required: - type - name - description - system_prompt title: BooleanPostCallAnalysisItemResponse NumberPostCallAnalysisItemResponse: properties: type: type: string const: number title: Type description: Indicates this analysis item returns a numeric value name: type: string title: Name description: Identifier for this analysis item description: type: string title: Description description: >- Detailed description of what this analysis item measures or determines system_prompt: type: string title: System Prompt description: Prompt used to guide the AI in performing this analysis type: object required: - type - name - description - system_prompt title: NumberPostCallAnalysisItemResponse DynamicDataResponseConfigItemResponse: properties: name: type: string title: Name description: Identifier for this dynamic data field data: type: string title: Data description: The actual data value retrieved from the external source context: type: string title: Context description: Additional context or metadata about this data field type: object required: - name - data - context title: DynamicDataResponseConfigItemResponse ````