Save an Installed App Schedule

Create a schedule for an installed app. The installed app must be in the location specified and the installed app must have permission to create schedules.

post/installedapps/{installedAppId}/schedules

Request

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

Request body

namestring ^[A-Za-z0-9._\-]{1,36}$ required

The unique per installed app name of the schedule.

Example request

{
  "name": "test_schedule_1",
  "cron": {
    "expression": "15 10 * * ? *",
    "timezone": "GMT"
  }
}

Response

The created schedule.

namestring ^[A-Za-z0-9._\-]{1,36}$ required

The unique per installed app name of the schedule.

installedAppIdstring uuid

The ID of the installed app.

locationIdstring uuid

The ID of the location the installed app is in.

userUuidstring uuid

The UUID of the user who created the schedule.

scheduledExecutionsinteger[]

List of scheduled execution times in millis from jan 1 1970 UTC

Example response

{
  "name": "test_schedule_1",
  "installedAppId": "736e3903-001c-4d40-b408-ff40d162a06b",
  "scheduledExecutions": [
    1490892856362
  ],
  "cron": {
    "expression": "15 10 * * ? *",
    "timezone": "GMT"
  }
}

Changes

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