---
title: "Pull Image"
method: POST
path: "/docker/pull-image"
tags: ["Docker"]
---

# Pull Image

`POST /docker/pull-image`

Start downloading a Docker image in the background.

Initiates an asynchronous pull operation for the specified Docker image. The pull
runs in the background, allowing the API to remain responsive. Use the /pull-status
endpoint to monitor progress.

Use this endpoint to download new Hummingbot versions or other required images
before creating containers.

## Request body

- DockerImage — Docker image specification for pull operations.
  - `image_name` string, required — Full Docker image name with optional tag. Format: 'repository/image:tag'. Examples: 'hummingbot/hummingbot:latest', 'hummingbot/hummingbot:1.28.0', 'hummingbot/gateway:latest'. If no tag is specified, 'latest' is assumed.

## 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`
- **2026-01-17** `daa29248aacc` — 1 info
  - api operation id `pull_image_docker_pull_image__post` removed and replaced with `pull_image_docker_pull_image_post`
- **2025-12-20** `1005bcd47280` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hummingbot/apis/hummingbot-api/changes/docker/pull-image/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)