List an Installed App's Configurations

List all configurations potentially filtered by status for an installed app.

get/installedapps/{installedAppId}/configs

Request

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

Path parameters

installedAppIdstring ^(?:([0-9a-fA-F]{32})|([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$ required

The ID of the installed application.

Query parameters

configurationStatus'STAGED' | 'DONE' | 'AUTHORIZED' | 'REVOKED'

Filter for configuration status.

Headers

Authorizationstring string required

OAuth token

Response

A paginated list of install configuration.

Example response

{
  "items": [
    {
      "installedAppId": "8885b9c3-a50d-427e-ad07-d7a2f94421af",
      "configurationId": "c71b0a5b-7dab-41fe-b75f-7cf30246468e",
      "configurationStatus": "DONE",
      "createdDate": "2017-05-19T12:39:37Z",
      "lastUpdatedDate": "2017-05-19T12:39:37Z"
    }
  ],
  "_links": {
    "next": {
      "href": "https://..."
    },
    "previous": {
      "href": "https://..."
    }
  }
}

Changes

No recorded changes to this operation across all 8 revisions of this API.