MapSet

MapSet APIs allow you to create and manage collections of maps with relative positioning for large-scale VPS coverage.

To whitelist your domain, follow: Configuring Allowed Domains (CORS)

Overview

A MapSet is a collection of two or more maps positioned relative to each other. This enables:

• Large area coverage by combining multiple scans

• Seamless localization across connected spaces

• Flexible map arrangement and positioning

Using Codes Instead of IDs

All MapSet APIs use human-readable codes:

• MapSet Code (e.g., MSET_ZIRWP1NV0WBH) - Use this for all MapSet operations

• Map Code (e.g., MAP_WUTCLWDXTK6U) - Use this when adding maps to a MapSet

You can find these codes in the MultiSet Developer Portal or from API responses.

Endpoints

Create MapSet

Creates a new MapSet with two or more maps. Use Map Codes to reference the maps.

Create MapSet

post

Creates a new MapSet with two or more maps. Each map must include a relative pose defining its position and rotation within the MapSet.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Body

application/json

namestringRequired

Name of the MapSet

Example: Building A - Floor 1

Responses

201

MapSet created successfully

application/json

400

Bad Request - Invalid input or less than 2 maps provided

401

Unauthorized - Invalid or expired token

404

One or more maps not found

409

Conflict - One or more maps are already part of a MapSet

post

/map-set

HTTPcURLJavaScriptPython

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

{
  "name": "Building A - Floor 1",
  "maps": [
    {
      "mapCode": "MAP_WUTCLWDXTK6U",
      "relativePose": {
        "position": {
          "x": 0,
          "y": 0,
          "z": 0
        },
        "rotation": {
          "qx": 0,
          "qy": 0,
          "qz": 0,
          "qw": 1
        }
      }
    },
    {
      "mapCode": "MAP_7HXKP2MSNQ4Y",
      "relativePose": {
        "position": {
          "x": 10.5,
          "y": 0,
          "z": 5.2
        },
        "rotation": {
          "qx": 0,
          "qy": 0.7071,
          "qz": 0,
          "qw": 0.7071
        }
      }
    }
  ]
}

{
  "message": "MapSet created successfully",
  "mapSetCode": "MSET_ZIRWP1NV0WBH"
}

---

Get MapSet Details

Retrieves details of a MapSet including all associated maps and their relative poses. Use the MapSet Code (e.g., MSET_ZIRWP1NV0WBH).

Get MapSet Details

get

Retrieves details of a MapSet including all associated maps and their relative poses.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Path parameters

mapSetCodestringRequired

MapSet Code

Example: MSET_ZIRWP1NV0WBH

Responses

200

MapSet details retrieved successfully

application/json

401

Unauthorized - Invalid or expired token

404

MapSet not found

get

/map-set/{mapSetCode}

HTTPcURLJavaScriptPython

GET /v1/vps/map-set/{mapSetCode} HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "mapSet": {
    "name": "Building A - Floor 1",
    "mapSetCode": "MSET_ZIRWP1NV0WBH",
    "status": "active",
    "createdAt": "2026-02-26T17:40:50.668Z",
    "updatedAt": "2026-02-26T17:40:50.668Z",
    "mapSetData": [
      {
        "_id": "6756c20336a9794c6effce46",
        "order": 0,
        "relativePose": {
          "position": {
            "x": 0,
            "y": 0,
            "z": 0
          },
          "rotation": {
            "qx": 0,
            "qy": 0,
            "qz": 0,
            "qw": 1
          }
        },
        "map": {
          "mapCode": "MAP_WUTCLWDXTK6U",
          "mapName": "Lobby Area",
          "status": "active"
        }
      }
    ]
  }
}

---

Update MapSet Details

Updates the name of an existing MapSet. Use the MapSet Code.

Update MapSet Details

put

Updates the name of an existing MapSet.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Path parameters

mapSetCodestringRequired

MapSet Code

Example: MSET_ZIRWP1NV0WBH

Body

application/json

namestringRequired

New name for the MapSet

Example: Building A - Updated Name

Responses

200

MapSet updated successfully

application/json

401

Unauthorized - Invalid or expired token

404

MapSet not found

put

/map-set/details/{mapSetCode}

HTTPcURLJavaScriptPython

PUT /v1/vps/map-set/details/{mapSetCode} HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "Building A - Updated Name"
}

{
  "message": "MapSet updated successfully"
}

---

Add Map to MapSet

