> ## 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 Image Prewarm Tasks



## OpenAPI

````yaml api-reference/gpus-v2-spec/list-image-prewarm.json GET /gpus/v2/prewarm-tasks
openapi: 3.0.0
info:
  title: Novita GPU API v2
  version: 2.0.0
servers:
  - url: https://api.novita.ai
security: []
paths:
  /gpus/v2/prewarm-tasks:
    get:
      summary: List Image Prewarm Tasks
      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: Maximum number of items to return. Integer, value >= 0.
          example: 10
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Cursor returned by the previous page. Leave empty for the first
            request. String, length: 0-1024 characters.
          example: eyJpZCI6InByZXdhcm0tdGFzay1pZCJ9
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - pending
              - running
              - succeeded
              - failed
          description: >-
            Filter by task status. Allowed values: `pending`, `running`,
            `succeeded`, `failed`. Use an empty string to skip filtering.
          example: running
        - name: region_id
          in: query
          required: false
          schema:
            type: string
          description: 'Filter by region ID. String, length: 0-255 characters.'
          example: region-a
        - name: name
          in: query
          required: false
          schema:
            type: string
          description: >-
            Fuzzy search by image name or note. String, length: 0-255
            characters.
          example: image
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: Image prewarm task list
                    items:
                      type: object
                      properties:
                        task_id:
                          type: string
                          description: Image prewarm task ID
                          example: prewarm-task-id
                        name:
                          type: string
                          description: Image name
                          example: image:tag
                        image:
                          type: string
                          description: Image address
                          example: registry.example.com/team/image:tag
                        region_id:
                          type: string
                          description: Region ID
                          example: region-a
                        product_ids:
                          type: array
                          items:
                            type: string
                          description: Product IDs covered by prewarming
                          example:
                            - product-a
                        image_size:
                          type: integer
                          description: 'Image size. Unit: bytes'
                          example: 10737418240
                        created_at:
                          type: integer
                          description: Creation time. Unix timestamp
                          example: 1714982400
                        completed_at:
                          type: integer
                          description: Completion time. Unix timestamp; 0 when not finished
                          example: 0
                        status:
                          type: object
                          description: Task status
                          properties:
                            status:
                              type: string
                              enum:
                                - pending
                                - running
                                - succeeded
                                - failed
                              description: >-
                                Status value. Allowed values: `pending`,
                                `running`, `succeeded`, `failed`
                              example: running
                            error:
                              type: string
                              description: Error code or error type
                              example: ''
                            message:
                              type: string
                              description: Status note or error message
                              example: ''
                        registry_auth_id:
                          type: string
                          description: Registry authentication ID
                          example: registry-auth-id
                        note:
                          type: string
                          description: Note for the prewarm task
                          example: ''
                        reason:
                          type: array
                          items:
                            type: string
                          description: Reasons for prewarm failure
                          example:
                            - ''
                  next_cursor:
                    type: string
                    description: >-
                      Cursor for the next page. Empty string when there is no
                      more data
                    example: eyJpZCI6Im5leHQtcGFnZSJ9
                  has_more:
                    type: boolean
                    description: Whether more data is available
                    example: true

````