Comment on page
Workspaces
Workspaces are the top-level resource in the Seam ecosystem. They encapsulate all other resources, such as devices, events, and connected third-party accounts.
There is no limit to the number of workspaces that you can create, but most Seam customers only have the following two workspaces:
Production workspaces enable you to connect and control real devices from brands, such as August, Schlage, Brivo, Nest, and more.
- 1.
- 2.Click + Add Workspace.
- 3.In the Add a Workspace dialog, type a name for your new workspace and your company name.
- 4.Disable Sandbox mode.
- 5.Click Create Workspace.
You can use either of the following two ways to connect devices to a production workspace:
- 1.
- 2.In the upper-right corner of the Devices page, click + Add Device. The Seam Console displays a Connect Webview (that is, an authorization flow) that enables you to connect a device account to Seam.
- 3.In the Connect Webview, click Continue.
- 4.In the manufacturer list, select the manufacturer of the devices that you want to connect.
- 5.Follow the login instructions to authorize these devices.
Once authorized, the devices associated with this test account appear in the Devices table in your production workspace.
If you are creating an application (app) to control your users' devices, use Connect Webviews. Connect Webviews are fully-embedded client-side components that you add to your app. Your users interact with your embedded Connect Webviews to link their device accounts to Seam through your app. Seam handles all the authentication steps. Once your user has completed the authorization through your app, your users' devices are linked with your production workspace, and you can access and control their devices using the Seam API.
Most Seam customers use a single production workspace to connect all their devices, regardless of whether these devices are ones that they own or they are controlling thousands of end customers' devices. For example, a property management app with thousands of customers could still use a single production workspace to connect all customers' devices.
Some Seam customers may be developing multiple apps, each of which needs to interact with devices. In this type of scenario, it may be useful to set up a different production workspace for each application.
For example, an information technology (IT) firm that builds custom apps for its customers will most likely want to create a separate workspace for each customer. This model can simplify security, support, and billing.
Occasionally, an app may also be using multiple Seam workspaces. For example, a restaurant chain providing a management dashboard for its franchisees may want to use a different Seam workspace for each franchisee to simplify billing and support. See App 3 in the following diagram:
Sandbox workspaces are a special type of workspace designed for testing code. Sandbox workspaces offer test device accounts and virtual devices that you can connect and control. This ability to work with virtual devices is quite handy because it removes the need to own physical devices from multiple brands.
Importantly, virtual devices behave identically to the corresponding real devices. That is, if your app works with a virtual device in a sandbox workspace, it will also work with a real device in a production workspace.
You can only connect virtual devices in a sandbox workspace. To connect a real device, switch to a production workspace.
To connect virtual devices, specify the login credentials for test device accounts in the Seam Console or in Connect Webviews within you apps. All manufacturers and devices that Seam supports have one or more sandbox test accounts with pre-seeded devices. For login credentials for all test device accounts, see the Sandbox & Sample Data section.
You can trigger test events for some virtual devices. This capability is useful for testing code that depends on receiving event notifications from the Seam API. For example, virtual noise sensor devices, such as Minut, provide the ability to trigger a "noise event" that emits an event to your webhook endpoint. Once you have triggered an event, you can view this even on the Events tab for the virtual device.
- 1.
- 2.In the Devices table, click the device with which you want to interact.
- 3.Click the Actions tab. The Actions tab lists the actions that you can perform on this virtual device.
- 4.Click the desired action, as applicable for that action. For example:
- For a virtual door lock, click the Locked toggle to lock or unlock the lock.
- For a virtual thermostat, click Edit and then modify a climate setting.
- For a virtual noise sensor, click Trigger to trigger a noise threshold alert.
- 5.Click the Events tab for the device. The Events tab displays the event.
Sandbox workspace are unique in that you can reset them to the original starting state. For example, if you need to run complex continuous integration (CI) testing for an app, you can reset the sandbox workspace after each individual test run.
You can reset a sandbox workspace either manually through the Seam Console or programmatically using the Seam API. For detailed information about resetting a sandbox workspace through the Seam API, see the Reset Workspace API reference.
- 1.
- 2.Select the name of the sandbox workspace that you want to reset. The Seam Console switches to the selected sandbox workspace.
- 3.
- 4.In the workspace list, below the name of the selected sandbox workspace, click Reset.
JavaScript
Python
Ruby
PHP
// Reset the sandbox workspace associated with your API key.
await seam.workspaces.resetSandbox()
# Reset the sandbox workspace associated with your API key.
seam.workspaces.reset_sandbox()
# Reset the sandbox workspace associated with your API key.
seam.workspaces.reset_sandbox
// Reset the sandbox workspace associated with your API key.
$seam->workspaces->reset_sandbox();
You can add teammates to your workspace.
- 1.
- 2.Click the workspace that you want to share.
- 3.In the left navigation pane, click Team.
- 4.In the upper-right corner of the Team page, click + Add member.
- 5.In the Add Organization Member dialog, type the email address of the teammate that you want to add to this workspace.
- 6.Click Add to Team.
The Seam Console sends an email invitation to the specified teammate.
Last modified 26d ago