---
title: "Build a container image"
method: POST
path: "/images"
tags: ["images"]
---

# Build a container image

`POST /images`

Builds a container image without creating a deployment. Returns a presigned URL for uploading source code. After upload, the image will be built and stored in the registry, but no agent, function, sandbox, or job will be created or updated.

## Request body

- object
  - `generation` string — Runtime generation (e.g., mk3). Defaults to mk3 if not specified.
  - `image` string — A pre-built Docker image reference (e.g., docker.io/myorg/myimage:latest). When provided, the build step is skipped and the image is used directly as the source for the resource runtime.
  - `name` string, required — Name of the image to build
  - `resourceType` string, required — Resource type (agent, function, sandbox, job)

## Response `200`

successful operation

- object
  - `image` string — The registered image reference (only present when image was provided in request)
  - `message` string — Status message
  - `name` string — Name of the image
  - `resourceType` string — Resource type

## Other responses

- `400` — invalid request

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/revisions/dfa264bc72ee/schema)