Presentations

Get a Device Configuration

Retrieve a device configuration.

Note: This API functionality is in BETA

get/presentation/deviceconfig

Request

Base URL
https://api.smartthings.com/v1
Auth
OAuth 2
Implicithttps://auth-global.api.smartthings.com
Scopesr:deviceprofiles, mobile
TypeScript
https://skmtc.dev/smartthings/apis/smartthings-api/docs/presentation/deviceconfig/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

presentationIdstring required

System generated identifier that corresponds to a device presentation (formerly vid)

manufacturerNamestring

Secondary namespacing key for grouping presentations (formerly mnmn)

Response

The device configuration

mnmnstring required

The name of the manufacturer

vidstring required

A unique identifier for the presentation of a device. This can be a model number on legacy device integrations, but also may be a system generated UUID based on a device's structure and display configuration.

versionstring

The version of the device configuration.

descriptionstring

To provide the explanation of the device configuration/presentation’s purpose or content.

type'dth' | 'profile'

iconUrlstring

DEPRECATED: Please use iconUrl under icons property.

presentationIdstring