Create a Space

Early Access Preview. The spaces API is currently in Alpha. We're actively developing it and seeking early feedback at [email protected]. Expect breaking changes as we refine the design.

Creates a new space.

Creates a new space.

Code

await seam.spaces.create({
  name: "My Space",
  device_ids: ["b7254403-db91-4e10-bb7b-31d0615d2963"],
  acs_entrance_ids: ["46a47667-a90b-45cc-9bb6-f0917464f1f3"],
});

Output

{
  "created_at": "2025-06-16T16:54:17.946600Z",
  "display_name": "My Space",
  "name": "My Space",
  "space_id": "5afeb047-3277-4102-b8c4-99edf05b91d2",
  "workspace_id": "96bd12f9-6def-4bf4-b517-760417451ae9"
}
Authentication Methods
  • API key

  • Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

Request Parameters

name String (Required)

Name of the space that you want to create.


acs_entrance_ids Array of UUIDs

IDs of the entrances that you want to add to the new space.


device_ids Array of UUIDs

IDs of the devices that you want to add to the new space.


Response

space

{
  "created_at": "2025-06-16T16:54:17.946600Z",
  "display_name": "My Space",
  "name": "My Space",
  "space_id": "5afeb047-3277-4102-b8c4-99edf05b91d2",
  "workspace_id": "96bd12f9-6def-4bf4-b517-760417451ae9"
}

Last updated

Was this helpful?