---
title: "Put Pools"
method: PUT
path: "/api/configs/pool"
tags: ["Config API"]
---

# Put Pools

`PUT /api/configs/pool`

## Request

- The document declares no server URL.
- Auth: none declared

Put Pool configurations

## Headers

- `x-osmo-user` string, nullable

## Request body

- PutPoolsRequest: Request body for updating pools with history tracking metadata.
  - `description` string, nullable
  - `tags` string[], nullable
  - `configs` object, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-05-11** `4a5778cf4e28`: 2 info
  - added the new optional request property `configs/additionalProperties/parsed_pod_template_for_accounting`
  - added the new optional request property `configs/additionalProperties/platforms/additionalProperties/parsed_pod_template_for_accounting`
- **2026-04-08** `a8157dc3279d`: 8 breaking, 1 warning, 11 info
  - removed the enum value `MAINTENANCE` of the request property `configs/additionalProperties/status`
  - removed the enum value `OFFLINE` of the request property `configs/additionalProperties/status`
  - removed the enum value `ONLINE` of the request property `configs/additionalProperties/status`
  - removed the enum value `download` of the request property `configs/additionalProperties/download_type`
  - …16 more
- **2026-02-27** `3b4b243276b5`: 1 warning, 3 info
  - removed the request property `configs/additionalProperties/action_permissions`
  - added the new optional request property `configs/additionalProperties/common_group_templates`
  - added the new optional request property `configs/additionalProperties/parsed_group_templates`
  - added the new optional request property `configs/additionalProperties/topology_keys`

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/configs/pool/put.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)