Heim

Proxies container image builds to the Heim build service. Used for programmatic image builds (for example from CI).

Authentication

Authorization: Bearer <YOUR_API_KEY>

---

Build Image

POST /tha/v2/heim/build

Forwards the request body to Heim. Returns either a streamed build log (text/plain) or a cached JSON response.

Request body

Field	Type	Description
dockerfile	string	Dockerfile contents
files	object	Context files
repo	string	Git repository URL
ref	string	Git ref
image_id	string	Target image ID
tag	string	Image tag
build_args	object	Docker build args
labels	object	Image labels
secrets	array	Build secrets
ssh	array	SSH mount configs
cache_from	array	Cache sources
cache_to	array	Cache destinations
no_cache	boolean	Disable build cache

Cached response

When a cached build exists:

{
  "type": "cached",
  "timestamp": "2025-01-15T10:30:00Z",
  "image_id": "sha256:..."
}