---
title: "create a checkpoint from a running container"
method: POST
path: "/containers/{id}/checkpoints"
tags: ["Container"]
---

# create a checkpoint from a running container

`POST /containers/{id}/checkpoints`

## Path parameters

- `id` string, required

## Request body

- CheckpointCreateOptions — options of creating a checkpoint from a running container, checkpoint is used to restore a container with current state later
  - `CheckpointID` string
  - `CheckpointDir` string
  - `Exit` boolean

## Response `201`

created

## Other responses

- `400` — bad parameter
- `404` — An unexpected 404 error occurred.

## Changes

- **2018-10-23** `db08fc933e07` — 1 info
  - endpoint added
- **2018-08-03** `5ae9c809fadb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/aliyun/apis/pouch-engine-api/changes/containers/:id/checkpoints/post.md)

---

[API](https://skmtc.dev/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.dev/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/revisions/36d75b2825fc/schema)