Object Upload

To create a new Object for tracking using the upload API, make a POST request to /v1/vps/object with your authentication token, providing the object name, tracking type (full for 360-degree tracking or side for side-view only), and source details including the file type (glb or gltf), provider (web), and coordinate system (RHS for right-handed or LHS for left-handed).

The API will respond with a pre-signed S3 upload URL, unique object ID, and object code. Use the returned uploadUrl to upload your 3D model file directly to S3 via a PUT request with Content-Type: application/octet-stream. Once uploaded, the system will automatically process the model for Object tracking.

Create a new ModelSet object

post

Creates a new ModelSet object and returns a pre-signed URL for uploading the 3D model file. The model file should be uploaded to the returned uploadUrl using a PUT request.

Workflow:

1. Call this endpoint to create the object and get an upload URL

2. Upload the model file (.glb or .gltf) to the uploadUrl using PUT request with Content-Type: application/octet-stream

3. The system will process the uploaded file for VPS tracking

Authorizations

BearerAuth

AuthorizationstringRequired

JWT token obtained from authentication

Body

application/json

objectNamestring · min: 1 · max: 255Required

Name of the ModelSet object

Example: Product Demo Model

trackingTypestring · enumRequired

Type of tracking to be performed:

• full: 360-degree tracking (all angles)
• side: Side-view tracking only

Example: fullPossible values:

Responses

200

ModelSet object created successfully

application/json

messagestringRequired

Success message

Example: Object created successfully

objectCodestringRequired

Unique code for the object

Example: OBJ_1234567890

objectIdstringRequired

Unique identifier for the object

Example: 65f1234567890abcdef12345

uploadUrlstring · uriRequired

Pre-signed S3 URL for uploading the 3D model file. Use PUT request to upload the file to this URL.

Example: https://s3.amazonaws.com/multiset-objects/65f1234567890abcdef12345.glb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...

400

Bad request - Invalid parameters

application/json

401

Unauthorized - Invalid or missing authentication token

application/json

500

Internal server error

application/json

post

/v1/vps/object

HTTPcURLJavaScriptPython

POST /v1/vps/object HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 127

{
  "objectName": "Product Demo Model",
  "trackingType": "full",
  "source": {
    "provider": "web",
    "fileType": "glb",
    "coordinateSystem": "RHS"
  }
}

Create ModelSet with GLB fileCreate ModelSet with GLTF file

{
  "message": "Object created successfully",
  "objectCode": "OBJ_1234567890",
  "objectId": "65f1234567890abcdef12345",
  "uploadUrl": "https://s3.amazonaws.com/multiset-objects/65f1234567890abcdef12345.glb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=..."
}