---
title: "Pause a container"
method: POST
path: "/containers/{id}/pause"
tags: ["Container"]
---

# Pause a container

`POST /containers/{id}/pause`

Use the freezer cgroup to suspend all processes in a container.

Traditionally, when suspending a process the `SIGSTOP` signal is used,
which is observable by the process being suspended. With the freezer
cgroup the process is unaware, and unable to capture, that it is being
suspended, and subsequently resumed.

## Path parameters

- `id` string, required

## Response `204`

no error

## Other responses

- `404` — no such container
- `500` — server error

---

[API](https://skmtc.net/docker/apis/docker-engine-api.md) · [All operations](https://skmtc.net/docker/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/docker/docker-engine-api/versions/a181425ed19e/schema)