Update 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.

• Request Parameters

• Response

Updates an existing space.

JavaScript

Updates an existing space.

Code:

await seam.spaces.update({
  space_id: "d3513c20-dc89-4e19-8713-1c3ab01aec81",
  name: "My Updated Space",
});

Output:

{
  "created_at": "2025-06-16T16:54:17.946600Z",
  "display_name": "My Updated Space",
  "name": "My Updated Space",
  "space_id": "5f30970d-6ef5-4618-9e91-e701fbca6b63",
  "workspace_id": "96bd12f9-6def-4bf4-b517-760417451ae9"
}

cURL

Updates an existing space.

Code:

curl --include --request POST "https://connect.getseam.com/spaces/update" \
  --header "Authorization: Bearer $SEAM_API_KEY" \
  --json @- <<EOF
{
  "space_id": "d3513c20-dc89-4e19-8713-1c3ab01aec81",
  "name": "My Updated Space"
}
EOF

Output:

{
  "space": {
    "created_at": "2025-06-16T16:54:17.946600Z",
    "display_name": "My Updated Space",
    "name": "My Updated Space",
    "space_id": "5f30970d-6ef5-4618-9e91-e701fbca6b63",
    "workspace_id": "96bd12f9-6def-4bf4-b517-760417451ae9"
  }
}

Python

Updates an existing space.

Code:

seam.spaces.update(
    space_id="d3513c20-dc89-4e19-8713-1c3ab01aec81", name="My Updated Space"
)

Output:

Space(
    created_at="2025-06-16T16:54:17.946600Z",
    display_name="My Updated Space",
    name="My Updated Space",
    space_id="5f30970d-6ef5-4618-9e91-e701fbca6b63",
    workspace_id="96bd12f9-6def-4bf4-b517-760417451ae9",
)

Ruby

Updates an existing space.

Code:

seam.spaces.update(space_id: "d3513c20-dc89-4e19-8713-1c3ab01aec81", name: "My Updated Space")

Output:

{
  "created_at" => "2025-06-16T16:54:17.946600Z",
  "display_name" => "My Updated Space",
  "name" => "My Updated Space",
  "space_id" => "5f30970d-6ef5-4618-9e91-e701fbca6b63",
  "workspace_id" => "96bd12f9-6def-4bf4-b517-760417451ae9",
}

PHP

Updates an existing space.

Code:

$seam->spaces->update(
    space_id: "d3513c20-dc89-4e19-8713-1c3ab01aec81",
    name: "My Updated Space"
);

Output:

[
    "created_at" => "2025-06-16T16:54:17.946600Z",
    "display_name" => "My Updated Space",
    "name" => "My Updated Space",
    "space_id" => "5f30970d-6ef5-4618-9e91-e701fbca6b63",
    "workspace_id" => "96bd12f9-6def-4bf4-b517-760417451ae9",
];

Seam CLI

Updates an existing space.

Code:

seam spaces update --space_id "d3513c20-dc89-4e19-8713-1c3ab01aec81" --name "My Updated Space"

Output:

{
  "created_at": "2025-06-16T16:54:17.946600Z",
  "display_name": "My Updated Space",
  "name": "My Updated Space",
  "space_id": "5f30970d-6ef5-4618-9e91-e701fbca6b63",
  "workspace_id": "96bd12f9-6def-4bf4-b517-760417451ae9"
}

Authentication Methods

• API key

• Client session token

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

To learn more, see Authentication.

Request Parameters

acs_entrance_ids Array of UUIDs

IDs of the entrances that you want to set for the space. If specified, this will replace all existing entrances.

---

device_ids Array of UUIDs

IDs of the devices that you want to set for the space. If specified, this will replace all existing devices.

---

name String

Name of the space.

---

space_id String

ID of the space that you want to update.

---

space_key String

Unique key of the space that you want to update.

---

Response

space

JSON

{
  "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"
}