---
title: "Updates the properties of the specified pool."
method: PATCH
path: "/pools/{poolId}"
tags: ["Pools"]
---

# Updates the properties of the specified pool.

`PATCH /pools/{poolId}`

This only replaces the pool properties specified in the request. For example, if the pool has a start task associated with it, and a request does not specify a start task element, then the pool keeps the existing start task.

## Path parameters

- `poolId` string, required

## Query parameters

- `timeout` integer
- `api-version` string, required

## Headers

- `client-request-id` string, uuid
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc1123
- `If-Match` string
- `If-None-Match` string
- `If-Modified-Since` string, date-time-rfc1123
- `If-Unmodified-Since` string, date-time-rfc1123

## Response `200`

The request to the Batch service was successful.

## Other responses

- `default` — The error from the Batch service.

---

[API](https://skmtc.net/windows/apis/batch-batchservice.md) · [All operations](https://skmtc.net/windows/apis/batch-batchservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windows/batch-batchservice/revisions/9ab62bb93c5f/schema)