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

# List Templates



## OpenAPI

````yaml api-reference/gpus-v2-spec/list-templates.json GET /gpus/v2/templates
openapi: 3.0.0
info:
  title: Novita GPU API v2
  version: 2.0.0
servers:
  - url: https://api.novita.ai
security: []
paths:
  /gpus/v2/templates:
    get:
      summary: List Templates
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: 'Bearer authentication format, e.g.: `Bearer {{API_KEY}}`.'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
          description: Page size. Integer, value >= 0.
          example: 20
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Cursor. Leave empty for the first request. Pass through the
            `next_cursor` from the previous response. String, length: 0-1024
            characters.
        - name: name
          in: query
          required: false
          schema:
            type: string
          description: 'Search by template name. String, length: 0-255 characters.'
          example: pytorch
        - name: type
          in: query
          required: false
          schema:
            type: string
          description: Filter by template type.
          example: instance
        - name: visibilities
          in: query
          required: false
          schema:
            type: string
          description: Filter by visibility. Multiple values are comma-separated.
        - name: member_ids
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter by creator member ID. Multiple IDs are comma-separated.
            String, length: 0-255 characters.
        - name: is_my_community
          in: query
          required: false
          schema:
            type: boolean
          description: Whether to query only the user's community templates.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Template list
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Template ID
                          example: tpl-001
                        owner_id:
                          type: string
                          description: Owner user ID
                          example: owner-001
                        name:
                          type: string
                          description: Template name
                          example: pytorch-2.3-cuda12
                        type:
                          type: string
                          description: Template type
                          example: instance
                        visibility:
                          type: string
                          description: Visibility
                          example: community
                        image:
                          type: string
                          description: Image address
                          example: registry.example.com/ml/pytorch:2.3-cuda12
                        registry_auth_id:
                          type: string
                          description: Registry authentication ID
                        command:
                          type: string
                          description: Startup command
                          example: ''
                        entrypoint:
                          type: string
                          description: Image entrypoint
                        rootfs_size_gb:
                          type: integer
                          description: 'Root disk size. Unit: GB'
                          example: 50
                        ports:
                          type: array
                          description: Exposed port configuration
                          items:
                            type: object
                            properties:
                              protocol:
                                type: string
                                description: Protocol or port type
                                example: http
                              port:
                                type: integer
                                description: Port
                                example: 8888
                        envs:
                          type: array
                          description: Environment variables
                          items:
                            type: object
                            properties:
                              key:
                                type: string
                                description: Environment variable name
                              value:
                                type: string
                                description: Environment variable value
                        metadata:
                          type: object
                          description: Template metadata
                          properties:
                            readme:
                              type: string
                              description: Template readme
                              example: PyTorch 2.3 with CUDA 12
                            logo:
                              type: string
                              description: Logo URL
                              example: https://example.com/logo.png
                            description:
                              type: string
                              description: Short description
                              example: PyTorch development template
                            author:
                              type: string
                              description: Author
                              example: PAI
                            tags:
                              type: array
                              items:
                                type: string
                              description: Tags
                              example:
                                - pytorch
                                - cuda
                        min_cuda_version:
                          type: string
                          description: Minimum CUDA version
                          example: '12.2'
                        created_at:
                          type: integer
                          description: Creation time. Unix timestamp
                          example: 1715750400
                        updated_at:
                          type: integer
                          description: Update time. Unix timestamp
                          example: 1715750400
                        member_id:
                          type: string
                          description: Creator member ID
                          example: 550e8400-e29b-41d4-a716-446655440000
                  next_cursor:
                    type: string
                    description: >-
                      Cursor for the next page. Empty string when
                      `has_more=false`
                    example: eyJvZmZzZXQiOjIwfQ
                  has_more:
                    type: boolean
                    description: Whether there are more pages
                    example: true

````