Get Template Build Status

GET /v1/templates/build/{build_id}/status

Authorization: Bearer your_api_key_here

{
  "build_id": "489",
  "template_id": "489",
  "status": "building",
  "progress": 75,
  "current_step": "Creating memory snapshot",
  "started_at": "2025-11-05T22:00:03Z",
  "completed_at": null,
  "error_message": null
}

import requests
import time

def wait_for_build(build_id, api_key, timeout=3600):
    """Poll build status until complete"""
    start_time = time.time()
    
    while True:
        response = requests.get(
            f"https://api.hopx.dev/v1/templates/build/{build_id}/status",
            headers={"Authorization": f"Bearer {api_key}"}
        )
        status = response.json()
        
        if status['status'] == 'active':
            print("✅ Build complete!")
            return status
        elif status['status'] == 'failed':
            raise Exception(f"Build failed: {status.get('error_message')}")
        
        # Check timeout
        if time.time() - start_time > timeout:
            raise TimeoutError("Build timeout")
        
        # Poll every 5 seconds
        print(f"Building... {status['progress']}% - {status['current_step']}")
        time.sleep(5)

# Usage
status = wait_for_build("489", api_key)
print(f"Template ID: {status['template_id']}")

{
  "error": "Build not found",
  "message": "Build ID '489' does not exist"
}

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}