> ## 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 Fleet Resources



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/admin/fleet
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/fleet:
    get:
      tags:
        - fleet
      summary: List Fleet Resources
      operationId: get_customer_fleet
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerFleetResponse'
          description: Fleet snapshot for this tenant
        '401':
          description: Missing or invalid customer API key
        '403':
          description: API key is missing compute: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
        '502':
          description: Customer control-plane EKS is unreachable
      security:
        - api_key_bearer:
            - compute:read
components:
  schemas:
    CustomerFleetResponse:
      additionalProperties: false
      description: Fleet listing response for account-scoped compute resources.
      properties:
        bare_metal_machines:
          description: Bare-metal machines currently visible in the tenant namespace.
          items:
            $ref: '#/components/schemas/FleetBareMetalMachineSummary'
          type: array
        customer_id:
          description: Stable UUID for the customer account.
          type: string
        namespace:
          description: Kubernetes namespace used for the tenant's compute resources.
          example: tenant-acme-prod
          type: string
        tenant_id:
          description: Stable UUID for the tenant.
          type: string
        virtual_machines:
          description: Virtual machines currently visible in the tenant namespace.
          items:
            $ref: '#/components/schemas/FleetVirtualMachineSummary'
          type: array
      required:
        - customer_id
        - tenant_id
        - namespace
        - bare_metal_machines
        - virtual_machines
      type: object
    FleetBareMetalMachineSummary:
      additionalProperties: false
      description: Summary of a bare-metal machine in the account fleet.
      properties:
        created_at:
          description: Kubernetes creation timestamp.
          example: '2026-05-25T17:30:00Z'
          type: string
        failure_code:
          description: Customer-visible failure code when provisioning fails.
          example: ReservedCapacityUnavailable
          type:
            - string
            - 'null'
        failure_message:
          description: Customer-visible failure detail when provisioning fails.
          example: capacity allocation is missing for bare-metal class m4-24g
          type:
            - string
            - 'null'
        image:
          description: macOS image requested by the machine.
          example: xcode-16-stable
          type:
            - string
            - 'null'
        machine_class:
          description: Hardware class for the machine.
          example: m4-24g
          type: string
        name:
          description: Kubernetes object name for the bare-metal machine.
          example: bm-01
          type: string
        phase:
          description: >-
            Current machine phase, such as `Pending`, `Ready`, `Failed`, or
            `Reclaiming`.
          example: Ready
          type: string
        ready_for_access:
          description: Whether an access session can be opened for the machine.
          type: boolean
        resource_uid:
          example: 69d135e9-279e-4cc9-92b3-b2fb6100665d
          maxLength: 128
          minLength: 1
          type:
            - string
            - 'null'
      required:
        - name
        - machine_class
        - phase
        - ready_for_access
        - created_at
      type: object
    FleetVirtualMachineSummary:
      additionalProperties: false
      properties:
        cpu:
          description: Requested vCPU count when specified.
          format: int32
          type:
            - integer
            - 'null'
        created_at:
          description: Kubernetes creation timestamp.
          example: '2026-05-25T17:30:00Z'
          type: string
        disk_gib:
          description: Requested boot disk size in GiB when specified.
          format: int32
          type:
            - integer
            - 'null'
        failure_code:
          description: Customer-visible failure code when provisioning fails.
          example: ImageUnavailable
          type:
            - string
            - 'null'
        failure_message:
          description: Customer-visible failure detail when provisioning fails.
          example: provider VM image was not available on the selected host
          type:
            - string
            - 'null'
        image_ref:
          description: Image reference used to boot the virtual machine.
          example: xcode-16-stable
          type: string
        memory_mib:
          description: Requested memory in MiB when specified.
          format: int32
          type:
            - integer
            - 'null'
        name:
          description: Kubernetes object name for the virtual machine.
          example: vm-01
          type: string
        phase:
          description: >-
            Current VM phase, such as `Pending`, `Running`, `Failed`, or
            `Deleting`.
          example: Running
          type: string
        ready_at:
          description: RFC 3339 timestamp when the VM became ready.
          example: '2026-05-25T17:36:20Z'
          type:
            - string
            - 'null'
        ready_for_access:
          description: >-
            Whether the VM's resource and access projections are both ready for
            a

            customer session.
          type: boolean
        resource_uid:
          example: 69d135e9-279e-4cc9-92b3-b2fb6100665d
          maxLength: 128
          minLength: 1
          type:
            - string
            - 'null'
      required:
        - name
        - image_ref
        - phase
        - created_at
        - ready_for_access
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````