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

# List kubernetes cluster autopilot savings by workload

> Returns, per workload AutoPilot managed in the period and still runs on (managed, limited, learning or rolled back), what it saved and added and its managed pod-hours, largest net saving first, one page at a time. The rows add up to the cluster's savings total. Saved and added are cost AutoPilot removed from or added to the workload's cost (by sizing and by pool placement), not bill savings; dollars are null when the cost behind them could not be priced. A managed workload with no change is listed with zero figures. from and to are RFC 3339 and truncated to the hour, to is exclusive; the default is the last 30 days ending at the last closed hour; a period over 400 days is rejected.



## OpenAPI

````yaml /api-reference/costgraph/openapi.json get /api/v1/tenant/clusters/{cluster_id}/autopilot/savings/workloads
openapi: 3.0.0
info:
  description: Read and manage your CostGraph organization, spend, alerts, and settings.
  title: CostGraph API
  contact: {}
  version: '1.0'
servers:
  - url: https://api.costgraph.ai
security: []
tags:
  - name: ai
    x-group: AI
  - name: ai-serving
    x-group: AI serving
  - name: anomalies
    x-group: Anomalies
  - name: auth
    x-group: Auth
  - name: billing
    x-group: Billing
  - name: billing-export
    x-group: Billing export
  - name: budgets
    x-group: Budgets
  - name: ci
    x-group: CI
  - name: compute-recommendations
    x-group: Compute recommendations
  - name: config
    x-group: Config
  - name: context-graph
    x-group: Context graph
  - name: cost
    x-group: Cost
  - name: gpus
    x-group: GPUs
  - name: graphai
    x-group: Graph AI
  - name: integrations
    x-group: Integrations
  - name: invitations
    x-group: Invitations
  - name: kubernetes-clusters
    x-group: Kubernetes clusters
  - name: marketplace
    x-group: Marketplace
  - name: network
    x-group: Network
  - name: network-requests
    x-group: Network requests
  - name: notifications
    x-group: Notifications
  - name: oauth
    x-group: OAuth
  - name: oauth-clients
    x-group: OAuth clients
  - name: opencost
    x-group: OpenCost
  - name: organization
    x-group: Audit log
  - name: organizations
    x-group: Organizations
  - name: placement-alternatives
    x-group: Placement alternatives
  - name: reports
    x-group: Reports
  - name: settings
    x-group: Settings
  - name: sso
    x-group: Single sign-on
  - name: tenants
    x-group: Tenants
  - name: ticketing
    x-group: Ticketing
  - name: user
    x-group: Users
  - name: virtual-machines
    x-group: Virtual machines
  - name: virtual-tags
    x-group: Virtual tags
  - name: workflows
    x-group: Workflows
paths:
  /api/v1/tenant/clusters/{cluster_id}/autopilot/savings/workloads:
    get:
      tags:
        - kubernetes-clusters
      summary: List kubernetes cluster autopilot savings by workload
      description: >-
        Returns, per workload AutoPilot managed in the period and still runs on
        (managed, limited, learning or rolled back), what it saved and added and
        its managed pod-hours, largest net saving first, one page at a time. The
        rows add up to the cluster's savings total. Saved and added are cost
        AutoPilot removed from or added to the workload's cost (by sizing and by
        pool placement), not bill savings; dollars are null when the cost behind
        them could not be priced. A managed workload with no change is listed
        with zero figures. from and to are RFC 3339 and truncated to the hour,
        to is exclusive; the default is the last 30 days ending at the last
        closed hour; a period over 400 days is rejected.
      parameters:
        - description: Tenant ID
          name: X-CostGraph-Tenant-ID
          in: header
          required: true
          schema:
            type: string
        - description: Kubernetes cluster ID
          name: cluster_id
          in: path
          required: true
          schema:
            type: string
        - description: Period start (RFC 3339, inclusive)
          name: from
          in: query
          schema:
            type: string
        - description: Period end (RFC 3339, exclusive)
          name: to
          in: query
          schema:
            type: string
        - description: Number of rows to return (default 50, max 200)
          name: limit
          in: query
          schema:
            type: integer
        - description: Rows to skip before returning results (default 0)
          name: offset
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/responses.SuccessResponse'
                  - type: object
                    properties:
                      data:
                        $ref: >-
                          #/components/schemas/operator.AutopilotWorkloadSavingsList
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/responses.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    responses.SuccessResponse:
      type: object
      required:
        - message
        - status
      properties:
        data: {}
        message:
          type: string
          example: some message
        status:
          type: string
          example: success
    operator.AutopilotWorkloadSavingsList:
      type: object
      required:
        - from
        - items
        - limit
        - offset
        - to
        - total_count
      properties:
        from:
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/operator.AutopilotWorkloadSavings'
        limit:
          type: integer
        offset:
          type: integer
        to:
          type: string
        total_count:
          type: integer
    responses.ErrorResponse:
      type: object
      required:
        - message
        - status
      properties:
        message:
          type: string
          example: some message
        status:
          type: string
          example: error
    operator.AutopilotWorkloadSavings:
      type: object
      required:
        - added
        - kind
        - managed_pod_hours
        - name
        - namespace
        - resource_id
        - saved
      properties:
        added:
          $ref: '#/components/schemas/operator.AutopilotSavingsAmounts'
        kind:
          type: string
        managed_pod_hours:
          type: number
        name:
          type: string
        namespace:
          type: string
        resource_id:
          type: string
          x-semantic: resourceId
        saved:
          $ref: '#/components/schemas/operator.AutopilotSavingsAmounts'
    operator.AutopilotSavingsAmounts:
      type: object
      required:
        - cpu_core_hours
        - gpu_hours
        - memory_gib_hours
      properties:
        cpu_core_hours:
          type: number
        gpu_hours:
          type: array
          items:
            $ref: '#/components/schemas/operator.AutopilotGPUHours'
        memory_gib_hours:
          type: number
        placement_usd:
          type: number
          x-semantic: costAmount
          nullable: true
        sizing_usd:
          type: number
          x-semantic: costAmount
          nullable: true
        usd:
          type: number
          x-semantic: costAmount
          nullable: true
    operator.AutopilotGPUHours:
      type: object
      required:
        - hours
        - model
      properties:
        hours:
          type: number
        model:
          type: string
  securitySchemes:
    BearerAuth:
      description: Enter "Bearer {token}"
      type: apiKey
      name: Authorization
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.