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

# List Images



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/admin/images
openapi: 3.1.0
info:
  title: Mount Thor Customer API
  version: v1
servers:
  - description: Mount Thor customer API edge
    url: https://api.mountthor.com
security: []
paths:
  /v1/admin/images:
    get:
      tags:
        - images
      summary: List Images
      operationId: list_images
      parameters:
        - description: Page size; defaults to 50 and is capped at 200.
          in: query
          name: pageSize
          required: false
          schema:
            format: int32
            type:
              - integer
              - 'null'
        - description: Opaque cursor returned by the preceding page.
          in: query
          name: pageToken
          required: false
          schema:
            type:
              - string
              - 'null'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageListResponse'
          description: Accessible image catalog
        '400':
          description: Invalid pagination cursor
        '401':
          description: Missing or invalid customer credential
        '403':
          description: Credential is missing image:read scope
        '429':
          content:
            text/plain:
              schema:
                type: string
          description: Rate limit exceeded
          headers:
            Retry-After:
              description: Seconds before retry.
              schema:
                minimum: 1
                type: integer
      security:
        - api_key_bearer:
            - image:read
components:
  schemas:
    ImageListResponse:
      additionalProperties: false
      properties:
        images:
          items:
            $ref: '#/components/schemas/CustomerImage'
          type: array
        nextPageToken:
          type:
            - string
            - 'null'
      required:
        - images
      type: object
    CustomerImage:
      additionalProperties: false
      properties:
        activeImport:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ImageImportOperationMetadata'
        archiveSha256:
          type:
            - string
            - 'null'
        archiveSizeBytes:
          format: int64
          type:
            - integer
            - 'null'
        compatibility:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ImageCompatibility'
        createdAt:
          type: string
        deletedAt:
          type:
            - string
            - 'null'
        formatVersion:
          description: Canonical archive contract understood by Mount Thor tooling.
          type: string
        id:
          description: Stable customer-facing id (`img_` plus 32 lowercase hex characters).
          type: string
        issues:
          items:
            $ref: '#/components/schemas/ImageIssue'
          type: array
        kind:
          description: '`base` or `customer`.'
          type: string
        lineage:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ImageLineage'
        name:
          type: string
        publishedAt:
          type:
            - string
            - 'null'
        status:
          description: '`importing`, `ready`, `invalid`, `deleting`, or `deleted`.'
          type: string
        subjectDigest:
          type:
            - string
            - 'null'
        updatedAt:
          type: string
      required:
        - id
        - name
        - kind
        - status
        - formatVersion
        - issues
        - createdAt
        - updatedAt
      type: object
    ImageImportOperationMetadata:
      additionalProperties: false
      properties:
        archiveSha256:
          type: string
        archiveSizeBytes:
          format: int64
          type: integer
        imageId:
          type: string
        imageName:
          type: string
        importId:
          type: string
        issues:
          items:
            $ref: '#/components/schemas/ImageIssue'
          type: array
        operationName:
          type:
            - string
            - 'null'
        progressPercent:
          format: int32
          type: integer
        sourceImageId:
          type: string
        sourceImageName:
          type: string
        sourceImageSubjectDigest:
          type: string
        stage:
          type: string
        subjectDigest:
          type: string
        updatedAt:
          type: string
        uploadExpiresAt:
          type:
            - string
            - 'null'
        uploadPartSizeBytes:
          format: int64
          type: integer
      required:
        - imageId
        - imageName
        - importId
        - stage
        - progressPercent
        - uploadPartSizeBytes
        - issues
        - updatedAt
        - sourceImageName
        - sourceImageId
        - sourceImageSubjectDigest
        - archiveSizeBytes
        - archiveSha256
        - subjectDigest
      type: object
    ImageCompatibility:
      additionalProperties: false
      properties:
        architecture:
          type: string
        chipFamilies:
          items:
            type: string
          type:
            - array
            - 'null'
        guestAgentContract:
          type: string
        hostClasses:
          items:
            type: string
          type: array
        macosBuild:
          type: string
        macosVersion:
          type: string
        minFreeDiskBytes:
          format: int64
          minimum: 0
          type:
            - integer
            - 'null'
        minHostMacosVersion:
          type:
            - string
            - 'null'
        operatingSystem:
          type: string
        requiredVirtualizationFeatures:
          items:
            type: string
          type:
            - array
            - 'null'
        requiresApfsClone:
          type:
            - boolean
            - 'null'
        toolchains:
          items:
            $ref: '#/components/schemas/ImageToolchain'
          type: array
      required:
        - operatingSystem
        - architecture
        - macosVersion
        - macosBuild
        - hostClasses
        - guestAgentContract
      type: object
    ImageIssue:
      additionalProperties: false
      properties:
        code:
          type: string
        componentPath:
          type:
            - string
            - 'null'
        expected:
          type:
            - string
            - 'null'
        observed:
          type:
            - string
            - 'null'
        remediation:
          type: string
        severity:
          type: string
      required:
        - code
        - severity
        - remediation
      type: object
    ImageLineage:
      additionalProperties: false
      properties:
        sourceImageId:
          type: string
        sourceImageName:
          type: string
        sourceImageSubjectDigest:
          type: string
      required:
        - sourceImageName
        - sourceImageId
        - sourceImageSubjectDigest
      type: object
    ImageToolchain:
      additionalProperties: false
      properties:
        build:
          type:
            - string
            - 'null'
        name:
          type: string
        version:
          type: string
      required:
        - name
        - version
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````