---
title: "Update capacity"
method: PATCH
path: "/v2/capacities/{id}"
tags: ["Capacities"]
---

# Update capacity

`PATCH /v2/capacities/{id}`

Update the fields of a capacity.
Updating the requirements object will update the default requirements applied for instances in this capacity.

## Path parameters

- `id` string, required

## Request body

- MarketApiPatchCapacityRequest
  - `name` string, nullable — Human-readable name for the capacity. Must be unique per owner if provided. Set to null to clear the name.
  - `requirements` object, nullable
    - `zone` string, nullable
  - `default_node_template` string, nullable — Default node template (ID or name). Must belong to the same owner.
  - `start_nodes_automatically` boolean, nullable — If true nodes will be provisioned automatically using the capacity template as compute is procured.
  - `scheduler` object, nullable — Scheduler configuration. If provided, replaces the entire scheduler. Omit to leave unchanged.
    - `spot_scaler` MarketApiSpotScalerConfig, required
      - `min_sell_price_dollars_per_node_hour` string, required — Price rate in dollars per node-hour, encoded as a decimal string. Must contain a decimal point (e.g. "1.50"). Returns 6 decimal places of precision (e.g. "1.500000").
      - `max_buy_price_dollars_per_node_hour` string, required — Price rate in dollars per node-hour, encoded as a decimal string. Must contain a decimal point (e.g. "1.50"). Returns 6 decimal places of precision (e.g. "1.500000").
      - `desired_quantity` integer, required — Target node count
      - `managed_window_minutes` integer, required — How far in advance to place orders/minimum preemption notice time (minutes)
      - `enabled` boolean, required — Whether the scheduler actively places orders
    - `type` 'spot_scaler', required

## Response `200`

Capacity updated successfully

- MarketApiCapacityDetails
  - `object` 'capacity', required — Type identifier useful for discriminating union types.
  - `id` string, required — Generated ID with format 'cap_[0-9a-zA-Z]+' used for referencing a CapacityId resource.
  - `name` string — A validated resource name. Must start with alphanumeric, followed by alphanumeric, '.', '_', or '-'. Max 255 characters.
  - `default_node_template` string — Generated ID with format 'ntmpl_[0-9a-zA-Z]+' used for referencing a NodeTemplateId resource.
  - `start_nodes_automatically` boolean, required — If true nodes will be provisioned automatically using the capacity template as compute is procured.
  - `requirements` object, required — Zone requirements for this capacity.
    - `zone` string, nullable
  - `created_at` integer, required — Unix timestamp in seconds since epoch
  - `schedule_info` object, required — Capacity schedule summed and by zone
    - `zone_schedules` object, required — Capacity schedule per zone
    - `total_schedule` MarketApiSchedule, required — Denotes previous and upcoming capacity availability over time.
      - `object` 'schedule', required
      - `data` MarketApiScheduleEntry[], required
        - `timestamp` integer, required — Unix timestamp in seconds since epoch
        - `quantity` integer, required
  - `scheduler` object, nullable — Scheduler configuration for this capacity, if configured
    - `spot_scaler` MarketApiSpotScalerConfig, required
      - `min_sell_price_dollars_per_node_hour` string, required — Price rate in dollars per node-hour, encoded as a decimal string. Must contain a decimal point (e.g. "1.50"). Returns 6 decimal places of precision (e.g. "1.500000").
      - `max_buy_price_dollars_per_node_hour` string, required — Price rate in dollars per node-hour, encoded as a decimal string. Must contain a decimal point (e.g. "1.50"). Returns 6 decimal places of precision (e.g. "1.500000").
      - `desired_quantity` integer, required — Target node count
      - `managed_window_minutes` integer, required — How far in advance to place orders/minimum preemption notice time (minutes)
      - `enabled` boolean, required — Whether the scheduler actively places orders
    - `type` 'spot_scaler', required

## Other responses

- `400` — Invalid request (e.g., image not found)
- `401` — Unauthorized request
- `404` — Capacity not found
- `500` — Internal server error

## Changes

- **2026-02-10** `e161bba8bfda` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/changes/v2/capacities/:id/patch.md)

---

[API](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/e161bba8bfda/schema)