VoxBox API

Programmatic access to the VoxBox platform.

Base URL: https://voxbox.store

Authentication

{
  "username": "your_username_or_email",
  "password": "your_password"
}

{
  "accessToken": "your_access_jwt",
  "refreshToken": "your_refresh_jwt"
}

Note: Only the refresh token is used for authenticated requests.

Upload a new model (requires authentication).

Header	Value	Required	Details
Authorization	Bearer <Refresh JWT>	Yes	Used to authenticate requests
Content-Type	multipart/form-data	Yes	Required for file uploads

Field	Type	Required	Details
name	string	Yes	2–64 characters
description	string	Yes	Max 512 characters
category	enum	Yes	Character, Environment, Prop, Vegetation, Vehicle, Random, Weapon, Architecture
license	enum	Yes	CC-0, CC-BY, CC-BY-SA, CC-BY-ND, CC-BY-NC, CC-BY-NC-SA, CC-BY-NC-ND
animated	boolean (string)	Yes	"true" \| "false"
public	boolean (string)	Yes	"true" \| "false"
video	string	No	YouTube URL (optional)
vox	File	Yes	.vox model file
cover	File	Yes	Image file (thumbnail/preview)

{
  "id": "model_id",
  "status": "success"
}

Update an existing model (new version if .vox is provided).

Header	Value	Required	Details
Authorization	Bearer <Refresh JWT>	Yes	Used to authenticate requests
Content-Type	multipart/form-data	Yes	Required for file uploads

Field	Type	Required	Details
id	string	Yes	Model identifier
name	string	No	2–64 characters
description	string	No	Max 512 characters
category	enum	No	Character, Environment, Prop, Vegetation, Vehicle, Random, Weapon, Architecture
license	enum	No	CC-0, CC-BY, CC-BY-SA, CC-BY-ND, CC-BY-NC, CC-BY-NC-SA, CC-BY-NC-ND
animated	boolean (string)	No	"true" \| "false"
public	boolean (string)	No	"true" \| "false"
video	string	No	YouTube URL
vox	File	No	.vox model file (creates new version if provided)
cover	File	No	Image file (thumbnail/preview)