---
title: "Update capacity claim"
method: PATCH
path: "/v1alpha1/inference/capacityclaims/{id}"
tags: ["CapacityClaimService"]
---

# Update capacity claim

`PATCH /v1alpha1/inference/capacityclaims/{id}`

Updates an existing CapacityClaim. The full `resources` block is required and replaces the existing reservation.

## Path parameters

- `id` string, required

## Request body

- UpdateCapacityClaimRequest — Request to update a CapacityClaim
  - `id` string, required — The unique identifier of the CapacityClaim to update, UUID format
  - `resources` CapacityClaimResources, required — Resources to reserve within a CapacityClaim
    - `instanceId` string, required — The instance type to reserve, by ID specifier (for example, `gb200-4x`). Identifiers are case-sensitive and must use the lowercase form. Must be a valid instance type within at least one of the specified `zones`.
    - `instanceCount` integer, required — The number of instances to reserve.
    - `zones` string[], required — The Availability Zones the CapacityClaim may use resources from. Zone identifiers are case-sensitive and must use the uppercase canonical form (for example, `US-WEST-04A`). The order of `zones` implies an allocation preference; earlier entries are preferred.
    - `capacityType` 'CAPACITY_TYPE_SERVERLESS' | 'CAPACITY_TYPE_CUSTOMER', required — The capacity type for the CapacityClaim. `CAPACITY_TYPE_CUSTOMER` reserves customer-owned capacity that is allocated by joining Nodes to the cluster.

## Response `200`

OK

- UpdateCapacityClaimResponse — Response for UpdateCapacityClaim
  - `capacityClaim` CapacityClaim — CapacityClaim object with specification and status fields
    - `spec` CapacityClaimSpec — CapacityClaimSpec contains the specification for a CapacityClaim
      - `id` string — The unique identifier of the CapacityClaim, UUID format
      - `name` string — The human readable name of the CapacityClaim
      - `resources` CapacityClaimResources — Resources to reserve within a CapacityClaim
        - `instanceId` string, required — The instance type to reserve, by ID specifier (for example, `gb200-4x`). Identifiers are case-sensitive and must use the lowercase form. Must be a valid instance type within at least one of the specified `zones`.
        - `instanceCount` integer, required — The number of instances to reserve.
        - `zones` string[], required — The Availability Zones the CapacityClaim may use resources from. Zone identifiers are case-sensitive and must use the uppercase canonical form (for example, `US-WEST-04A`). The order of `zones` implies an allocation preference; earlier entries are preferred.
        - `capacityType` 'CAPACITY_TYPE_SERVERLESS' | 'CAPACITY_TYPE_CUSTOMER', required — The capacity type for the CapacityClaim. `CAPACITY_TYPE_CUSTOMER` reserves customer-owned capacity that is allocated by joining Nodes to the cluster.
      - `organizationId` string — The organization ID that owns the CapacityClaim
    - `status` CapacityClaimStatus — CapacityClaimStatus contains the status fields for a CapacityClaim
      - `createdAt` string, date-time — The time at which the CapacityClaim was created.
      - `updatedAt` string, date-time — The time at which the CapacityClaim was last updated.
      - `conditions` Condition[] — List of conditions representing detailed status information
        - `type` string — Type of condition
        - `lastUpdateTime` string, date-time — Last time the condition was updated
        - `reason` string — Reason for the condition's last transition
        - `message` string — Human-readable message indicating details about the condition
        - `zone` string — Zone associated with the condition
        - `status` 'True' | 'False' | 'Unknown' — Whether the condition is currently `True`, `False`, or `Unknown`. Mirrors the Kubernetes condition convention.
      - `allocatedInstances` integer — The number of instances currently allocated and available.
      - `pendingInstances` integer — The number of instances being provisioned (for `CAPACITY_TYPE_CUSTOMER`, this typically reflects Nodes being joined to fulfill the reservation).
      - `status` 'STATUS_CREATING' | 'STATUS_READY' | 'STATUS_UPDATING' | 'STATUS_DELETING' | 'STATUS_ERROR' | 'STATUS_FAILED' — The overall status of the CapacityClaim. See the [Inference API overview](https://docs.coreweave.com/products/inference/reference/api-overview#status-values) for the meaning of each value.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api.md) · [All operations](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coreweave/coreweave-telemetry-relay-api/revisions/3b98ea4fe0c3/schema)