Skip to main content
PUT
JavaScript

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

deviceSetId
string
required

The preview set to replace.

Body

application/json

Request body for creating or replacing a device set. A full replace, not a patch — both fields are always written.

name
string
required

Human-readable name.

device_ids
string[]
required

The devices the set contains, by PreviewDevice.id. At least one is required.

Response

A named, reusable list of preview devices.

id
string
required

Unique identifier for the device set.

name
string
required

Human-readable name.

device_ids
string[]
required

The devices in this set, by PreviewDevice.id.

created_at
string
required

ISO-8601 timestamp of when the set was created.

updated_at
string
required

ISO-8601 timestamp of when the set was last written.

archived_at
string

ISO-8601 timestamp of when the set was archived. Present only on the archive response, which is the one place the state is observable.