Invalid terminal ID in the request
POST {{baseUrl}}/terminals/scheduleActions
Schedules a terminal action by specifying the action and the terminals that the action must be applied to. The following restrictions apply: * You can schedule only one action at a time. For example, to install a new app version and remove an old app version, you have to make two API requests. * The maximum number of terminals in a request is 100. For example, to apply an action to 250 terminals, you have to divide the terminals over three API requests. * If there is an error with one or more terminal IDs in the request, the action is scheduled for none of the terminals. You need to fix the error and try again. To make this request, your API credential must have the following role: * Management API—Terminal actions read and write
Request Body
{"terminalIds"=>["S1E-000150183300032", "S1E-000150183300033", "S1F2-000150183300034"], "storeId"=>"", "scheduledAt"=>"2021-12-11T20:21:22-0100", "actionDetails"=>{"type"=>"InstallAndroidApp", "appId"=>"ANDA422LZ223223K5F694GCCF621J7"}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"actionDetails":{"certificateId":"ANDC422LZ223223K5F78NVN9SL4VPH","type":"UninstallAndroidCertificate"},"scheduledAt":"2021-12-12T20:21:22-0100","storeId":"","items":[{"id":"TRAC422T2223223K5GFMQHM6WQ4KB6","terminalId":"S1E-000150183300032"},{"id":"TRAC4224X22338VQ5GD4CQJCQT5PC2","terminalId":"S1E-000150183300033"},{"id":"TRAC4224Z223223K5GD89RLBWQ6CWT","terminalId":"S1F2-000150183300034"}],"terminalsWithErrors":{},"totalScheduled":3,"totalErrors":0}