API Reference

Complete API documentation for developers.

REST Endpoints

GET /api/builds

Fetch public gallery builds.

GET /api/builds

Response:
{
  "builds": [
    {
      "id": "abc123",
      "name": "Cool Dog",
      "metadata": { ... },
      "blox": [ ... ]
    }
  ]
}

POST /api/builds

Publish a build to the gallery.

POST /api/builds
Content-Type: application/json

{
  "metadata": {
    "id": "abc123",
    "name": "My Build",
    "mass": 42,
    "uniqueColors": 5,
    "bw": 12.3
  },
  "blox": [ ... ]
}

Response:
{
  "success": true,
  "buildId": "abc123"
}

Server Actions

saveCreation

import { saveCreation } from "@/lib/actions/save-creation"

const result = await saveCreation(
  "My Build Name",
  bricksArray,
  walletAddress // optional
)

getCreations

import { getCreations } from "@/lib/actions/get-creations"

const creations = await getCreations(walletAddress)