---
title: "Remove Container"
method: POST
path: "/docker/remove-container/{container_name}"
tags: ["Docker"]
---

# Remove Container

`POST /docker/remove-container/{container_name}`

Remove a Hummingbot container and archive its trading data.

Stops and removes the specified Hummingbot container, then archives the bot's
instance data (configurations, logs, database) either locally or to S3. This
ensures trading history is preserved before container removal.

Important: This endpoint ONLY works with Hummingbot containers (names must start
with "hummingbot-"). For general container removal, use Docker CLI directly.

Use this endpoint when decommissioning a bot to ensure its data is safely
archived before cleanup.

## Path parameters

- `container_name` string, required

## Query parameters

- `archive_locally` boolean
- `s3_bucket` string

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-01-18** `576ec8539f76` — 1 breaking
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/docker/remove-container/:container_name/post.md)

---

[API](https://skmtc.dev/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.dev/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/revisions/576ec8539f76/schema)