Devices

List

get

Get a list of devices of a given team.

Authorizations

Query parameters

teamIdintegerrequiredExample: 1

assignedbooleanoptional

true = devices with scenarioId; false = devices without scenarioId - this filter only affects the trigger scope

Example: true

viewForScenarioIdintegeroptional

Devices assigned to the scenario and not assigned devices. If this parameter is set assigned parameter is ignored.

Example: 4

scope[]string · enum[]optionalExample: call

cols[]string · enum[]optionalExample: name

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/devices?teamId=1' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "devices": [
    {
      "id": 2,
      "name": "Phone",
      "teamId": 2,
      "udid": "XboVPMTfgtwBNjRr7AGPe9X4AdRZhkaF",
      "scope": [
        "call",
        "scaner"
      ],
      "info": null,
      "queueCount": 0,
      "queueLimit": 10000,
      "scenarioId": null
    }
  ]
}

Successful response

Detail

get

The ID can be id or udid.

Authorizations

Path parameters

deviceIdintegerrequired

Query parameters

inspectorintegeroptionalExample: 1

cols[]string · enum[]optionalExample: name

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://eu1.make.com/api/v2/devices/{deviceId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "device": {
    "id": 2,
    "name": "Phone",
    "teamId": 2,
    "udid": "XboVPMTfgtwBNjRr7AGPe9X4AdRZhkaF",
    "scope": [
      "call",
      "scaner"
    ],
    "info": null,
    "queueCount": 0,
    "queueLimit": 10000,
    "scenarioId": null
  }
}

Successful response

Delete

delete

Errors: IM004 - Confirmation required (error with metadata) - needs confirmation IM405 - Device can't be deleted because it contains messages in queue (error with metadata) - needs confirmation IM005 - Device is locked by a running scenario and thus can't be deleted

Authorizations

Path parameters

deviceIdstringrequiredExample: 2

Query parameters

confirmedbooleanoptionalExample: true

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://eu1.make.com/api/v2/devices/{deviceId}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "device": 2
}

Successful response

Partial update

patch

Update a device

Authorizations

Path parameters

deviceIdstringrequired

Query parameters

cols[]string · enum[]optionalExample: name

Body

objectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PATCH \
  --url 'https://eu1.make.com/api/v2/devices/{deviceId}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Android phone"
  }'

200

200

{
  "device": {
    "id": 2,
    "name": "Android phone",
    "teamId": 2,
    "udid": "XboVPMTfgtwBNjRr7AGPe9X4AdRZhkaF",
    "scope": [
      "call",
      "scaner"
    ],
    "info": null,
    "queueCount": 0,
    "queueLimit": 10000,
    "scenarioId": null
  }
}

Successful response

Create request

post

Required scope: devices:write

Authorizations

Query parameters

inspectorintegeroptionalExample: 1

Body

namestringoptional

teamIdintegeroptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://eu1.make.com/api/v2/devices/request' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Phone",
    "teamId": 1
  }'

200

200

{
  "createDeviceRequest": {
    "udid": "k1KqeAVIYA5Rq5vduiU3mUfbGD4vhTfH",
    "inspector": true
  }
}

Successful response