Models

Create Model

POST /v1/models

{
  "source": "manual",
  "name": "Hex Key Holder",
  "designer": "Your Brand",
  "images": [],
  "sourceUrl": "https://example.com/model",
  "sourceId": "ext-123",
  "metadata": { "tags": ["storage"] }
}

Upload Model Files

POST /v1/models/{modelId}/files (multipart)

• Accepts files with content types like application/octet-stream, model/3mf, application/gcode.
• Server mirrors frontend naming logic: sanitizes filenames and appends -vX.Y, stores at {orgId}/{modelId}/{finalFileName}/{finalFileName}.

curl -X POST \
  -H "x-api-key: <KEY>" \
  -F "file=@part.gcode.3mf" \
  https://api.hiv3d.com/v1/models/UUID/files