> ## 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.

# Get the platform-managed LLM backup order

> Resolve the platform-managed backup order for a selectable primary LLM. The response contains public model identities only.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/convai/llm/cascade-config
openapi: 3.1.0
info:
  title: Threetone API
  description: >-
    APIs for the Threetone Agents Platform and shared workspace resources.
    Authenticate programmatic requests with an API key in the x-api-key header.
  version: '1.0'
servers:
  - url: https://api.threetone.in
    description: Production
security: []
paths:
  /v1/convai/llm/cascade-config:
    get:
      tags:
        - Agents Platform
      summary: Get the platform-managed LLM backup order
      description: >-
        Resolve the platform-managed backup order for a selectable primary LLM.
        The response contains public model identities only.
      operationId: get_llm_cascade_config
      parameters:
        - name: primary_llm
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/CatalogModelId'
        - 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/LLMCascadeConfigResponseModel'
        '400':
          description: The primary LLM is unavailable to the workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/HTTPValidationError'
                  - $ref: '#/components/schemas/APIErrorResponse'
                title: Response 422 Get Llm Cascade Config
        default:
          description: >-
            API error. Depending on the operation: 400 invalid request, 401
            authentication required, 402 insufficient credits, 403 permission
            denied, 404 resource not found, 409 conflict, 429 rate limit, 500
            internal failure, 502 upstream failure, 503 service unavailable, or
            504 upstream timeout. A failed response does not establish whether a
            state-changing operation completed; do not retry such operations
            without checking their outcome.
          headers:
            X-Request-Id:
              description: Request identifier, when available.
              schema:
                type: string
            Retry-After:
              description: >-
                When supplied, the delay in seconds or HTTP date before a
                subsequent request.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/APIErrorResponse'
components:
  schemas:
    CatalogModelId:
      type: string
      maxLength: 128
      minLength: 3
      pattern: ^[a-z][a-z0-9_-]*/[A-Za-z0-9][A-Za-z0-9._:-]*$
      description: Provider-qualified model identifier.
    LLMCascadeConfigResponseModel:
      properties:
        backup_llms:
          items:
            $ref: '#/components/schemas/CatalogModelId'
          type: array
          title: Backup Llms
        is_zero_retention_filtered:
          type: boolean
          title: Is Zero Retention Filtered
          default: false
      type: object
      required:
        - backup_llms
      title: LLMCascadeConfigResponseModel
      description: Resolved platform backup order for one selectable primary LLM.
    APIErrorResponse:
      properties:
        detail:
          $ref: '#/components/schemas/APIErrorDetail'
      type: object
      required:
        - detail
      title: APIErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    APIErrorDetail:
      properties:
        status:
          type: string
          title: Status
          description: >-
            Stable application error identifier, separate from the HTTP status
            code.
        message:
          type: string
          title: Message
          description: Customer-facing explanation of the error.
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
          description: Request identifier for support and troubleshooting, when available.
      additionalProperties: true
      type: object
      required:
        - status
        - message
      title: APIErrorDetail
      description: Public error fields; domains may supply additional customer-safe detail.
    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

````

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