baked-instructions-builder

name	baked-instructions-builder
description	Hardcoded endpoint documentation for the container builder API.

Container Builder API

Base URL: $BUILDER_URL

All requests require: Authorization: Bearer $API_TOKEN

POST /build

Build a container image from a Dockerfile.

curl -X POST "$BUILDER_URL/build" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{
    \"tag\": \"myimage:latest\",
    \"dockerfile\": \"Dockerfile\",
    \"context_dir\": \"/sandbox/repo\",
    \"sandbox\": \"$(hostname | sed 's/^sandbox-//')\",
    \"dest\": \"/sandbox/image.tar\"
  }"

Request body (JSON):

• tag (required): Image tag to build
• dockerfile (optional, default "Dockerfile"): Path to the Dockerfile relative to context_dir
• context_dir (required): Path to the build context directory inside the sandbox — the server downloads this from your sandbox before building
• sandbox (required): Your sandbox name — use $(hostname | sed 's/^sandbox-//') to get it
• dest (optional): Sandbox path to upload the built image tarball to. If omitted, the image stays on the host only.

Response:

{"id": "uuid", "tag": "myimage:latest", "status": "success", "output": "..."}

POST /push

Push a built image to a registry.

curl -X POST "$BUILDER_URL/push" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tag": "myimage:latest"}'

GET /images

List locally built container images.

curl -H "Authorization: Bearer $API_TOKEN" "$BUILDER_URL/images"