Adds a new map to an existing MapSet with its relative pose. Use the MapSet Code in the URL and Map Code in the request body.

Add Map to MapSet

put

Adds a new map to an existing MapSet with its relative pose.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Path parameters

mapSetCodestringRequired

MapSet Code

Example: MSET_ZIRWP1NV0WBH

Body

application/json

mapCodestringRequired

Map Code

Example: MAP_WUTCLWDXTK6U

Responses

200

Map added to MapSet successfully

application/json

401

Unauthorized - Invalid or expired token

404

MapSet or Map not found

put

/map-set/{mapSetCode}

HTTPcURLJavaScriptPython

PUT /v1/vps/map-set/{mapSetCode} HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "mapCode": "MAP_9RNVK3JTPL8X",
  "relativePose": {
    "position": {
      "x": 20,
      "y": 0,
      "z": 10
    },
    "rotation": {
      "qx": 0,
      "qy": 0,
      "qz": 0,
      "qw": 1
    }
  }
}

{
  "message": "MapSet data added successfully"
}

---

Update Map Pose in MapSet

Updates the relative pose of a map within a MapSet.

Use the dataId (MapSetData ID) from the Get MapSet Details response. This is the only operation that requires an internal ID.

Update Map Pose in MapSet

put

Updates the relative pose of a map within a MapSet. Use the dataId from the MapSet details response.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Path parameters

dataIdstringRequired

MapSetData ID (obtained from Get MapSet Details response)

Example: 6756c20336a9794c6effce46

Body

application/json

Responses

200

Map pose updated successfully

application/json

400

Invalid dataId format

401

Unauthorized - Invalid or expired token

404

MapSetData not found

put

/map-set/data/{dataId}

HTTPcURLJavaScriptPython

PUT /v1/vps/map-set/data/{dataId} HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "relativePose": {
    "position": {
      "x": 15,
      "y": 0,
      "z": 7.5
    },
    "rotation": {
      "qx": 0,
      "qy": 0,
      "qz": 0,
      "qw": 1
    }
  }
}

{
  "message": "MapSetData updated successfully"
}

---

Delete Map from MapSet

Removes a map from a MapSet.

Constraints:

• Cannot delete the primary map (order=0)

• Cannot delete if it would leave less than 2 maps in the MapSet

• Use the dataId from the Get MapSet Details response

Delete Map from MapSet

delete

Removes a map from a MapSet. Cannot delete the primary map (order=0) or if deletion would leave less than 2 maps in the MapSet.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Path parameters

dataIdstringRequired

MapSetData ID (obtained from Get MapSet Details response)

Example: 6756c20336a9794c6effce46

Responses

200

Map removed from MapSet successfully

application/json

400

Invalid dataId format

401

Unauthorized - Invalid or expired token

404

MapSetData not found

409

Cannot delete primary map or would leave less than 2 maps in MapSet

delete

/map-set/data/{dataId}

HTTPcURLJavaScriptPython

DELETE /v1/vps/map-set/data/{dataId} HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "MapSetData deleted successfully"
}

---

Delete MapSet

Deletes a MapSet and all associated map data entries. The maps themselves are not deleted, only their association with the MapSet. Use the MapSet Code.

Delete MapSet

delete

Deletes a MapSet and all associated map data entries. The maps themselves are not deleted, only their association with the MapSet.

Authorizations

bearerAuth

AuthorizationstringRequired

JWT token obtained from the authentication endpoint

Path parameters

mapSetCodestringRequired

MapSet Code

Example: MSET_ZIRWP1NV0WBH

Responses

200

MapSet deleted successfully

application/json

401

Unauthorized - Invalid or expired token

404

MapSet not found

delete

/map-set/{mapSetCode}

HTTPcURLJavaScriptPython

DELETE /v1/vps/map-set/{mapSetCode} HTTP/1.1
Host: api.multiset.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "MapSet and associated MapSetData deleted successfully"
}

Schemas

RelativePose

The relativePose object defines a map's position and orientation within the MapSet coordinate system:

Field	Type	Description
position.x	number	X position coordinate
position.y	number	Y position coordinate
position.z	number	Z position coordinate
rotation.qx	number	X component of quaternion rotation
rotation.qy	number	Y component of quaternion rotation
rotation.qz	number	Z component of quaternion rotation
rotation.qw	number	W component of quaternion rotation

The first map in a MapSet (order=0) typically uses identity pose: position (0,0,0) and rotation quaternion (0,0,0,1).