SMsmartthings
SmartApps

List All Apps

Changed on

List all apps configured in an account.

get/smartapps

Request

Query parameters

appType'LAMBDA_SMART_APP' | 'WEBHOOK_SMART_APP'

The App Type of the application.

classification'AUTOMATION' | 'SERVICE' | 'DEVICE' | 'CONNECTED_SERVICE'

An App maybe associated to many classifications. A classification drives how the integration is presented to the user in the SmartThings mobile clients. These classifications include:

  • AUTOMATION - Denotes an integration that should display under the "Automation" tab in mobile clients.
  • SERVICE - Denotes an integration that is classified as a "Service".
  • DEVICE - Denotes an integration that should display under the "Device" tab in mobile clients.
  • CONNECTED_SERVICE - Denotes an integration that should display under the "Connected Services" menu in mobile clients.
tagstring ^[a-zA-Z_]{1,64}$

May be used to filter a resource by its assigned user-tags. Multiple tag query params are automatically joined with OR.

Example usage in query string:

?tag:key_name=value1&tag:key_name=value2
accountIdstring uuid

List apps belonging to a specific account rather than the default account associated with the user calling the API. Note that the user must have appropriate permissions to view apps for the specified account.

Headers

Authorizationstring string required

OAuth token

Response

A paginated list of apps.

Example response

{
  "items": [
    {
      "appName": "security-home-monitor",
      "appId": "c71b0a5b-7dab-41fe-b75f-7cf30246468e",
      "appType": "WEBHOOK_SMART_APP",
      "displayName": "Security Home Monitor",
      "description": "An intergration that leverages all security devices in your home - cameras, motion sensors, etc to provide\nyou with peace of mind and #security.\n",
      "iconImage": {
        "url": "https://smart-home-monitor.com/image"
      },
      "owner": {
        "ownerType": "USER",
        "ownerId": "3f178632-79ed-4358-94de-280dbd7c206c"
      },
      "createdDate": "2017-05-19T12:39:37Z",
      "lastUpdatedDate": "2017-05-19T12:39:37Z"
    }
  ],
  "_links": {
    "next": {
      "href": "https://..."
    },
    "previous": {
      "href": "https://..."
    }
  }
}

Changes