---
title: "Deallocates the specified Compute Node."
method: POST
path: "/pools/{poolId}/nodes/{nodeId}/deallocate"
tags: ["Nodes"]
---

# Deallocates the specified Compute Node.

`POST /pools/{poolId}/nodes/{nodeId}/deallocate`

You can deallocate a Compute Node only if it is in an idle or running state.

## Path parameters

- `poolId` string, required
- `nodeId` string, required

## Query parameters

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

## Headers

- `client-request-id` string
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc7231

## Response `202`

The request has been accepted for processing, but processing has not yet completed.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `8427acd8fd77` — 1 warning, 4 info
  - deleted the `query` request parameter `timeout`
  - api operation id `ComputeNode_Deallocate` removed and replaced with `Nodes_DeallocateNode`
  - api tag `Nodes` added
  - api tag `ComputeNodes` removed
  - …1 more
- **2026-07-13** `5ec02fdd559c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/batch-batch/changes/pools/:poolId/nodes/:nodeId/deallocate/post.md)

---

[API](https://skmtc.dev/azure/apis/batch-batch.md) · [All operations](https://skmtc.dev/azure/apis/batch-batch/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/batch-batch/revisions/8427acd8fd77/schema)