> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents.labs.bandwidth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get AI configuration options

> Retrieve provider configuration schemas and default provider choices.

This is a shared catalog. Hosted access requires a Labs OAuth bearer token or API key; the catalog itself is not scoped to a workspace. The response has configuration schemas for LLM, TTS, STT, embeddings, and realtime services, plus default provider choices. Use current schema options when constructing configuration requests.


## OpenAPI

````yaml GET /api/v1/user/configurations/defaults
openapi: 3.1.0
info:
  title: Bandwidth Agent Builder API
  version: v1
  description: >-
    Manage agents, place calls, and retrieve conversation results in your
    workspace.
servers:
  - url: https://agents.labs.bandwidth.com
    description: Workspace API
security: []
paths:
  /api/v1/user/configurations/defaults:
    get:
      tags:
        - ai-connections
      summary: Get AI configuration options
      description: >-
        **Authorization:** Hosted access requires a Labs OAuth bearer token or
        Labs API key. This shared catalog is not scoped to a workspace.


        Retrieve provider configuration schemas and default provider choices.
      operationId: get_default_configurations_api_v1_user_configurations_defaults_get
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultConfigurationsResponse'
          description: Successful Response
        '401':
          description: Missing, invalid, or expired credential.
        '404':
          description: Not found
      security:
        - LabsAuth: []
        - LabsApiKey: []
components:
  schemas:
    DefaultConfigurationsResponse:
      properties:
        default_providers:
          additionalProperties:
            type: string
          title: Default Providers
          type: object
        embeddings:
          additionalProperties:
            additionalProperties: true
            type: object
          title: Embeddings
          type: object
        llm:
          additionalProperties:
            additionalProperties: true
            type: object
          title: Llm
          type: object
        realtime:
          additionalProperties:
            additionalProperties: true
            type: object
          title: Realtime
          type: object
        stt:
          additionalProperties:
            additionalProperties: true
            type: object
          title: Stt
          type: object
        tts:
          additionalProperties:
            additionalProperties: true
            type: object
          title: Tts
          type: object
      required:
        - llm
        - tts
        - stt
        - embeddings
        - realtime
        - default_providers
      title: DefaultConfigurationsResponse
      type: object
  securitySchemes:
    LabsAuth:
      description: >-
        Bandwidth Labs OAuth access token. Uses the user's selected workspace;
        the workspace header is not required. Do not also send an API key.
        Bearer-only operations may additionally require the Labs `super_user`
        role.
      scheme: bearer
      type: http
    LabsApiKey:
      description: >-
        Bandwidth Labs API key. Also send `X-VOAI-ORGANIZATION-ID` with a
        positive local workspace ID belonging to the key owner. Access follows
        the owner's current workspace role. Do not also send a bearer token. API
        keys cannot access bearer-only or Labs `super_user` operations.
      in: header
      name: X-BW-LABS-AGENTS-API-KEY
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.