Download OpenAPI specification:Download
API for the Bagtower application
Creates all the resources for the company
object (CompanyLimitsDefinition) | |
paymentMethodAddedTs | integer Time when the payment method was added |
invoiceInformationTs | number Indicates if the company has given invoice information |
companyName required | string [ 1 .. 20 ] characters Name of the company |
description | string Description of the company |
deviceStarted | boolean Indicates if the created device has started |
ownerId | string userId of the owner of the company |
object (CompanySubscriptionStripeInformation) | |
deviceCreated | boolean Indicates if the first device has been created for the company |
object (CompanyInvoiceInformation) | |
hasInvoiceInformation | boolean Indicates if the company has given invoice information |
causes | Array of strings Configuration regarding causes of alert |
deviceStartedTs | number Timestamp where the created device has started |
object (CompanyPaymentInformation) | |
Array of objects (CompanyPromotionalCodesItem) list of promotional codes that may be applied to the company | |
customerStripeId | string Id of the customer on stripe |
object (CompanyKeyvaluePool) | |
object (CompanyKeyvaluePool) | |
userValidated | boolean indicates whether the owner has validated his account (first connection) |
Array of objects (CompanyKanbanStageListItem) | |
paymentMethodAdded | boolean Indicates whether at least one payment method was added |
createdTs | number Timestamp of the creation of the company |
deviceCreatedTs | number Timestamp where the first device was created |
object (CompanyOwnerInformation) | |
users | Array of strings List of users belonging to the company |
tags | Array of strings Tags |
isBetaTester | boolean Indicates if the company has access to beta features |
companyId | string A unique id for the company |
object (CompanyCostConfiguration) | |
userValidatedTs | number time when the owner user connected for the first time |
{- "limitsDefinition": {
- "nUsers": 0,
- "decodedLogSize": 0,
- "maxMonitors": 0,
- "minPeriod": 0,
- "logSize": 0,
- "usagePlanType": "string",
- "maxDecoders": 0,
- "monitorLogAccessDurationDays": 0
}, - "paymentMethodAddedTs": 0,
- "invoiceInformationTs": 0,
- "companyName": "string",
- "description": "string",
- "deviceStarted": true,
- "ownerId": "string",
- "subscriptionStripeInformation": {
- "subscriptionItemMonth": "string",
- "subscriptionId": "string",
- "subscriptionItemDay": "string"
}, - "deviceCreated": true,
- "invoiceInformation": {
- "country": "string",
- "address": "string",
- "TVANumber": "string",
- "city": "string",
- "postalCode": "string"
}, - "hasInvoiceInformation": true,
- "causes": [
- "string"
], - "deviceStartedTs": 0,
- "paymentInformation": {
- "lastPaymentFailed": true,
- "paymentFailedReason": "INVALID",
- "lastPaymentTs": 0
}, - "promotionalCodes": [
- {
- "duration": 0,
- "expirationTs": 0,
- "type": "string",
- "value": "string",
- "validationTs": 0
}
], - "customerStripeId": "string",
- "keyvaluePool": {
- "id": "string",
- "value": "string"
}, - "keyvalue": {
- "id": "string",
- "value": "string"
}, - "userValidated": true,
- "kanbanStageList": [
- {
- "headerColor": "string",
- "cardBackgroundColor": "string",
- "headerBackgroundColor": "string",
- "name": "string",
- "index": 0,
- "description": "string",
- "id": "string"
}
], - "paymentMethodAdded": true,
- "createdTs": 0,
- "deviceCreatedTs": 0,
- "ownerInformation": {
- "lastName": "string",
- "phoneNumber": "string",
- "jobTitle": "string",
- "name": "string",
- "email": "user@example.com"
}, - "users": [
- "string"
], - "tags": [
- "string"
], - "isBetaTester": true,
- "companyId": "string",
- "costConfiguration": {
- "currency": "string",
- "enabled": true
}, - "userValidatedTs": 0
}
{- "limitsDefinition": {
- "nUsers": 0,
- "decodedLogSize": 0,
- "maxMonitors": 0,
- "minPeriod": 0,
- "logSize": 0,
- "usagePlanType": "string",
- "maxDecoders": 0,
- "monitorLogAccessDurationDays": 0
}, - "paymentMethodAddedTs": 0,
- "invoiceInformationTs": 0,
- "companyName": "string",
- "description": "string",
- "deviceStarted": true,
- "ownerId": "string",
- "subscriptionStripeInformation": {
- "subscriptionItemMonth": "string",
- "subscriptionId": "string",
- "subscriptionItemDay": "string"
}, - "deviceCreated": true,
- "invoiceInformation": {
- "country": "string",
- "address": "string",
- "TVANumber": "string",
- "city": "string",
- "postalCode": "string"
}, - "hasInvoiceInformation": true,
- "causes": [
- "string"
], - "deviceStartedTs": 0,
- "paymentInformation": {
- "lastPaymentFailed": true,
- "paymentFailedReason": "INVALID",
- "lastPaymentTs": 0
}, - "promotionalCodes": [
- {
- "duration": 0,
- "expirationTs": 0,
- "type": "string",
- "value": "string",
- "validationTs": 0
}
], - "customerStripeId": "string",
- "keyvaluePool": {
- "id": "string",
- "value": "string"
}, - "keyvalue": {
- "id": "string",
- "value": "string"
}, - "userValidated": true,
- "kanbanStageList": [
- {
- "headerColor": "string",
- "cardBackgroundColor": "string",
- "headerBackgroundColor": "string",
- "name": "string",
- "index": 0,
- "description": "string",
- "id": "string"
}
], - "paymentMethodAdded": true,
- "createdTs": 0,
- "deviceCreatedTs": 0,
- "ownerInformation": {
- "lastName": "string",
- "phoneNumber": "string",
- "jobTitle": "string",
- "name": "string",
- "email": "user@example.com"
}, - "users": [
- "string"
], - "tags": [
- "string"
], - "isBetaTester": true,
- "companyId": "string",
- "costConfiguration": {
- "currency": "string",
- "enabled": true
}, - "userValidatedTs": 0
}
This information is accessed only by owner and admin users
companyId required | string Unique id of the company |
{- "limitsDefinition": {
- "nUsers": 0,
- "decodedLogSize": 0,
- "maxMonitors": 0,
- "minPeriod": 0,
- "logSize": 0,
- "usagePlanType": "string",
- "maxDecoders": 0,
- "monitorLogAccessDurationDays": 0
}, - "paymentMethodAddedTs": 0,
- "invoiceInformationTs": 0,
- "companyName": "string",
- "description": "string",
- "deviceStarted": true,
- "ownerId": "string",
- "subscriptionStripeInformation": {
- "subscriptionItemMonth": "string",
- "subscriptionId": "string",
- "subscriptionItemDay": "string"
}, - "deviceCreated": true,
- "invoiceInformation": {
- "country": "string",
- "address": "string",
- "TVANumber": "string",
- "city": "string",
- "postalCode": "string"
}, - "hasInvoiceInformation": true,
- "causes": [
- "string"
], - "deviceStartedTs": 0,
- "paymentInformation": {
- "lastPaymentFailed": true,
- "paymentFailedReason": "INVALID",
- "lastPaymentTs": 0
}, - "promotionalCodes": [
- {
- "duration": 0,
- "expirationTs": 0,
- "type": "string",
- "value": "string",
- "validationTs": 0
}
], - "customerStripeId": "string",
- "keyvaluePool": {
- "id": "string",
- "value": "string"
}, - "keyvalue": {
- "id": "string",
- "value": "string"
}, - "userValidated": true,
- "kanbanStageList": [
- {
- "headerColor": "string",
- "cardBackgroundColor": "string",
- "headerBackgroundColor": "string",
- "name": "string",
- "index": 0,
- "description": "string",
- "id": "string"
}
], - "paymentMethodAdded": true,
- "createdTs": 0,
- "deviceCreatedTs": 0,
- "ownerInformation": {
- "lastName": "string",
- "phoneNumber": "string",
- "jobTitle": "string",
- "name": "string",
- "email": "user@example.com"
}, - "users": [
- "string"
], - "tags": [
- "string"
], - "isBetaTester": true,
- "companyId": "string",
- "costConfiguration": {
- "currency": "string",
- "enabled": true
}, - "userValidatedTs": 0
}
Only admin and owner users can perform this action. Only companyName information can be modified
companyId required | string Unique id of the company to modify |
{- "limitsDefinition": {
- "nUsers": 0,
- "decodedLogSize": 0,
- "maxMonitors": 0,
- "minPeriod": 0,
- "logSize": 0,
- "usagePlanType": "string",
- "maxDecoders": 0,
- "monitorLogAccessDurationDays": 0
}, - "paymentMethodAddedTs": 0,
- "invoiceInformationTs": 0,
- "companyName": "string",
- "description": "string",
- "deviceStarted": true,
- "ownerId": "string",
- "subscriptionStripeInformation": {
- "subscriptionItemMonth": "string",
- "subscriptionId": "string",
- "subscriptionItemDay": "string"
}, - "deviceCreated": true,
- "invoiceInformation": {
- "country": "string",
- "address": "string",
- "TVANumber": "string",
- "city": "string",
- "postalCode": "string"
}, - "hasInvoiceInformation": true,
- "causes": [
- "string"
], - "deviceStartedTs": 0,
- "paymentInformation": {
- "lastPaymentFailed": true,
- "paymentFailedReason": "INVALID",
- "lastPaymentTs": 0
}, - "promotionalCodes": [
- {
- "duration": 0,
- "expirationTs": 0,
- "type": "string",
- "value": "string",
- "validationTs": 0
}
], - "customerStripeId": "string",
- "keyvaluePool": {
- "id": "string",
- "value": "string"
}, - "keyvalue": {
- "id": "string",
- "value": "string"
}, - "userValidated": true,
- "kanbanStageList": [
- {
- "headerColor": "string",
- "cardBackgroundColor": "string",
- "headerBackgroundColor": "string",
- "name": "string",
- "index": 0,
- "description": "string",
- "id": "string"
}
], - "paymentMethodAdded": true,
- "createdTs": 0,
- "deviceCreatedTs": 0,
- "ownerInformation": {
- "lastName": "string",
- "phoneNumber": "string",
- "jobTitle": "string",
- "name": "string",
- "email": "user@example.com"
}, - "users": [
- "string"
], - "tags": [
- "string"
], - "isBetaTester": true,
- "companyId": "string",
- "costConfiguration": {
- "currency": "string",
- "enabled": true
}, - "userValidatedTs": 0
}
Get the list of all annotations for a given device
companyId required | string Id of the company of the device |
deviceId required | string Id of the device for which we are getting the annotations |
[- {
- "unixTimestamp": 0,
- "companyId": "string",
- "id": "string",
- "title": "string",
- "deviceId": "string",
- "userId": "string",
- "content": "string"
}
]
Create an annotation for a device
companyId required | string Id of the company of the device |
deviceId required | string Id of the device for which creating the annotation |
unixTimestamp | integer Timestamp of the annotation |
companyId | string id of the company to which the device belongs |
id | string id of the annotation |
title | string Title of the annotation |
deviceId | string Device id associated to the annotation |
userId | string id of the user that made the annotation |
content | string Content of the annotation (in HTML) |
{- "unixTimestamp": 0,
- "companyId": "string",
- "id": "string",
- "title": "string",
- "deviceId": "string",
- "userId": "string",
- "content": "string"
}
{- "unixTimestamp": 0,
- "companyId": "string",
- "id": "string",
- "title": "string",
- "deviceId": "string",
- "userId": "string",
- "content": "string"
}
Update an annotation
annotationId required | string Id of the annotation to update |
companyId required | string Id of the company of the device |
unixTimestamp | integer Timestamp of the annotation |
companyId | string id of the company to which the device belongs |
id | string id of the annotation |
title | string Title of the annotation |
deviceId | string Device id associated to the annotation |
userId | string id of the user that made the annotation |
content | string Content of the annotation (in HTML) |
{- "unixTimestamp": 0,
- "companyId": "string",
- "id": "string",
- "title": "string",
- "deviceId": "string",
- "userId": "string",
- "content": "string"
}
{- "unixTimestamp": 0,
- "companyId": "string",
- "id": "string",
- "title": "string",
- "deviceId": "string",
- "userId": "string",
- "content": "string"
}
Delete an annotation
annotationId required | string Id of the annotation to delete |
companyId required | string Id of the company of the device |
{ }
companyId required | string Unique id of the company |
[- {
- "purchaseUrl": "string",
- "name": {
- "EN": "string",
- "FR": "string"
}, - "description": {
- "EN": "string",
- "FR": "string"
}, - "id": "string",
- "formFields": {
- "period": {
- "visible": true,
- "required": true
}, - "assetId": {
- "visible": true,
- "required": true
}, - "assetName": {
- "visible": true,
- "required": true
}, - "location": {
- "visible": true,
- "required": true
}, - "group": {
- "visible": true,
- "required": true
}, - "tags": {
- "visible": true,
- "required": true
}
}, - "helpContent": "string"
}
]
Get all the causes defined for a given company
companyId required | string Id of the company to get the list of causes |
issueId | string id of the issue to get the possible list of causes |
[- {
- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
]
Creates a new cause
companyId required | string Id of the company of the cause |
companyId | string Id of the company |
modifiedTs | number time of modification of the cause |
description | string Description of the cause |
id | string A unique id |
title | string [ 1 .. 20 ] characters Title of the cause |
createdTs | number time of creation of the cause |
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
Get a cause by id
causeId required | string Id of the cause to access |
companyId required | string Id of the company to get the list of causes |
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
Updates a new cause
causeId required | string Id of the cause to update |
companyId required | string Id of the company of the cause |
companyId | string Id of the company |
modifiedTs | number time of modification of the cause |
description | string Description of the cause |
id | string A unique id |
title | string [ 1 .. 20 ] characters Title of the cause |
createdTs | number time of creation of the cause |
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
Delete a solution
causeId required | string Id of the cause to delete |
companyId required | string Id of the company to delete the cause from |
{ }
Delete a solution
companyId required | string Id of the company to delete the solution from |
solutionId required | string Id of the solution to delete |
{ }
Get the logs of a given device during a given period of time
companyId required | string Unique id of the company to which the device belongs |
id required | string Unique id of the device |
start | string (not required) Initial timestamp (epoch value in seconds as integer) to get logs |
raw | string (not required) Ask for raw data and not summary data |
end | string (not required) End timestamp (epoch value in seconds as integer) to get logs |
[- {
- "data": {
- "std": {
- "x": [
- null
], - "y": [
- null
]
}, - "min": {
- "x": [
- null
], - "y": [
- null
]
}, - "median": {
- "x": [
- null
], - "y": [
- null
]
}, - "max": {
- "x": [
- null
], - "y": [
- null
]
}, - "mean": {
- "x": [
- null
], - "y": [
- null
]
}, - "raw": {
- "x": [
- null
], - "y": [
- null
]
}, - "sum": {
- "x": [
- null
], - "y": [
- null
]
}, - "states": {
- "x": [
- null
], - "y": [
- null
]
}
}, - "display": "percent",
- "id": "string"
}
]
This action can be performed by owner and developer users.
companyId required | string Unique id of the company to which the device belongs |
id required | string Unique id of the device |
{- "unixTimestamp": 0,
- "data": [
- {
- "id": "string",
- "type": "number",
- "val": "string"
}
], - "deviceId": "string"
}
Requires a valid API Key
unixTimestamp | number Timestamp in seconds of the device log |
Array of objects (LogDataItem) Data for the device | |
UTCTimestamp | string UTC Timestamp as ISO8601 format of the log for the device |
deviceId | string The unique UUID of the device sending the log |
{- "unixTimestamp": 0,
- "data": [
- {
- "display": "enum",
- "id": "string",
- "type": "number",
- "val": "string"
}
], - "UTCTimestamp": "string",
- "deviceId": "string"
}
{- "period": 0,
- "deviceId": "string"
}
Post a log using a pool key. Multiple devices can post here with the same API key
sensor-id | string ID of the sensor you are integrating (i.e. for sigfox integration use the sigfox id) |
frame-type | string Type of frame you are sending, this is used to properly decode the information sent by device |
company-id | string ID of your company |
{- "period": 0,
- "deviceId": "string"
}
Get the list of all data views for a given device
companyId required | string Id of the company of the device |
deviceId required | string Id of the device for which we are getting the data views |
[- {
- "companyId": "string",
- "graphs": [
- {
- "description": "string",
- "id": "string",
- "showGraph": true,
- "metrics": [
- {
- "metricId": "string",
- "color": "string",
- "assetId": "string",
- "display": "string",
- "yLabelSort": [
- {
- "label": "string",
- "showLabel": true
}
], - "units": "string",
- "displayCriteria": "raw",
- "table": {
- "splitValue": {
- "keepTimestamp": true,
- "line": "string",
- "column": "string"
}, - "columns": [
- {
- "showColumn": true,
- "name": "string"
}
]
}, - "yLabelPosition": "left"
}
], - "title": "string",
- "positionGraph": 0,
- "graphWidth": 1
}
], - "shareValue": "string",
- "positionView": 0,
- "name": "string",
- "showUnknownGraphs": true,
- "id": "string",
- "deviceId": "string",
- "shareType": "GROUP"
}
]
Create a data view for a device
companyId required | string Id of the company of the device |
deviceId required | string Id of the device for which we are getting the data views |
companyId | string id of the company to which the data view belongs |
Array of objects (DataViewGraphsItem) List of graphs configuration | |
shareValue | string Share value: group id or user id or ALL |
positionView | integer Position of the view in the list |
name | string Name of the data view |
showUnknownGraphs | boolean If true, show all new metrics not defined in the view |
id | string id of the data view |
deviceId | string Device id associated to the data view |
shareType | string Enum: "GROUP" "USER" Share type for the data view |
{- "companyId": "string",
- "graphs": [
- {
- "description": "string",
- "id": "string",
- "showGraph": true,
- "metrics": [
- {
- "metricId": "string",
- "color": "string",
- "assetId": "string",
- "display": "string",
- "yLabelSort": [
- {
- "label": "string",
- "showLabel": true
}
], - "units": "string",
- "displayCriteria": "raw",
- "table": {
- "splitValue": {
- "keepTimestamp": true,
- "line": "string",
- "column": "string"
}, - "columns": [
- {
- "showColumn": true,
- "name": "string"
}
]
}, - "yLabelPosition": "left"
}
], - "title": "string",
- "positionGraph": 0,
- "graphWidth": 1
}
], - "shareValue": "string",
- "positionView": 0,
- "name": "string",
- "showUnknownGraphs": true,
- "id": "string",
- "deviceId": "string",
- "shareType": "GROUP"
}
{- "companyId": "string",
- "graphs": [
- {
- "description": "string",
- "id": "string",
- "showGraph": true,
- "metrics": [
- {
- "metricId": "string",
- "color": "string",
- "assetId": "string",
- "display": "string",
- "yLabelSort": [
- {
- "label": "string",
- "showLabel": true
}
], - "units": "string",
- "displayCriteria": "raw",
- "table": {
- "splitValue": {
- "keepTimestamp": true,
- "line": "string",
- "column": "string"
}, - "columns": [
- {
- "showColumn": true,
- "name": "string"
}
]
}, - "yLabelPosition": "left"
}
], - "title": "string",
- "positionGraph": 0,
- "graphWidth": 1
}
], - "shareValue": "string",
- "positionView": 0,
- "name": "string",
- "showUnknownGraphs": true,
- "id": "string",
- "deviceId": "string",
- "shareType": "GROUP"
}
Update a dataview for a device
dataviewId required | string Id of the data view to update |
companyId required | string Id of the company of the device |
companyId | string id of the company to which the data view belongs |
Array of objects (DataViewGraphsItem) List of graphs configuration | |
shareValue | string Share value: group id or user id or ALL |
positionView | integer Position of the view in the list |
name | string Name of the data view |
showUnknownGraphs | boolean If true, show all new metrics not defined in the view |
id | string id of the data view |
deviceId | string Device id associated to the data view |
shareType | string Enum: "GROUP" "USER" Share type for the data view |
{- "companyId": "string",
- "graphs": [
- {
- "description": "string",
- "id": "string",
- "showGraph": true,
- "metrics": [
- {
- "metricId": "string",
- "color": "string",
- "assetId": "string",
- "display": "string",
- "yLabelSort": [
- {
- "label": "string",
- "showLabel": true
}
], - "units": "string",
- "displayCriteria": "raw",
- "table": {
- "splitValue": {
- "keepTimestamp": true,
- "line": "string",
- "column": "string"
}, - "columns": [
- {
- "showColumn": true,
- "name": "string"
}
]
}, - "yLabelPosition": "left"
}
], - "title": "string",
- "positionGraph": 0,
- "graphWidth": 1
}
], - "shareValue": "string",
- "positionView": 0,
- "name": "string",
- "showUnknownGraphs": true,
- "id": "string",
- "deviceId": "string",
- "shareType": "GROUP"
}
{- "companyId": "string",
- "graphs": [
- {
- "description": "string",
- "id": "string",
- "showGraph": true,
- "metrics": [
- {
- "metricId": "string",
- "color": "string",
- "assetId": "string",
- "display": "string",
- "yLabelSort": [
- {
- "label": "string",
- "showLabel": true
}
], - "units": "string",
- "displayCriteria": "raw",
- "table": {
- "splitValue": {
- "keepTimestamp": true,
- "line": "string",
- "column": "string"
}, - "columns": [
- {
- "showColumn": true,
- "name": "string"
}
]
}, - "yLabelPosition": "left"
}
], - "title": "string",
- "positionGraph": 0,
- "graphWidth": 1
}
], - "shareValue": "string",
- "positionView": 0,
- "name": "string",
- "showUnknownGraphs": true,
- "id": "string",
- "deviceId": "string",
- "shareType": "GROUP"
}
Delete a data view
dataviewId required | string Id of the data view to delete |
companyId required | string Id of the company to delete the data view from |
{ }
Get the list of decoders for the user
companyId required | string Id of company |
{- "Items": [
- {
- "companyId": "string",
- "decoderName": "string",
- "code": "string",
- "attachType": "device",
- "attachedDevices": [
- "string"
], - "decoderId": "string",
- "language": "python"
}
]
}
Attach a decoder
companyId required | string |
companyId | string Id of the company to which the decoder belongs |
decoderName | string The unique id of the decoder |
code | string string containing the code executed by the decoder |
attachType | string Enum: "device" "tag" "group" type of attachement for the decoder |
attachedDevices | Array of strings list of attched devices, tags, groups |
decoderId required | string The unique id of the decoder |
language | string Enum: "python" "javascript" language on which the decoder is written |
{- "companyId": "string",
- "decoderName": "string",
- "code": "string",
- "attachType": "device",
- "attachedDevices": [
- "string"
], - "decoderId": "string",
- "language": "python"
}
{- "code": "string",
- "message": "string"
}
Deploy a decoder
companyId required | string Id of the company |
companyId | string Id of the company to which the decoder belongs |
decoderName | string The unique id of the decoder |
code | string string containing the code executed by the decoder |
attachType | string Enum: "device" "tag" "group" type of attachement for the decoder |
attachedDevices | Array of strings list of attched devices, tags, groups |
decoderId required | string The unique id of the decoder |
language | string Enum: "python" "javascript" language on which the decoder is written |
{- "companyId": "string",
- "decoderName": "string",
- "code": "string",
- "attachType": "device",
- "attachedDevices": [
- "string"
], - "decoderId": "string",
- "language": "python"
}
{- "code": "string",
- "message": "string"
}
Get the decoder of a device
companyId required | string Id of the company |
deviceId required | string Unique id of the device |
{- "decoderName": "string",
- "information": {
- "companyId": "string",
- "decoderName": "string",
- "code": "string",
- "attachType": "device",
- "attachedDevices": [
- "string"
], - "decoderId": "string",
- "language": "python"
}
}
Validate the code of a decoder
companyId required | string |
code | string string containing the code executed by the decoder |
decoderId | string The unique id of the decoder |
language | string Enum: "python" "javascript" language on which the decoder is written |
frame | string Frame to be tested |
{- "code": "string",
- "decoderId": "string",
- "language": "python",
- "frame": "string"
}
{- "code": "string",
- "message": "string"
}
Get a decoder by id, if the decoder Id does not exist, it is created
companyId required | string Id of the company |
id required | string Unique id of the decoder |
{- "companyId": "string",
- "decoderName": "string",
- "code": "string",
- "attachType": "device",
- "attachedDevices": [
- "string"
], - "decoderId": "string",
- "language": "python"
}
Delete an existing decoder (id)
companyId required | string Id of the company |
id required | string Unique id of the decoder |
{- "companyId": "string",
- "decoderName": "string",
- "code": "string",
- "attachType": "device",
- "attachedDevices": [
- "string"
], - "decoderId": "string",
- "language": "python"
}
Get the list of all devices
companyId required | string Id of the company of the device |
{- "Items": [
- {
- "alertStatus": true,
- "timezone": "string",
- "companyName": "string",
- "keyId": "string",
- "deviceId": "string",
- "deviceName": "string",
- "enabled": true,
- "group": "string",
- "period": 60,
- "types": { },
- "lastAlertMessage": "string",
- "failedMonitors": { },
- "frames": [
- {
- "frameContent": "string",
- "frameId": "string"
}
], - "assetTemplateId": "string",
- "lastStateChangeTs": 0,
- "pool": true,
- "alertData": { },
- "createdTs": 0,
- "tags": [
- "string"
], - "companyId": "string",
- "modifiedTs": 0,
- "alertSettings": [
- {
- "nCycles": 0,
- "min": 0,
- "max": 0,
- "property": "cpu",
- "id": "string",
- "type": "minmax",
- "delayCycles": 0,
- "status": "enabled",
- "tags": [
- "string"
]
}
], - "lastAlertId": "string",
- "kpis": [
- "string"
], - "status": "string"
}
]
}
Creates a new device as well as an apikey associated to it. This action can be performed by develper and owner users
companyId required | string Id of the company of the device |
deviceId | string (WARNING) Id of the device, it must unique and it is your responsability |
alertStatus | boolean Inform whether the status alert is active |
timezone | string Timezone of the device |
companyName | string name of the company |
keyId | string id of the API key associated to the device |
deviceId | string A unique id |
deviceName required | string [ 1 .. 50 ] characters Name of the device |
enabled | boolean enable/disable monitoring of device |
group | string [ 1 .. 15 ] characters name of the the group |
period required | number >= 60 push period of the device in seconds |
types | object Object containing the types of all the logs |
lastAlertMessage | string last message of alert for this device |
failedMonitors | object list of ongoing failed monitors |
Array of objects (DeviceFramesItem) list of frames to test the decoders | |
assetTemplateId | string Id of the template from which the device was created |
lastStateChangeTs | number timestamp of the last state change of device |
pool | boolean informs whether the device belongs to the pool. Used for sigfox devices |
alertData | object data regarding current alerts for the device. Used internally, do not modify. |
createdTs | number time of creation of the device |
tags | Array of strings Tags |
companyId required | string unique id of the company |
modifiedTs | number time of modification of the device |
Array of objects (DeviceAlertSettingsItem) [Deprecated] List of services data for the device | |
lastAlertId | string id of the last detected alert |
kpis | Array of strings |
status | string status of the device |
{- "alertStatus": true,
- "timezone": "string",
- "companyName": "string",
- "keyId": "string",
- "deviceId": "string",
- "deviceName": "string",
- "enabled": true,
- "group": "string",
- "period": 60,
- "types": { },
- "lastAlertMessage": "string",
- "failedMonitors": { },
- "frames": [
- {
- "frameContent": "string",
- "frameId": "string"
}
], - "assetTemplateId": "string",
- "lastStateChangeTs": 0,
- "pool": true,
- "alertData": { },
- "createdTs": 0,
- "tags": [
- "string"
], - "companyId": "string",
- "modifiedTs": 0,
- "alertSettings": [
- {
- "nCycles": 0,
- "min": 0,
- "max": 0,
- "property": "cpu",
- "id": "string",
- "type": "minmax",
- "delayCycles": 0,
- "status": "enabled",
- "tags": [
- "string"
]
}
], - "lastAlertId": "string",
- "kpis": [
- "string"
], - "status": "string"
}
{- "alertStatus": true,
- "timezone": "string",
- "companyName": "string",
- "keyId": "string",
- "deviceId": "string",
- "deviceName": "string",
- "enabled": true,
- "group": "string",
- "period": 60,
- "types": { },
- "lastAlertMessage": "string",
- "failedMonitors": { },
- "frames": [
- {
- "frameContent": "string",
- "frameId": "string"
}
], - "assetTemplateId": "string",
- "lastStateChangeTs": 0,
- "pool": true,
- "alertData": { },
- "createdTs": 0,
- "tags": [
- "string"
], - "companyId": "string",
- "modifiedTs": 0,
- "alertSettings": [
- {
- "nCycles": 0,
- "min": 0,
- "max": 0,
- "property": "cpu",
- "id": "string",
- "type": "minmax",
- "delayCycles": 0,
- "status": "enabled",
- "tags": [
- "string"
]
}
], - "lastAlertId": "string",
- "kpis": [
- "string"
], - "status": "string"
}
Get device with device id and company
companyId required | string Id of the company of the device |
id required | string Unique id of the device |
{- "alertStatus": true,
- "timezone": "string",
- "companyName": "string",
- "keyId": "string",
- "deviceId": "string",
- "deviceName": "string",
- "enabled": true,
- "group": "string",
- "period": 60,
- "types": { },
- "lastAlertMessage": "string",
- "failedMonitors": { },
- "frames": [
- {
- "frameContent": "string",
- "frameId": "string"
}
], - "assetTemplateId": "string",
- "lastStateChangeTs": 0,
- "pool": true,
- "alertData": { },
- "createdTs": 0,
- "tags": [
- "string"
], - "companyId": "string",
- "modifiedTs": 0,
- "alertSettings": [
- {
- "nCycles": 0,
- "min": 0,
- "max": 0,
- "property": "cpu",
- "id": "string",
- "type": "minmax",
- "delayCycles": 0,
- "status": "enabled",
- "tags": [
- "string"
]
}
], - "lastAlertId": "string",
- "kpis": [
- "string"
], - "status": "string"
}
Update a device for a company
companyId required | string Id of the company |
id required | string Unique id of the device to modify |
alertStatus | boolean Inform whether the status alert is active |
timezone | string Timezone of the device |
companyName | string name of the company |
keyId | string id of the API key associated to the device |
deviceId | string A unique id |
deviceName required | string [ 1 .. 50 ] characters Name of the device |
enabled | boolean enable/disable monitoring of device |
group | string [ 1 .. 15 ] characters name of the the group |
period required | number >= 60 push period of the device in seconds |
types | object Object containing the types of all the logs |
lastAlertMessage | string last message of alert for this device |
failedMonitors | object list of ongoing failed monitors |
Array of objects (DeviceFramesItem) list of frames to test the decoders | |
assetTemplateId | string Id of the template from which the device was created |
lastStateChangeTs | number timestamp of the last state change of device |
pool | boolean informs whether the device belongs to the pool. Used for sigfox devices |
alertData | object data regarding current alerts for the device. Used internally, do not modify. |
createdTs | number time of creation of the device |
tags | Array of strings Tags |
companyId required | string unique id of the company |
modifiedTs | number time of modification of the device |
Array of objects (DeviceAlertSettingsItem) [Deprecated] List of services data for the device | |
lastAlertId | string id of the last detected alert |
kpis | Array of strings |
status | string status of the device |
{- "alertStatus": true,
- "timezone": "string",
- "companyName": "string",
- "keyId": "string",
- "deviceId": "string",
- "deviceName": "string",
- "enabled": true,
- "group": "string",
- "period": 60,
- "types": { },
- "lastAlertMessage": "string",
- "failedMonitors": { },
- "frames": [
- {
- "frameContent": "string",
- "frameId": "string"
}
], - "assetTemplateId": "string",
- "lastStateChangeTs": 0,
- "pool": true,
- "alertData": { },
- "createdTs": 0,
- "tags": [
- "string"
], - "companyId": "string",
- "modifiedTs": 0,
- "alertSettings": [
- {
- "nCycles": 0,
- "min": 0,
- "max": 0,
- "property": "cpu",
- "id": "string",
- "type": "minmax",
- "delayCycles": 0,
- "status": "enabled",
- "tags": [
- "string"
]
}
], - "lastAlertId": "string",
- "kpis": [
- "string"
], - "status": "string"
}
{- "alertStatus": true,
- "timezone": "string",
- "companyName": "string",
- "keyId": "string",
- "deviceId": "string",
- "deviceName": "string",
- "enabled": true,
- "group": "string",
- "period": 60,
- "types": { },
- "lastAlertMessage": "string",
- "failedMonitors": { },
- "frames": [
- {
- "frameContent": "string",
- "frameId": "string"
}
], - "assetTemplateId": "string",
- "lastStateChangeTs": 0,
- "pool": true,
- "alertData": { },
- "createdTs": 0,
- "tags": [
- "string"
], - "companyId": "string",
- "modifiedTs": 0,
- "alertSettings": [
- {
- "nCycles": 0,
- "min": 0,
- "max": 0,
- "property": "cpu",
- "id": "string",
- "type": "minmax",
- "delayCycles": 0,
- "status": "enabled",
- "tags": [
- "string"
]
}
], - "lastAlertId": "string",
- "kpis": [
- "string"
], - "status": "string"
}
Delete a device given the deviceId
companyId required | string Id of the company |
id required | string Unique id of the device to delete |
{ }
This action can be performed by owner and developer users.
companyId required | string Unique id of the company to which the device belongs |
id required | string Unique if of the device |
{- "name": "string",
- "id": "string",
- "value": "string",
- "enabled": true
}
Get the list of gorups for a company
companyId required | string Id of the company for which we want to get the groups |
{- "groups": [
- "string"
]
}
Create comment for a given issue
id required | string Id of the issue for which the comment will be created |
companyId required | string |
content | string Content of the comment |
parentId | string ignored |
{- "content": "string",
- "parentId": "string"
}
{- "issueId": "string",
- "triggerId": "string",
- "eventType": "ALERT_CREATED",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "isCreatedByUser": true,
- "content": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "context": { },
- "id": "string",
- "timestamp": 0
}
Get issueEvents list by IssueId
companyId required | string Unique id of the company |
id required | string |
[- {
- "issueId": "string",
- "triggerId": "string",
- "eventType": "ALERT_CREATED",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "isCreatedByUser": true,
- "content": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "context": { },
- "id": "string",
- "timestamp": 0
}
]
Get issues list
companyId required | string Unique id of the company |
archived | string Get archived alerts |
closed | string Get closed alerts |
active | string Get only active issues |
stopts | string End time (in seconds) |
startts | string Start time (in seconds) |
[- {
- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
]
Create a new issue (manually)
companyId required | string Id of the company for which we create the issue |
userMessage required | string Message to send as notification to users |
causeId | string Id of cause of the Issue. |
kanbanStageId | string id of the column in the Issue Kanban |
cost | number Cost information |
solutionId | string Id of solution of the Issue. |
title | string Name of the issue |
deviceId required | string Device associated to the issue |
{- "userMessage": "string",
- "causeId": "string",
- "kanbanStageId": "string",
- "cost": 0,
- "solutionId": "string",
- "title": "string",
- "deviceId": "string"
}
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Close an issue and all the alerts associated to it
id required | string Unique id of the issue to close |
companyId required | string Id of the company for which we create the issue |
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Get issues list by deviceId
companyId required | string Unique id of the company |
id required | string |
[- {
- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
]
Open an issue associated to it
id required | string Unique id of the issue to open |
companyId required | string Id of the company for which we create the issue |
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Set the cause of an issue. If the causeId is passed, the cause is set and the other fields are ignored. If the causeId is not passed, a new cause is created with the given title and description. If the issueEventId is passed it is used to set the causeIssueEventId of the issue.
id required | string Unique id of the issue to be updated |
companyId required | string Id of the company for which we create the issue |
causeId | string Id of the cause to associate with the issue |
description | string Additional text for the cause |
title | string <= 20 characters Title of the cause |
issueEventId | string Id of the issue event from which the cause is being created |
{- "causeId": "string",
- "description": "string",
- "title": "string",
- "issueEventId": "string"
}
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Set the solution of an issue. If the solutionId is passed, the solution is set and the other fields are ignored. If the solutionId is not passed, a new solution is created with the given title and description. If the issueEventId is passed it is used to set the solutionIssueEventId of the issue.
id required | string Unique id of the issue to be updated |
companyId required | string Id of the company for which we create the issue |
description | string Additional text for the solution |
solutionId | string Id of the solution to associate with the issue |
title | string <= 20 characters Title of the solution |
issueEventId | string Id of the issue event from which the solution is being created |
{- "description": "string",
- "solutionId": "string",
- "title": "string",
- "issueEventId": "string"
}
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Get issue information
id required | string Unique id of the issue |
companyId required | string Unique id of the company |
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Update an issue
id required | string Unique id of the issue to be updated |
companyId required | string Unique id of the company to modify |
kanbanStageId | string id of the column in the Issue Kanban |
cost | number Cost information |
isArchived | boolean Define the archived status of the issue |
object (IssueLastIssueEvent) | |
object (IssueDisplay) | |
isManual | boolean True if the issue was triggered manually |
cause | string Cause of the Issue. |
inferedCauseId | string Id of the cause infered by bagtower |
solutionIssueEventId | string Id of the issueEvent that is the solution of the issue |
startTs | number Start timestamp of the Issue (unix timestamp, in seconds) |
inferedSolutionId | string Id of the solution infered by bagtower |
createdTs | number Item creation unix timestamp (seconds) |
threadId | string Id of the conversation associated to the issue |
causeId | string Id of the cause of the Issue. |
companyId | string Id of the company |
modifiedTs | number Item last modification unix timestamp (seconds) |
causeMonitorId | string Id of the monitor that has triggered the issue |
stopTs | number Stop timestamp of the Issue (unix timestamp, in seconds, default 9876543210) |
isMonitorFailed | boolean True if the issue was triggered by an error in monitor code |
causeIssueEventId | string Id of the issueEvent that is the cause of the issue |
id | string Unique id for the item |
solutionId | string Id of the solution of the Issue. |
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
{- "kanbanStageId": "string",
- "cost": 0,
- "isArchived": true,
- "lastIssueEvent": {
- "companyId": "string",
- "issueId": "string",
- "modifiedTs": 0,
- "triggerId": "string",
- "context": { },
- "id": "string",
- "eventType": "string",
- "message": {
- "EN": {
- "subject": "string",
- "content": "string"
}, - "FR": {
- "subject": "string",
- "content": "string"
}
}, - "createdTs": 0,
- "parentId": "string",
- "content": "string",
- "timestamp": 0
}, - "display": {
- "subtitle": "string",
- "title": "string"
}, - "isManual": true,
- "cause": "string",
- "inferedCauseId": "string",
- "solutionIssueEventId": "string",
- "startTs": 0,
- "inferedSolutionId": "string",
- "createdTs": 0,
- "threadId": "string",
- "causeId": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "causeMonitorId": "string",
- "stopTs": 0,
- "isMonitorFailed": true,
- "causeIssueEventId": "string",
- "id": "string",
- "solutionId": "string"
}
Get the list of all the issue kanban stages defined by the user for the company.
companyId required | string Id of the company to get the list of issue kanban stages from. |
[- {
- "headerColor": "string",
- "cardBackgroundColor": "string",
- "headerBackgroundColor": "string",
- "name": "string",
- "index": 0,
- "description": "string",
- "id": "string"
}
]
Updates the list of issue kanban stages associated to the given company.
companyId required | string Id of the company involved in the issue kanban stages list update. |
headerColor | string Header (text) color of the stage column in a kanban representation. |
cardBackgroundColor | string Card background color of an alert included to the stage column in a kanban representation. |
headerBackgroundColor | string Header background color of the stage column in a kanban representation. |
name required | string Stage name, as defined by the user. |
index | number Index of the stage column in a kanban representation. |
description | string Stage description, as defined by the user. |
id required | string Index of the stage (column) in a kanban representation. |
[- {
- "headerColor": "string",
- "cardBackgroundColor": "string",
- "headerBackgroundColor": "string",
- "name": "string",
- "index": 0,
- "description": "string",
- "id": "string"
}
]
{- "code": "string",
- "message": "string"
}
Update kpis for a device
id required | string Unique id of the device for which we update the kpis |
companyId required | string Unique id of the company to modify |
Data model for device kpis
{ }
{ }
Get monitors list
companyId required | string Unique id of the company |
[- {
- "cost": {
- "costPerMinute": "string",
- "fixedCost": "string",
- "manualValue": "string"
}, - "attachmentType": "DEVICE",
- "createdTs": 0,
- "triggerCount": 0,
- "customTemplate": {
- "subjectTemplate": "string",
- "id": "string",
- "messageTemplate": "string"
}, - "logicOperator": "AND",
- "customScript": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "delay": 0,
- "attachmentValue": "string",
- "name": "string",
- "metricList": [
- "string"
], - "id": "string",
- "target": 0
}
]
Create a new monitor
companyId required | string |
object (MonitorCost) | |
attachmentType required | string Enum: "DEVICE" "GROUP" "TAG" Criteria type used to attach devices to the monitor. |
createdTs | number Item creation unix timestamp (seconds) |
triggerCount | number Monitor triggering counter value, computed from alerts counter (read only). |
object (MonitorCustomTemplate) | |
logicOperator | string Enum: "AND" "OR" Operator to apply to the conditions |
customScript | string Custom script written by the developer to perform custom monitoring (complex condition(s)). |
companyId | string Id of the company associated to the monitor |
modifiedTs | number Item last modification unix timestamp (seconds) |
delay required | integer Delay before triggering the issue |
attachmentValue required | string Criteria value used to attach devices to the monitor (device id, group name, tag value). |
name required | string Monitor name, given by the user |
metricList required | Array of strings List of metrics associated to this monitor |
id | string Unique id for the monitor item |
number or string The value to be compared with |
{- "cost": {
- "costPerMinute": "string",
- "fixedCost": "string",
- "manualValue": "string"
}, - "attachmentType": "DEVICE",
- "createdTs": 0,
- "triggerCount": 0,
- "customTemplate": {
- "subjectTemplate": "string",
- "id": "string",
- "messageTemplate": "string"
}, - "logicOperator": "AND",
- "customScript": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "delay": 0,
- "attachmentValue": "string",
- "name": "string",
- "metricList": [
- "string"
], - "id": "string",
- "target": 0
}
{- "cost": {
- "costPerMinute": "string",
- "fixedCost": "string",
- "manualValue": "string"
}, - "attachmentType": "DEVICE",
- "createdTs": 0,
- "triggerCount": 0,
- "customTemplate": {
- "subjectTemplate": "string",
- "id": "string",
- "messageTemplate": "string"
}, - "logicOperator": "AND",
- "customScript": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "delay": 0,
- "attachmentValue": "string",
- "name": "string",
- "metricList": [
- "string"
], - "id": "string",
- "target": 0
}
Validate code before deploying a monitor
companyId required | string |
required | object (Logs) Log entry |
required | object (MonitorInformation) Monitor informatio |
{- "log": {
- "unixTimestamp": 0,
- "data": [
- {
- "display": "enum",
- "id": "string",
- "type": "number",
- "val": "string"
}
], - "UTCTimestamp": "string",
- "deviceId": "string"
}, - "monitorInformation": {
- "customScript": "string"
}
}
{- "code": "string",
- "message": "string"
}
Get monitor information
id required | string Unique id of the monitor |
companyId required | string Unique id of the company |
{- "cost": {
- "costPerMinute": "string",
- "fixedCost": "string",
- "manualValue": "string"
}, - "attachmentType": "DEVICE",
- "createdTs": 0,
- "triggerCount": 0,
- "customTemplate": {
- "subjectTemplate": "string",
- "id": "string",
- "messageTemplate": "string"
}, - "logicOperator": "AND",
- "customScript": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "delay": 0,
- "attachmentValue": "string",
- "name": "string",
- "metricList": [
- "string"
], - "id": "string",
- "target": 0
}
Update a Monitor
id required | string Unique id of the monitor to be updated |
companyId required | string Unique id of the company to modify |
{- "cost": {
- "costPerMinute": "string",
- "fixedCost": "string",
- "manualValue": "string"
}, - "attachmentType": "DEVICE",
- "createdTs": 0,
- "triggerCount": 0,
- "customTemplate": {
- "subjectTemplate": "string",
- "id": "string",
- "messageTemplate": "string"
}, - "logicOperator": "AND",
- "customScript": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "delay": 0,
- "attachmentValue": "string",
- "name": "string",
- "metricList": [
- "string"
], - "id": "string",
- "target": 0
}
Remove a monitor from DB
id required | string Unique id of the monitor to be deleted |
companyId required | string |
[- {
- "cost": {
- "costPerMinute": "string",
- "fixedCost": "string",
- "manualValue": "string"
}, - "attachmentType": "DEVICE",
- "createdTs": 0,
- "triggerCount": 0,
- "customTemplate": {
- "subjectTemplate": "string",
- "id": "string",
- "messageTemplate": "string"
}, - "logicOperator": "AND",
- "customScript": "string",
- "companyId": "string",
- "modifiedTs": 0,
- "delay": 0,
- "attachmentValue": "string",
- "name": "string",
- "metricList": [
- "string"
], - "id": "string",
- "target": 0
}
]
Get the default notification template
companyId required | string Unique id of the company |
{- "subjectTemplate": "string",
- "messageTemplate": "string"
}
Get statistics of issues
companyId required | string Unique id of the company |
costmin | string Consider only issues that have a cost higher than this value |
costmax | string Consider only issues that have a cost lower than this value |
durationmin | string Consider only issues that last longer than this value |
group | string Consider only issues for the given group |
causeid | string Consider only issues for the given cause id |
durationmax | string Consider only issues that last less than this value |
stopts | string End time (in seconds) |
startts | string Start time (in seconds) |
{- "summary": {
- "duration": {
- "cause": [
- {
- "casueid": "string",
- "label": "string",
- "value": 0
}
], - "group": [
- {
- "casueid": "string",
- "label": "string",
- "value": 0
}
]
}, - "cost": {
- "cause": [
- {
- "casueid": "string",
- "label": "string",
- "value": 0
}
], - "group": [
- {
- "casueid": "string",
- "label": "string",
- "value": 0
}
]
}, - "count": {
- "cause": [
- {
- "casueid": "string",
- "label": "string",
- "value": 0
}
], - "group": [
- {
- "casueid": "string",
- "label": "string",
- "value": 0
}
]
}
}, - "graphs": {
- "duration": [
- {
- "duration": 0,
- "OfflineDuration": 0,
- "previousDuration": 0,
- "timestamp": 0
}
], - "cost": [
- {
- "cost": 0,
- "previousCost": 0,
- "timestamp": 0
}
], - "count": [
- {
- "offlineCount": 0,
- "count": 0,
- "previousCount": 0,
- "timestamp": 0
}
]
}, - "globalSummary": {
- "totalAlert": 0,
- "mttr": 0,
- "previousTotalAlert": 0,
- "currency": "string",
- "totalCost": 0
}
}
Get all the soltions defined for a given company
companyId required | string Id of the company to get the list of solutions |
issueId | string id of the issue to get the possible list of solutions |
[- {
- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
]
Creates a new soltion
companyId required | string Id of the company of the soltion |
companyId | string Id of the company |
modifiedTs | number time of modification of the cause |
description | string Description of the solution |
id | string A unique id |
title | string [ 1 .. 20 ] characters Title of the cause |
createdTs | number time of creation of the cause |
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
Get a solution
companyId required | string Id of the company to get the list of solutions |
solutionId required | string id of the solution to get |
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
Creates a new soltion
companyId required | string Id of the company of the soltion |
solutionId required | string Id of the solution to update |
companyId | string Id of the company |
modifiedTs | number time of modification of the cause |
description | string Description of the solution |
id | string A unique id |
title | string [ 1 .. 20 ] characters Title of the cause |
createdTs | number time of creation of the cause |
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
{- "companyId": "string",
- "modifiedTs": 0,
- "description": "string",
- "id": "string",
- "title": "string",
- "createdTs": 0
}
Get stripe setupIntent to create a payment method
companyId required | string Unique id of the company |
type | string Type of payment method ['card', 'sepa_debit'] |
{- "client_secret": "string"
}
Get payment methods of a given company
companyId required | string Unique id of the company |
{- "Items": [
- {
- "billing_details": {
- "address": {
- "country": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "line2": "string",
- "line1": "string"
}, - "phone": "string",
- "name": "string",
- "email": "string"
}, - "id": "string",
- "type": "card",
- "customer": "string",
- "group": "string"
}
]
}
Delete a payment method for a company
companyId required | string |
paymentId | string Id (stripe) of the payment method to delete |
{- "Items": [
- {
- "billing_details": {
- "address": {
- "country": "string",
- "city": "string",
- "state": "string",
- "postal_code": "string",
- "line2": "string",
- "line1": "string"
}, - "phone": "string",
- "name": "string",
- "email": "string"
}, - "id": "string",
- "type": "card",
- "customer": "string",
- "group": "string"
}
]
}
Set default payment method
companyId required | string Unique id of the company |
paymentId | string Id (stripe) of the payment method to set as default |
{ }
companyId required | string Id of the company |
only_overall | string If param given, the function returns only global information |
{- "overall": {
- "p365d": 0,
- "p30days": 0,
- "p1d": 0,
- "p7days": 0,
- "p90days": 0
}, - "devicesData": [
- {
- "dailyData": {
- "downTime": 0,
- "upTime": 0,
- "unixTimestamp": 0,
- "upTimePercent": 0,
- "uncodedTime": 0,
- "index": 0,
- "otherAlertsTime": 0
}, - "deviceId": "string"
}
]
}
Get the list of users of the company companyId.
companyId required | string Unique id of the company |
{- "Items": [
- {
- "lastName": "string",
- "hidden": true,
- "lastConnectionTs": 0,
- "languageCode": "FR",
- "userId": "string",
- "createdTs": 0,
- "isBageraUser": true,
- "tags": [
- "string"
], - "companies": [
- {
- "companyId": "string",
- "role": [
- "admin"
], - "group": [
- "string"
]
}
], - "modifiedTs": 0,
- "phoneNumber": "string",
- "channels": [
- "EMAIL"
], - "name": "string",
- "email": "user@example.com"
}
]
}
If the user already exists it is added to the first company in the companies attribute given in body information
companyId required | string |
lastName | string [ 1 .. 50 ] characters Last name of the user |
hidden | boolean If true do no render to list page |
lastConnectionTs | integer Last ts the user was connected (access to get devices route) |
languageCode | string Enum: "FR" "EN" Lamguage preference for the user |
userId | string Unique id for the user |
createdTs | number timestamp of the creation of the user |
isBageraUser | boolean If true do no render to list page |
tags | Array of strings Tags associated to the user |
Array of objects (UserCompaniesItem) List of companies associted to the user | |
modifiedTs | number time of modification of the user |
phoneNumber | string Phone number of the user |
channels | Array of strings Items Enum: "EMAIL" "SMS" |
name required | string [ 1 .. 50 ] characters Name of the user |
email required | string <email> Email address of the user |
{- "lastName": "string",
- "hidden": true,
- "lastConnectionTs": 0,
- "languageCode": "FR",
- "userId": "string",
- "createdTs": 0,
- "isBageraUser": true,
- "tags": [
- "string"
], - "companies": [
- {
- "companyId": "string",
- "role": [
- "admin"
], - "group": [
- "string"
]
}
], - "modifiedTs": 0,
- "phoneNumber": "string",
- "channels": [
- "EMAIL"
], - "name": "string",
- "email": "user@example.com"
}
{- "lastName": "string",
- "hidden": true,
- "lastConnectionTs": 0,
- "languageCode": "FR",
- "userId": "string",
- "createdTs": 0,
- "isBageraUser": true,
- "tags": [
- "string"
], - "companies": [
- {
- "companyId": "string",
- "role": [
- "admin"
], - "group": [
- "string"
]
}
], - "modifiedTs": 0,
- "phoneNumber": "string",
- "channels": [
- "EMAIL"
], - "name": "string",
- "email": "user@example.com"
}
If the request is done by an admin, user information is returned. Otherwise, a user can only get information of himself.
id required | string Unique id of the user |
companyId required | string Unique id of the company |
{- "lastName": "string",
- "hidden": true,
- "lastConnectionTs": 0,
- "languageCode": "FR",
- "userId": "string",
- "createdTs": 0,
- "isBageraUser": true,
- "tags": [
- "string"
], - "companies": [
- {
- "companyId": "string",
- "role": [
- "admin"
], - "group": [
- "string"
]
}
], - "modifiedTs": 0,
- "phoneNumber": "string",
- "channels": [
- "EMAIL"
], - "name": "string",
- "email": "user@example.com"
}
A user can modify his/her own information. An owner / admin can modify other users' information
companyId required | string Unique id of the company to modify |
id required | string |
lastName | string [ 1 .. 50 ] characters Last name of the user |
hidden | boolean If true do no render to list page |
lastConnectionTs | integer Last ts the user was connected (access to get devices route) |
languageCode | string Enum: "FR" "EN" Lamguage preference for the user |
userId | string Unique id for the user |
createdTs | number timestamp of the creation of the user |
isBageraUser | boolean If true do no render to list page |
tags | Array of strings Tags associated to the user |
Array of objects (UserCompaniesItem) List of companies associted to the user | |
modifiedTs | number time of modification of the user |
phoneNumber | string Phone number of the user |
channels | Array of strings Items Enum: "EMAIL" "SMS" |
name required | string [ 1 .. 50 ] characters Name of the user |
email required | string <email> Email address of the user |
{- "lastName": "string",
- "hidden": true,
- "lastConnectionTs": 0,
- "languageCode": "FR",
- "userId": "string",
- "createdTs": 0,
- "isBageraUser": true,
- "tags": [
- "string"
], - "companies": [
- {
- "companyId": "string",
- "role": [
- "admin"
], - "group": [
- "string"
]
}
], - "modifiedTs": 0,
- "phoneNumber": "string",
- "channels": [
- "EMAIL"
], - "name": "string",
- "email": "user@example.com"
}
{- "lastName": "string",
- "hidden": true,
- "lastConnectionTs": 0,
- "languageCode": "FR",
- "userId": "string",
- "createdTs": 0,
- "isBageraUser": true,
- "tags": [
- "string"
], - "companies": [
- {
- "companyId": "string",
- "role": [
- "admin"
], - "group": [
- "string"
]
}
], - "modifiedTs": 0,
- "phoneNumber": "string",
- "channels": [
- "EMAIL"
], - "name": "string",
- "email": "user@example.com"
}