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

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/devices HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

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

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

objectOptional

get

HTTPcURLJavaScriptPython

GET /api/v2/devices/{deviceId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

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

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

objectOptional

delete

HTTPcURLJavaScriptPython

DELETE /api/v2/devices/{deviceId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful response

{
  "device": 2
}

Partial update

patch

Update a device

Authorizations

Path parameters

deviceIdstringRequired

Query parameters

cols[]string · enum[]OptionalExample: name

Body

objectOptional

Responses

application/json

objectOptional

patch

HTTPcURLJavaScriptPython

PATCH /api/v2/devices/{deviceId} HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "name": "Android phone"
}

200

Successful response

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

Create request

post

Required scope: devices:write

Authorizations

Query parameters

inspectorintegerOptionalExample: 1

Body

namestringOptional

teamIdintegerOptional

Responses

application/json

objectOptional

post

HTTPcURLJavaScriptPython

POST /api/v2/devices/request HTTP/1.1
Host: eu1.make.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "name": "Phone",
  "teamId": 1
}

200

Successful response

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