SMsmartthings
SmartApps

Update an App's OAuth Settings

Changed on

Update an app's oauth settings.

put/smartapps/{appNameOrId}/oauth

Request

Path parameters

appNameOrIdstring required

The appName or appId field of an app.

Headers

Authorizationstring string required

OAuth token

Request body

clientNamestring required

A name given to the OAuth Client.

scopestring[] required

A list of SmartThings API OAuth scope identifiers that may be required to execute your integration.

redirectUrisstring[] required

A list of redirect URIs for API_ONLY apps.

corsDomainsstring[]

A list of CORS domains.

Example request

{
  "clientName": "My SmartThings Integration",
  "scope": [
    "r:installedapps",
    "w:installedapps"
  ],
  "redirectUris": [
    "https://myapp.com/oauth/callback",
    "https://myapp.com/oauthin/callback"
  ],
  "corsDomains": [
    "https://myapp.com"
  ]
}

Response

An app's oauth settings model.

clientNamestring

A name given to the OAuth Client.

scopestring[]

A list of SmartThings API OAuth scope identifiers that may be required to execute your integration.

redirectUrisstring[]

A list of redirect URIs for API_ONLY apps.

corsDomainsstring[]

A list of CORS domains.

Example response

{
  "clientName": "My SmartThings Integration",
  "scope": [
    "r:installedapps",
    "w:installedapps",
    "x:installedapps"
  ],
  "redirectUris": [
    "https://myapp.com/oauth/callback",
    "https://myapp.com/oauthin/callback"
  ],
  "corsDomains": [
    "https://myapp.com"
  ]
}

Changes