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

# List user models

> Returns models owned by the authenticated user plus platform models (created_by IS NULL), including single and router models.



## OpenAPI

````yaml /openapi.yaml get /user-models
openapi: 3.0.3
info:
  title: Hill90 API
  description: Hill90 platform API — agent management and lifecycle operations.
  version: 0.1.0
servers:
  - url: /
    description: Relative (behind Traefik reverse proxy)
security: []
paths:
  /user-models:
    get:
      summary: List user models
      description: >-
        Returns models owned by the authenticated user plus platform models
        (created_by IS NULL), including single and router models.
      responses:
        '200':
          description: Model list
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    name:
                      type: string
                    connection_id:
                      type: string
                      format: uuid
                      nullable: true
                      description: Null for router models
                    litellm_model:
                      type: string
                      nullable: true
                      description: Null for router models
                    description:
                      type: string
                    is_active:
                      type: boolean
                    is_platform:
                      type: boolean
                      description: >-
                        True if this is a platform-managed model (created_by IS
                        NULL)
                    model_type:
                      type: string
                      enum:
                        - single
                        - router
                    detected_type:
                      type: string
                      description: >-
                        Auto-detected model type (chat, embedding, audio, image,
                        transcription)
                    capabilities:
                      type: array
                      items:
                        type: string
                    routing_config:
                      type: object
                      nullable: true
                      description: Router configuration (null for single models)
                      properties:
                        strategy:
                          type: string
                          enum:
                            - fallback
                            - task_routing
                        default_route:
                          type: string
                        routes:
                          type: array
                          items:
                            type: object
                            properties:
                              key:
                                type: string
                              connection_id:
                                type: string
                                format: uuid
                              litellm_model:
                                type: string
                              detected_type:
                                type: string
                              capabilities:
                                type: array
                                items:
                                  type: string
                              task_types:
                                type: array
                                items:
                                  type: string
                              priority:
                                type: integer
                    icon_emoji:
                      type: string
                      nullable: true
                      deprecated: true
                      description: >-
                        Deprecated — always null on new writes. Use icon_url
                        instead.
                    icon_url:
                      type: string
                      nullable: true
                    created_at:
                      type: string
                      format: date-time
                    updated_at:
                      type: string
                      format: date-time
        '401':
          description: Not authenticated
        '403':
          description: Requires user role
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````