> ## Documentation Index > Fetch the complete documentation index at: https://docs.domino.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update a hardware tier > Update a hardware tier. Required permissions: `ManageHardwareTiers` ## OpenAPI ````yaml /api-specs/cloud/public-api.json put /api/hardwaretiers/v1/hardwaretiers openapi: 3.0.3 info: title: Domino Public API description: Reference for Domino's public REST API endpoints. version: 6.4.0 x-catalog-key: nucleus servers: - url: https://mycluster.domino.tech description: >- Replace 'mycluster.domino.tech' with your Domino cluster hostname. For Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g., acme.domino.tech). For self-hosted deployments, it is the hostname you reach the Domino UI at. security: [] tags: - name: Projects - name: Project templates - name: Workspaces - name: Jobs - name: HPC Jobs - name: Environments - name: Hardware Tiers - name: Datasets - name: Data Sources - name: GenAI - name: AI Systems - name: Apps - name: App versions - name: App instances - name: Model APIs - name: Registered models - name: Model deployment - name: Extensions - name: Cost and billing - name: Users and organizations - name: Service accounts - name: Personal Access Tokens - name: Personal Access Tokens (admin) - name: Audit Trail - name: Custom metrics - name: PPM - name: Model Monitoring models - name: Model Monitoring drift and quality - name: Model Monitoring settings - name: Model Monitoring authentication - name: Governance bundles - name: Governance policies - name: Governance evidence and results - name: Governance operations - name: NetApp Volumes - name: NetApp Volumes snapshots - name: NetApp Volumes filesystems - name: NetApp Volumes transfers - name: Tags - name: Properties externalDocs: description: OpenAPI url: https://swagger.io/resources/open-api/ paths: /api/hardwaretiers/v1/hardwaretiers: put: tags: - Hardware Tiers summary: Update a hardware tier description: 'Update a hardware tier. Required permissions: `ManageHardwareTiers`' operationId: updateHardwareTier requestBody: content: application/json: schema: $ref: '#/components/schemas/HardwareTierV1' description: Updated hardware tier required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/HardwareTierEnvelopeV1' description: Success '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '500': $ref: '#/components/responses/500' security: - DominoApiKey: [] - BearerAuthentication: [] components: schemas: HardwareTierV1: properties: architecture: description: >- CPU architecture this hardware tier runs on. Valid values are amd64 and arm64, defaulting to amd64 if omitted. type: string availabilityZones: items: type: string type: array capacity: $ref: '#/components/schemas/HardwareTierCapacityV1' centsPerMinute: description: Cost per minute of using this hardware tier as defined by an Admin. format: double type: number computeClusterRestrictions: $ref: '#/components/schemas/HardwareTierComputeClusterRestrictionsV1' creationTime: description: When the hardware tier was created example: '2022-03-12T02:13:44.467Z' format: date-time type: string dataPlaneId: type: string dataPlaneName: description: >- Human-readable name of the data plane this hardware tier is configured to run on. Resolved at read time; not persisted. Optional for backward compatibility. type: string flags: $ref: '#/components/schemas/HardwareTierFlagsV1' gpuConfiguration: $ref: '#/components/schemas/HardwareTierGpuConfigurationV1' id: example: small-k8s type: string maxSimultaneousExecutions: type: integer metadata: type: object additionalProperties: type: string name: example: My-HardwareTier type: string nodePool: type: string overProvisioning: $ref: '#/components/schemas/HardwareTierOverProvisioningV1' podCustomization: $ref: '#/components/schemas/HardwareTierPodCustomizationV1' resources: $ref: '#/components/schemas/HardwareTierResourcesV1' tags: items: type: string type: array updateTime: description: When the hardwareTier was last updated example: '2022-03-12T02:13:44.467Z' format: date-time type: string required: - id - name - resources - flags - centsPerMinute - creationTime - updateTime - podCustomization - metadata type: object HardwareTierEnvelopeV1: properties: hardwareTier: $ref: '#/components/schemas/HardwareTierV1' metadata: $ref: '#/components/schemas/MetadataV1' required: - hardwareTier - metadata type: object HardwareTierCapacityV1: description: >- Current capacity information for a hardware tier. Note: Not necessary on requests to update a hardware tier. properties: availableCapacityWithoutLaunching: type: integer capacityLevel: enum: - CanExecuteWithCurrentInstances - RequiresLaunchingInstance - Full - Unknown type: string executingRuns: type: integer maxAvailableCapacity: type: integer maxConcurrentRuns: type: integer maxNumberOfExecutors: type: integer numberOfExecutors: type: integer queuedRuns: type: integer required: - numberOfExecutors - maxNumberOfExecutors - executingRuns - queuedRuns - maxConcurrentRuns - availableCapacityWithoutLaunching - maxAvailableCapacity - capacityLevel type: object HardwareTierComputeClusterRestrictionsV1: description: Details about specific compute clusters a hardware tier is restricted to properties: restrictToDask: type: boolean restrictToMpi: type: boolean restrictToRay: type: boolean restrictToSlurm: type: boolean restrictToSpark: type: boolean required: - restrictToSpark - restrictToRay - restrictToDask - restrictToMpi - restrictToSlurm type: object HardwareTierFlagsV1: description: Boolean flags for a hardware tier properties: isArchived: type: boolean isDataAnalystTier: type: boolean isDefault: type: boolean isDefaultForModelApi: type: boolean isGlobal: type: boolean isModelApiTier: type: boolean isVisible: type: boolean required: - isDefault - isVisible - isGlobal - isArchived - isDataAnalystTier type: object HardwareTierGpuConfigurationV1: description: Gpu configuration for a hardware tier properties: gpuKey: type: string numberOfGpus: type: integer required: - numberOfGpus - gpuKey type: object HardwareTierOverProvisioningV1: description: Over provisioning settings for a hardware tier properties: daysOfWeek: items: type: string type: array fromTime: type: string instances: type: integer schedulingEnabled: type: boolean timezone: type: string toTime: type: string required: - instances - schedulingEnabled - daysOfWeek - timezone - fromTime - toTime type: object HardwareTierPodCustomizationV1: description: Custom fields for hardwareTier properties: additionalAnnotations: type: object additionalProperties: type: string additionalLabels: type: object additionalProperties: type: string additionalLimits: type: object additionalProperties: type: string additionalRequests: type: object additionalProperties: type: string capabilities: items: type: string type: array hugepages: type: object additionalProperties: type: string type: object HardwareTierResourcesV1: description: Compute resources for a hardware tier properties: allowSharedMemoryToExceedDefault: type: boolean cores: example: 1 format: double type: number coresLimit: format: double type: number memory: $ref: '#/components/schemas/InformationV1' memoryLimit: $ref: '#/components/schemas/InformationV1' memorySwapLimit: $ref: '#/components/schemas/InformationV1' sharedMemoryLimit: $ref: '#/components/schemas/InformationV1' required: - cores - memory - allowSharedMemoryToExceedDefault type: object MetadataV1: properties: notices: description: Notices relating to the request items: type: string type: array requestId: type: string required: - requestId - notices type: object ErrorV1: properties: code: description: Machine-readable error code. example: NOT_FOUND type: string message: description: Human-readable description of the error. example: The requested HPC Job could not be found. type: string required: - message type: object InformationV1: properties: units: enum: - MB - MiB - GB - GiB type: string value: format: double type: number required: - value - units type: object responses: '400': content: application/json: schema: properties: error: type: string type: object description: Bad Request '401': content: application/json: example: code: UNAUTHORIZED message: Authentication is required to access this resource. schema: $ref: '#/components/schemas/ErrorV1' description: Unauthorized - authentication is required or has failed. '403': content: application/json: example: code: FORBIDDEN message: You do not have permission to perform this action. schema: $ref: '#/components/schemas/ErrorV1' description: Forbidden - the caller lacks permission to perform this action. '404': content: application/json: schema: properties: error: type: string type: object description: Not Found '500': content: application/json: schema: properties: error: type: string type: object description: Internal Server Error securitySchemes: DominoApiKey: type: apiKey in: header name: X-Domino-Api-Key BearerAuthentication: type: apiKey name: Authorization in: header ```` ## Related topics - [Manage a hardware tier](/cloud/admin/infrastructure-and-compute/manage-compute-resources/hardware-tiers/manage-hardware-tier.md) - [Manage hardware tiers](/cloud/admin/infrastructure-and-compute/manage-compute-resources/hardware-tiers/index.md) - [Advanced hardware tier settings](/cloud/admin/infrastructure-and-compute/manage-compute-resources/hardware-tiers/advanced-hardware-tier-settings.md) - [Hardware tier best practices](/cloud/admin/infrastructure-and-compute/manage-compute-resources/hardware-tiers/hardware-tier-best-practices.md)