Get Device Log Requests
GET/devices/{deviceId}/logRequests
Base URL: https://api.tinkermode.com
Get log requests made to a device.
Authentication
Send an Authorization header of the form ModeCloud <AUTH_CODE>.
Must contain a user or service account who has read access to the device, or project API key.
Path parameters
| Name | Type | Required | Constraints | Description |
|---|---|---|---|---|
deviceId | integer | Yes | Device ID |
Query parameters
| Name | Type | Required | Constraints | Description |
|---|---|---|---|---|
limit | integer | No | Limits the number of entries returned. | |
skip | integer | No | Limits the number of entries to paginate. | |
sortBy | string | No | A comma-delimited list of sort keys. (e.g. "field1:asc,field2:desc") ts and status are valid fields. The default sort order is ascending. | |
statuses | string | No | The value must be delimited by comma. Returns entries bound by this status. |
Responses
200
Content type: application/json
Represents a request to a device for uploading its logs.
An array of objects with the following shape:
| Property | Type | Required | Constraints | Description |
|---|---|---|---|---|
contentType | string | No | MIME type of file uploaded for this request. | |
deviceId | integer | No | ID of device associated with log request. | |
filename | string | No | Filename of uploaded device log. | |
id | string | No | Unique ID of log request | |
projectId | integer | No | ID of project associated with log request. | |
status | unknown | No | one of: success, failure, requested, uploading, cancelled | Status of log request. |
token | string | No | Request token sent to device. | |
ts | string | No | format: date-time | Creation timestamp of log request. |
uploadId | string | No | Unique ID assigned to an upload session. | |
url | string | No | URL for downloading the stored device log. |
401 Authorization is required to access this resource.
Content type: application/json
| Property | Type | Required | Constraints | Description |
|---|---|---|---|---|
data | object | No | read-only (server-generated) | Any relevant data related to error. |
reason | string | Yes | read-only (server-generated) | Reason of error. |
403 Request failed because of denied permission.
Content type: application/json
| Property | Type | Required | Constraints | Description |
|---|---|---|---|---|
data | object | No | read-only (server-generated) | Any relevant data related to error. |
reason | string | Yes | read-only (server-generated) | Reason of error. |
429 Request failed because of rate limit.
Content type: application/json
| Property | Type | Required | Constraints | Description |
|---|---|---|---|---|
data | object | No | read-only (server-generated) | Any relevant data related to error. |
reason | string | Yes | read-only (server-generated) | Reason of error. |
500 An unexpected error has occurred.
Content type: application/json
| Property | Type | Required | Constraints | Description |
|---|---|---|---|---|
data | object | No | read-only (server-generated) | Any relevant data related to error. |
reason | string | Yes | read-only (server-generated) | Reason of error. |
503 The service is temporarily unavailable.
Content type: application/json
| Property | Type | Required | Constraints | Description |
|---|---|---|---|---|
data | object | No | read-only (server-generated) | Any relevant data related to error. |
reason | string | Yes | read-only (server-generated) | Reason of error. |