MatterPak Upload

Create a map from a Matterport MatterPak by posting map metadata and Matterport credentials, with no file upload.

The VPS Map Creation API accepts a POST request to /v1/vps/map with a JSON payload containing map metadata and Matterport authentication.

To also get a navigable 360° Virtual Tour from the panoramas in the space, add assets to source.metadata:

"metadata": {
  "spaceId": "abc123",
  "oauthToken": "…",
  "assets": ["pano"]
}

The tour is opt-in, and assets is read once, when the map is created. It cannot be added to an existing map. See Optional assets.

Create Map from MatterPak

post

Authorizations

AuthorizationstringRequired

JWT token obtained from the authentication endpoint.

Body

mapNamestringRequiredExample: Showroom

headingnumber · max: 360Optional

Responses

201

Map created; MatterPak processing started.

application/json

messagestringOptional

mapIdstringOptional

statusstring · enumOptionalPossible values:

mapNamestringOptional

estimatedProcessingTimestringOptional

400

Bad Request.

application/json

401

Unauthorized.

application/json

403

Forbidden.

application/json

500

Internal Server Error.

application/json

post/vps/map

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

{
  "mapName": "Showroom",
  "heading": 1,
  "coordinates": {
    "latitude": 12.997,
    "longitude": 77.7679,
    "altitude": 0
  },
  "source": {
    "provider": "matterport",
    "fileType": "matterpak",
    "coordinateSystem": "RHS",
    "processType": "cloud",
    "metadata": {
      "spaceId": "text",
      "oauthToken": "text",
      "clientId": "text",
      "clientSecret": "text",
      "assets": [
        "pano"
      ]
    }
  }
}

{
  "message": "text",
  "mapId": "text",
  "status": "processing",
  "mapName": "text",
  "estimatedProcessingTime": "text"
}