{"_id":"5b4644eb8f31a5000308f918","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":33,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255","59f76fef8581dc0010593e6f","5a0c003680a35b0012c35db0","5a8358722e78660075e45f42","5a846645b5ec3a001203517e","5b258091bc7a6700033b9cb5","5b26e48e024807000315a740","5b44edff3306680003663f5c","5b468abd3d4a9e0003789111","5b468d8f3dcb6a0003c6e374","5b47b0b93d4a9e000378a33a","5b538d114ea24f00033c726f","5b6a0efe402b32000336c33f","5bba5e5d7ba7710003bd902a","5bc2703349ac3a0013eec3e5"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"59f76fef8581dc0010593e6f","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-10-30T18:31:11.732Z","from_sync":false,"order":17,"slug":"conduits-api","title":"Conduits API"},"user":"5a6a26281895510045b2cd40","githubsync":"","__v":10,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-07-11T17:56:59.207Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"language":"json","code":"{\n    \"items\": [\n        {\n            \"localId\": \"218151977773\",\n            \"customName\": \"Droplit EMS\",\n            \"localData\": {\n              \"redacted for brevity\" : true\n            },\n            \"isProvisioned\": false,\n            \"environments\": []\n        }\n    ]\n}","name":"With 'expand'"},{"status":200,"language":"json","code":"{\n    \"items\": [\n        {\n            \"localId\": \"211152974770\",\n            \"customName\": \"Droplit EMS\",\n            \"isProvisioned\": false,\n            \"environments\": []\n        }\n    ]\n}","name":"Without 'expand'"},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"path\",\n            \"path\": \"id\",\n            \"message\": \"invalid id\"\n        }\n    ]\n}","language":"json","name":"Conduit Invalid","status":400},{"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"path\",\n            \"path\": \"activationId\",\n            \"message\": \"invalid activation id\"\n        }\n    ]\n}","language":"json","name":"Activation Invalid","status":400},{"status":400,"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"query\",\n            \"path\": \"#\",\n            \"message\": \"property query is used for a schema that does not allow additional properties\"\n        }\n    ]\n}","language":"json","name":"Query Parameter Invalid"},{"status":400,"code":"{\n    \"errorType\": \"InvalidParams\",\n    \"errors\": [\n        {\n            \"in\": \"query\",\n            \"path\": \"expand/0\",\n            \"message\": \"value 'invalid' is not defined in enum\"\n        }\n    ]\n}","language":"json","name":"'expand' Value Invalid"},{"status":404,"code":"Conduit with id 5b953b5d9f3a047a92805282 does not exist.","language":"text","name":"Conduit Not Found"},{"status":404,"code":"Conduit Activation with id 5b953b7f8c21b8895af74771 does not exist.","language":"text","name":"Activation Not Found"}]},"settings":"59f773da3624640026dc9e8e","examples":{"codes":[{"code":"GET https://ioe.droplit.io/api/conduits/5b953e5d3f3a049a9380828b/conduit-activations/5b953b7f7c24b8a959f77773/local-devices?pageSize=100&expand=LocalData HTTP/1.1\nauthorization: AUTH_TOKEN","language":"http","name":"With 'expand'"},{"code":"GET https://dev-ioe.droplit.io/api/conduits/5b953e5d3f3a049a9380828b/conduit-activations/5b953b7f7c24b8a959f77773/local-devices?pageSize=100 HTTP/1.1\nauthorization: AUTH_TOKEN","language":"http","name":"Without 'expand'"}]},"method":"get","auth":"required","params":[{"_id":"5b464e2e3dcb6a0003c6dcbf","ref":"","in":"path","required":true,"desc":"The ID of the conduit.","default":"","type":"string","name":"id"},{"_id":"5b464e2e3dcb6a0003c6dcbe","ref":"","in":"path","required":true,"desc":"The ID of the conduit activation whose devices are to be listed.","default":"","type":"string","name":"activationId"},{"_id":"5b464e2e3dcb6a0003c6dcbd","ref":"","in":"query","required":false,"desc":"The number of devices to be returned per request. The minimum is 1, and the maximum is 1000.","default":"1000","type":"int","name":"pageSize"},{"_id":"5b464e2e3dcb6a0003c6dcbc","ref":"","in":"query","required":false,"desc":"Used in a subsequent request to obtain the next page of devices. See [Pagination](doc:pagination) for more details.","default":"","type":"string","name":"continuationToken"},{"_id":"5b46574a82b06a000332bb7f","ref":"","in":"query","required":false,"desc":"If set to `LocalData`, will display each device's plethora of local data.","default":"","type":"string","name":"expand"},{"_id":"5b46585b82b06a000332bb95","ref":"","in":"header","required":true,"desc":"The user's authorization token.","default":"","type":"string","name":"authorization"}],"url":"/:id/conduit-activations/:activationId/local-devices"},"isReference":false,"order":11,"body":"","excerpt":"Get all of the local devices operating through a conduit activation.","slug":"list-local-devices","type":"endpoint","title":"List local devices."}

getList local devices.

Get all of the local devices operating through a conduit activation.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
string
The ID of the conduit.
activationId:
required
string
The ID of the conduit activation whose devices are to be listed.

Query Params

pageSize:
integer1000
The number of devices to be returned per request. The minimum is 1, and the maximum is 1000.
continuationToken:
string
Used in a subsequent request to obtain the next page of devices. See [Pagination](doc:pagination) for more details.
expand:
string
If set to `LocalData`, will display each device's plethora of local data.

Headers

authorization:
required
string
The user's authorization token.

Examples


Result Format


User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}