Skip to main content
API docs by Redocly

signageOS REST API (0.0.0)

Download OpenAPI specification:Download

Introduction

signageOS helps any developer to build apps for displays and remotely manage large networks of displays in a standardized way. No matter what display you are using, all APIs work across all of them.

Read more here:


About REST API

The signageOS REST API brings extra features for signageOS users with out-of-the-box device management, monitoring, and maintenance service provided by signageOS. With an existing, scalable, and flexible solution you can easily integrate advanced features into your CMS via standardized REST API. No need to re-invent the wheel again.

All APIs are standardized and available across all supported devices.

To use REST API, you need an Organization on Device Plan 1.0, 2.0 or 3.0. REST API does not work on free Open Device Plan.


List of REST API Domains

Domain Description
Device Configure the device, set timers, brightness, volume, RM server url, update the Core App, update firmware and much more, get device uptime, temperature, outages, content status or custom logs.
Applet Way to create your own Applets and its versions over API instead of Box.
Timing Timing REST API helps you schedule Applets (your HTML player) on the devices.
Organizations Organization/User REST API helps you to manage your account and create/delete organizations and retrieve security tokens.
Account Manage or delete security account tokens.
Firmware Manage firmware versions on supported devices.
Emulator Create emulators, test your environment or simply manage them.
Policy Manage policies with various settings, set up new policies or configure exiting policies and assign them to devices.
Tag Manage tags.
Alert Manage device alerts and get informed about anomalies on production devices.
Location Managing and filtering devices by assigned locations.
Bulk Provisioning Register your devices and automate the deployment

REST API Authentication

For REST API your application needs to be authenticated using request Header: X-Auth which is different for every single organization (end company owning/using devices). There is a possibility to create a sub-organization for any of your customers in signageOS Box.

  1. Go to Organizations section in signageOS Box and generate your token_id & token_secret.
  2. Use it as X-Auth header separated by colon - __TOKEN_ID:__TOKEN_SECRET__.
# X-Auth = client_id:client_secret
curl -XGET -H "X-Auth: 87e376c08d16XXXXb796294744:5ef829c933aXXXX710f5388a27fee" \
  https://api.signageos.io/v1/device

If X-Auth token is invalid or generated token does not have permissions in organization you will receive 403 Forbidden response.


REST API Request Quota

signageOS REST API automatically applies quotas on REST requests. The quota is counted per IP address of the Request origin.

The quota is set to 200 requests per second for instant response and 500 queued requests with a slightly delayed response based on request type and performance.

If you reach the quota API returns 429 Too Many Requests response.

It is important to note that after creating a Company through REST API, the default Device plan is set to 3.0. This can be changed from within SignageOS Box under your Company profile.


Pagination

There is enforced maximum length of data that can be returned in a single response. If there's more data available, than the limit allows, data will be returned in multiple pages. Cursor based pagination will be used. https://jsonapi.org/profiles/ethanresnick/cursor-pagination/#auto-id-query-parameters Parameter limit can be used for setting the page size. Setting the limit over the max allowed limit will result in error. Beware not to change the limit in the middle of the process of fetching pages. If a different limit is specified, process needs to be started over from the first page. Request without additional parameters will return the first page. If there are more data available, the response will contain a header "Link" that will contain the link to the next page, e.g. <https://api.signageos.io/v1/device?until=2021-11-01T00%3A33%3A38.918Z>; rel="next". Then by performing another request with the link next page will be returned. Each response will contain a link to the next page until there are no more data left.


Url structure

List parameters

There are two ways lists could be encoded:

  • ... <LIST_PARAM_NAME>=<VALUE_0>&<LIST_PARAM_NAME>=<VALUE_1>&<LIST_PARAM_NAME>=<VALUE_2> ...
  • ... <LIST_PARAM_NAME>=<VALUE_0>,<VALUE_1>,<VALUE_2>...

For example, list with values uid1, uid2, uid3, encoded in URL as parameter deviceUid will look like this: deviceUid=uid1&deviceUid=uid2&deviceUid=uid3 or deviceUid=uid1,uid2,uid3

In the case of comma-separated values, any string value containing a comma should be escaped.

Asynchronous REST API Requests

While some of API endpoints can be “fire and forget”, i.e. there is no need to report back to the client, for example, when initiating a bulk actions. For others, the client may need a response, but can't get it in the original request because of the long processing time, i.e. in case of firmware upgrade request or Applet operations. In those cases, we have to do a "pre-flight" check and connect directly with device to execute the action, which can be a time-consuming process, often better performed asynchronously. For these asynchronous operations (typically all /device/xxxx endpoints) we adopted a polling strategy. Clients can retrieve the results of asynchronous requests by polling a special endpoint that will return the result of the request, once it's available.

Standard Flow Example

  1. The client sends the PUT request - set brightness to 100% - to the server to begin the operation. 1. The server accepts the request, confirming by 200 OK message. 1. The asynchronous process begins on the server side, triggering desired function - connecting to device, setting a brightness and confirming the value was set and accepted by the device. 1. Finally, the server finished the action by receiving a confirmation from the device - brightness successfully set to 100%. During this process, the client polls the GET URI of the brightness endpoint. The server returns the status of the last request:
  "uid": "deed07d35fdxxx",
  "deviceUid": "e824fcd24a4fxxx",
  "createdAt": "2022-07-22T12:06:45.540Z",
  "succeededAt": "2022-07-22T12:06:55.850Z",
  "failedAt": null,
  "brightness1": 90,
  "brightness2": 40,
  "timeFrom1": "09:00:00",
  "timeFrom2": "20:00:00"
} ```
Status of the operation is available under `succeededAt` and `failedAt` keys. If the request succeeeded, `succeededAt` will be set. If it failed, `failedAt` will be set. If non of the two are set, it means that the request is still pending.
![Flow diagram of async requests](https://public.docs.signageos.io/api/rest_api_flow.png)
### Important consideration In the polling pattern, the client must decide how frequently to poll the URL and when to give up. One common choice is exponential backoff, which increases the interval between checks until a maximum interval is reached or the response (succeededAt/failedAt) is received.

<br />

Account

Create Account Security Token

Create security token for account by username/email/id and password.

query Parameters
identification
string
Example: identification={{username}}

Login username (required)

password
string
Example: password={{password}}

Login password (required)

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Body need to by in JSON

Responses

Delete All Account Security Tokens

Delete all security tokens from account by username/email/id and password.

query Parameters
identification
string
Example: identification={{username}}

Login username (required)

password
string
Example: password={{password}}

Login password (required)

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Delete One Account Security Token

Delete one security token from account by username/email/id and password and token itself.

path Parameters
token
required
string
Example: {{token}}
query Parameters
identification
string
Example: identification={{username}}

Login username (required)

password
string
Example: password={{password}}

Login password (required)

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Applet

The Applet is an HTML5/Javascript application that runs within the signageOS Core App. Applet can leverage the Applet JS API for easy access to the device native functions like saving files into internal memory and using accelerated video playback among others.

Get Applets

Get all applets of current organization

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Applet

Create a new Applet that can be assigned to the device.

Body

Content-type: application/json or application/x-www-form-urlencoded

Field Type Required Description
name string required Your new Applet name, eg. Cool Applet

Assigning Applet to Device

Looking for a way how to set Applet to device? The endpoint you are looking for is called Timing.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "Applet Name"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Applet

Get one applet by appletUid. The UID can be found in list of all applets in signageOS Box.

Parameters

Field Type Required Description
appletUid string required Unique applet identification
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "bd74395949f7de6f143e59f00e8e351b8a01899873bb76be78",
  • "name": "Demo Applet",
  • "createdAt": "2017-05-24T08:58:56.994Z"
}

Delete Applet

Delete one Applet by appletUid. All assigned Timings on any device have to be deleted first.

Parameters

Field Type Required Description
appletUid string required Unique applet identification
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Create Applet Version

To create new Applet version you need just a new version of HTML (binary).

There is a better way, use signageOS CLI for creating multifile Applets

Parameters

Field Type Required Description
appletUid string required Unique Applet identification

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Required Description
binary string required HTML file
version string (semver) required Version of your Applet, e.g. 1.0.12
frontAppletVersion string (semver) required Version of Content Applet JS API
entryFile string optional Entry file name

Assigning Applet to Device

Looking for a way how to set Applet to device? The endpoint you are looking for is called Timing.

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "binary": "<html><h1>Hello world</h1></html>",
  • "version": "{{appletVersion}}",
  • "frontAppletVersion": "1.0.5"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Applet Versions

Get all Applet versions of the Applet by appletUid.

Several Applet versions make upgrade process and device operation a lot safer. This API call returns versions of selected Applet.

Parameters

Field Type Required Description
appletUid string required unique applet identification
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get Applet Version

Get one specific Applet version of the Applet by appletUid and appletVersion

Parameters

Field Type Required Description
appletUid string required Unique applet identification
appletVersion string (semver) optional Version of your Applet, e.g. 1.0.12
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "appletUid": "bd74395949f7de6f143e59f00e8e351b8a01899873bb76be78",
  • "version": "0.0.1",
  • "createdAt": "2017-05-24T09:12:13.251Z",
  • "updatedAt": "2017-09-12T09:09:53.240Z",
  • "binary": null,
  • "frontAppletVersion": "1.0.3",
  • "publishedSince": null,
  • "deprecatedSince": null,
  • "builtSince": "2017-10-10T19:54:25.206Z"
}

Update Applet Version

Update existing Applet version of the Applet by appletUid and appletVersion.

To update any of your Applet version you need just new version of HTML (binary).

There is a better way, use signageOS CLI for creating multifile Applets

Parameters

Field Type Required Description
appletUid string required Unique Applet identification
appletVersion string (semver) optional Version of your Applet, e.g. 1.0.12

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Required Description
binary string required HTML file as string
frontAppletVersion string (semver) required Version of Content Applet JS API
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "binary": "<html><h1>Hello world</h1></html>",
  • "frontAppletVersion": "1.0.5"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Upload Applet Version Files

Upload file to applet version files by appletUid & appletVersion.

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

query Parameters
build
boolean

Do the build of applet version when file is uploaded. Accepted values '0', '1', 'true', 'false'.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
path
required
string

Path where will be file uploaded. Must be an absolute path.

hash
required
string

MD5 checksum of uploaded file

type
string

Content-Type (MIME type) of the uploaded file

Responses

Request samples

Content type
application/json
{
  • "path": "index.html",
  • "hash": "045e372a1eeafee2ce5580443c18a91d",
  • "type": "text/html"
}

Response samples

Content type
application/json
{
  • "upload": {
    },
  • "file": {}
}

Get Applet Version Files

Get file of applet version files by appletUid, appletVersion

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Get Applet Version File

Get file of applet version files by appletUid, appletVersion & appletFileName

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

appletFileName
required
string
Example: {{appletFileName}}

File name in Applet Version. It has to be relative path to applet root. It cannot start with slash /. It's forbidden to upload files inside node_modules directory.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Upload and Update Applet Version Files

Upload and update existing file to applet version files by appletUid , appletVersion & appletFileName

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

appletFileName
required
string
Example: {{appletFileName}}

File name in Applet Version. It has to be relative path to applet root. It cannot start with slash /. It's forbidden to upload files inside node_modules directory.

query Parameters
build
boolean

Do the build of applet version when file is uploaded. Accepted values '0', '1', 'true', 'false'.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
hash
required
string

MD5 checksum of uploaded file

type
string

Content-Type (MIME type) of the uploaded file

Responses

Request samples

Content type
application/json
{
  • "hash": "045e372a1eeafee2ce5580443c18a91d",
  • "type": "text/javascript"
}

Response samples

Content type
application/json
{
  • "upload": {
    },
  • "file": {}
}

Delete Applet Version File

Delete an existing file to applet version files by appletUid, appletVersion & appletFileName

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

appletFileName
required
string
Example: {{appletFileName}}

File name in Applet Version. It has to be relative path to applet root. It cannot start with slash /. It's forbidden to upload files inside node_modules directory.

query Parameters
build
boolean

Do the build of applet version when file is uploaded. Accepted values '0', '1', 'true', 'false'.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Applet/Applet Tests

Test Applet By Version

Create new applet version test of applet by appletUid and appletVersion.

To create a new Applet version test suite you need just the binary (string with test source code).

Parameters

Field Type Required Description
appletUid string required Unique Applet identification
version string required Applet version

Body

Field Type Required Description
identifier string required Test suite identifier
binary string required Binary as string
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "identifier": "{{testIdentifier}}",
  • "binary": "console.log('OK');"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Test Applet By Version

Get all applet version tests of applet by appletUid & appletVersion.

Applet tests allow you to test the functionality and performance of your applets automatically.

Parameters

Field Type Required Description
appletUid string required Unique applet identification
appletVersion string (semver) required Version of your Applet, e.g. 1.0.12
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Test Applet By Version and Test Identifier

Get content from one applet version test of applet by appletUid , appletVersion and testIdentifier.

Applet tests allow you to test the functionality and performance of your applets automatically.

Parameters

Field Type Required Description
appletUid string required Unique applet identification
appletVersion string (semver) required Version of your Applet, e.g. 1.0.12
testIdentifier string required Name of the test suite
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

testIdentifier
required
string
Example: {{testIdentifier}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "binary": "example-binary-content"
}

Test Applet By Version And Identifier

Update existing applet version test of applet by appletUid, appletVersion & testIdentifier

To update existing Applet version test suite you need just the binary (string with test source code).

Parameters

Field Type Required Description
appletUid string required Unique Applet identification
version string required Applet version
identifier string required Test suite identifier

Body

Field Type Required Description
binary string required Binary as string
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

testIdentifier
required
string
Example: {{testIdentifier}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "binary": "console.log('OK');"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Test Applet By Version And Identifier

Delete existing Applet version test by appletUid, appletVersion & testIdentifier.

Parameters

Field Type Required Description
appletUid string required Unique Applet identification
appletVersion string required Applet version
testIdentifier string required Test suite identifier
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

testIdentifier
required
string
Example: {{testIdentifier}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Alert

Get Alerts

Get all alerts for current Organization.

Parameters

Field Type Required Description
pagination number greater than 0
optional
 Start paginating result by a given number of items on the page. Next page link is available in the response header Link.

E.g.: <https://api.signageos/v1/alert?pagination=50&createdUntil=2020-10-22T16%3A10%3A00.000Z>; rel="next"
createdUntil string
optional
 Filter by alert createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).
archived boolean
optional
 Filter archived/active alerts. Accepted values '0', '1', 'true', 'false'
query Parameters
pagination
integer
Example: pagination=50
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Create Alert

Create an alert for specified organization.

Body

Field Type Required Description
name string required Name of the new alert
organizationUid string required Uid of organization to which alert will be assigned
description string required Description of the alert
alertRuleUid string required Created alert rule that will be assigned to this new alert
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
string
description
string
organizationUid
string
alertRuleUid
string

Responses

Request samples

Content type
application/json
{
  • "name": "New alert name",
  • "description": "new description",
  • "organizationUid": "{{organizationUid}}",
  • "alertRuleUid": "alert rule uid"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Alert

Get alert for current Organization by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "alertUid": "e8e6da9206f377289c2c5b8c0eb0155ee8f45c4f76b278085b",
  • "organizationUid": "43259e30b1423d4171e348d6a1a1222e3b0075c8d7ebac868a",
  • "description": "Alert for PB 5",
  • "alertRuleUid": "147c0d4a5846da4b4cfddf231744c4f4597eaf0b7c7610381f",
  • "createdAt": "2021-09-21T13:52:07.665Z",
  • "archivedAt": null,
  • "deviceUids": [ ],
  • "latelyChangedAt": "2021-09-21T13:52:07.665Z",
  • "snoozeRule": null
}

Update Alert Description

Update alert description by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification

Body

Field Type Required Description
description string required New description for updated alert
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "description": "new alert description"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Archive Alert

Archive one alert by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Unarchive Alert

Unarchive one alert by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
{
  "message\"": "OK"
}

Snooze Alert

Snooze one alert by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification

Body

Field Type Required Description
snoozeRule object required Properties for alert https://demo.signageos.io/dev/alerts/modules.html#snoozerule
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "snoozeRule": {
    }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Snooze Device Alert

Snooze one alert on one device by alertUid and deviceUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification
deviceUid string required Device unique identification

Body

Field Type Required Description
snoozeRule object required Properties for alert (only datetime is available) https://demo.signageos.io/dev/alerts/modules.html#snoozerule
path Parameters
alertUid
required
string
Example: {{alertUid}}
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "snoozeRule": {
    }
}

Response samples

Content type
text/plain
# Empty response

Unsnooze Device Alert

Unsnooze one alert on one device by alertUid and deviceUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification
deviceUid string required Device unique identification

Body

Field Type Required Description
path Parameters
alertUid
required
string
Example: {{alertUid}}
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
# Empty response

Unsnooze Alert

Unsnooze one alert by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
{
  "message": "OK"
}

Assigne Devices to Alert

Assign device to alert by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification

Body

Field Type Required Description
alertUid string required Unique Alert Identification
deviceIdentityHashes array required Array of deviceUids that will be assigned to this alert.
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
"{\n \"alertUid\": {{alertUid}},\n \"deviceIdentityHashes\": [{{deviceUid}}]\n}"

Response samples

Content type
application/json
{
  • "message": "OK"
}

Unassigne Devices from Alert

Unassign alert from devices by alertUid.

Parameters

Field Type Required Description
alertUid string required Unique Alert Identification

Body

Field Type Required Description
alertUid string required Unique Alert Identification
deviceIdentityHashes array required Array of deviceUids that will be unassigned from this alert.
path Parameters
alertUid
required
string
Example: {{alertUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
"{\n \"alertUid\": {{alertUid}},\n \"deviceIdentityHashes\": [{{deviceUid}}]\n}"

Response samples

Content type
application/json
{
  • "message": "OK"
}

Alert/Rule

Get Alert Rules

Get list of all alert rules in your company.

Parameters

Field Type Required Description
pagination number optional Start paginating result by given number items on-page. Next page link is available on in response under header `Link`. E.g.: `; rel="next"`
archived boolean optional Filter archived alert rules. Accepted values '0', '1', 'true', 'false'
paused boolean optional Filter paused alert rules. Accepted values '0', '1', 'true', 'false'
name string optional Filter alert rules by name
alertType string optional Filter alert rules corresponding with type. Accepted values 'DEVICE', 'POLICY', 'APPLET'
query Parameters
alertType
string
Example: alertType=DEVICE
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Alert Rule

Create a new alert rule within your company by companyUid.

Parameters

Field Type Required Description
No parameters

Body

FIeld Type Required Description
name string required Name of the new alert rule
companyUid string required Unique Company Identification
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "alert rule name",
  • "companyUid": "{{companyUid}}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Alert Rule

Get one specific alert rule by alertRuleUid.

Parameters

Field Type Required Description
alertRuleUid string required Unique Alert Rule Identification
path Parameters
alertRuleUid
required
string
Example: {{alertRuleUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "alertRuleUid": "9af876c55c17cf13c123261eaac78e59e9d2b5d913a79bf96c",
  • "name": "Test Fry",
  • "companyUid": "7fc1f0cd1b0ae527468fbe6b7a5a98b4cd93872235e11c6aaf",
  • "createdAt": "2021-05-25T18:45:54.983Z"
}

Update Alert Rule

Update one existing alert rule by alertRuleUid.

Parameters

Field Type Required Description
alertRuleUid string required Unique Alert Rule Identification

Body

Field Type Required Description
name string optional New name of the updated alert rule
description string optional New description
alertType string optional Accepted values 'DEVICE', 'POLICY', 'APPLET'
organizationUids array optional Organizations which is checked against the rule
filter object optional Pre-filter of devices which the alert will be checked against. It's used for percentage threshold of alert creation as base. The mandatory filter is organization set above. This is extended filter for example device applicationType (tizen, webos, etc.).
conditions object optional Specify all conditions which devices has to match to state alert as applicable.
threshold object optional Specify threshold of rule. It is comparing number of devices matched the conditions above relatively against the total number devices filtered by filter above
periodicity object optional Specify how often the rule will be checked against the current state of devices.
action object optional Optionally specify the action of alert rule. This action will happen when alert rule is creating an alert.

Filter

Field Type Required Description
applicationType string optional Type of application one of ('sssp', 'tizen', 'webos', 'android', 'chrome', 'brightsign', 'linux', 'windows', 'default' )
applicationVersion array optional Semver comparison of core app version [SemverOperator, string] - ([">", "3.12.0"])
frontDisplayVersion array optional Semver comparison of internal front-display library version[SemverOperator, string] - ([">", "9.15.0"])
firmwareType string optional Partial matching of string
firmwareVersion string optional Partial matching of string
managementPackageVersion array optional Semver comparison of core management package version ([">", "3.12.0"])
frontPackageVersion array optional Semver comparison of core front package version ([">", "3.12.0"])
tagUids string optional List of tags. Device has match all tags in list
model string optional Partial matching of string
name string optional Partial matching of string
extendedManagement boolean optional Filter device with or without extended management
extendedManagement Date optional Filter only devices provisioned since the date
supportedResolutions ResolutionItem optional Filter only devices supporting specified resolution
locationUids array optional Filter only devices in specified locations
locationTagsUids array optional Filter only devices in specified location tags

Conditions

NumericOperator

Operators
>
<
<=
>=
=
!=

TimeRangeOperator

Operators
>
<

Conditions values types

Condition type Type Example
OCCURRENCES_IN_TIME_RANGE_TO_PAST array [operator: NumericOperator, occurrences: number, rangeInPastMs: number] -([">", 12, 36000])
NUMERIC_RANGE array [operator: NumericOperator, nmbr: number] - (">", 12)
STRING_OCCURRENCES_IN_TIME_RANGE_TO_PAST array [str: string, operator: NumericOperator, occurrences: number, rangeInPastMs: number] - ("action", ">" 12, 36000)
TIME_RANGE_TO_PAST array [operator: TimeRangeOperator, rangeInPastMs: number] - ("<", 36000)
PERCENTAGE_RANGE array [operator: NumericOperator, percentage: number] - ("<", 50)
NUMERIC_RANGE array [operator: NumericOperator, nmbr: number] - ("<", 50)
NUMERIC_RANGE string 'DEVICE'
MATCH_SEMVER array [operator: SemverOperator, version: string] - (">", "3.12.0")
STRING_LIST array ["string1", "string2"]
POLICY_LIST string One of ('VOLUME', 'BRIGHTNESS', 'TIMERS', 'PROPRIETARY_TIMERS', 'RESOLUTION', 'ORIENTATION', 'REMOTE_CONTROL', 'APPLICATION_VERSION', 'FIRMWARE_VERSION', 'DEBUG', 'DATETIME', 'POWER_ACTIONS_SCHEDULE', 'TEMPERATURE', 'BUNDLED_APPLET')
WIFI_OR_ETHERNET string One of ('wifi', 'ethernet')
INPUT_SOURCE string One of ('urlLauncher', 'hdmi1', 'hdmi2', 'hdmi3', 'hdmi4')
TIMERS array TimerSettings[]
RESOLUTION object ResolutionItem
ORIENTATION object OrientationSettings

Device condition

Condition Condition values Description
INCORRECT_TIME BOOLEAN Is used when device has incorrect time based on current time & timezone of device
INVALID_SSL_CERTIFICATE BOOLEAN Is used when device is detected having some problems with SSL certificates (it can be even time related)
FAILED_ACTIONS BOOLEAN Is used when device performing/executing action has failed for amount of time in past
CONNECTIONS BOOLEAN Is used when device performing/executing action has failed for amount of time in past
MODEL array BOOLEAN if device has model or not
SERIAL_NUMBER BOOLEAN Check if device has serial number or not
NAME string Check if device partially match some string
PIN_CODE boolean Check if device has PIN code reported
MANAGEMENT_PACKAGE_VERSION MATCH_SEMVER Check if device match semver version
FRONT_PACKAGE_VERSION MATCH_SEMVER Check if device match semver version
FRONT_DISPLAY_VERSION MATCH_SEMVER Check if device match semver version
FIRMWARE_TYPE string Check if device match semver version
TAG_UIDS STRING_LIST Check if device has selected tags
POLICIES POLICY_LIST Check if device has selected policy settings
LAST_PROVISION_AT TIME_RANGE_TO_PAST Check if device was provisioned in specified time range in past. Useful to detect new devices are provisioned
LAST_DEPROVISION_AT TIME_RANGE_TO_PAST Check if device was deprovisioned in specified time range in past. Useful to detect devices are re-provisioned
EXTENDED_MANAGEMENT BOOLEAN Check if device has access to extended management
ALIVE_AT TIME_RANGE_TO_PAST Check if device last ping in specified time range in past
NETWORK_INTERFACES WIFI_OR_ETHERNET Check if device is connected using WiFi or Ethernet
BATTERY_STATUS PERCENTAGE_RANGE Check if device has enough or not enough battery
STORAGE_STATUS PERCENTAGE_RANGE Check if device has or has not enough free storage
CURRENT_TIMEZONE MATCH_STRING Check if timezone match the string
DISPLAY_SETTING_BACKLIGHT PERCENTAGE_RANGE Check if match expected value of display settings
DISPLAY_SETTING_CONTRAST PERCENTAGE_RANGE Check if match expected value of display settings
DISPLAY_SETTING_SHARPNESS PERCENTAGE_RANGE Check if match expected value of display settings
DISPLAY_SETTING_MAX_TEMPERATURE NUMERIC_RANGE Max temperature in celsius
INPUT_SOURCE INPUT_SOURCE Check if current input source is set to specified source
VOLUME PERCENTAGE_RANGE Check if current volume is expected
BRIGHTNESS PERCENTAGE_RANGE Check if current brightness is expected
TIMERS TIMERS Check if current native timers are set as expected
PROPRIETARY_TIMERS TIMERS Check if current proprietary timers are set as expected
RESOLUTION RESOLUTION Check if current resolution is set as expected
ORIENTATION ORIENTATION Check if current orientation is set as expected
REMOTE_CONTROL BOOLEAN Check if current RC is locked or not
APPLICATION_VERSION MATCH_SEMVER Check if current core app version is correct
FIRMWARE_VERSION MATCH_STRING Check if current FW version match some string
DEBUG BOOLEAN Check if debug is enabled or not
POWER_ACTIONS_SCHEDULE SCHEDULED_POWER_ACTIONS Check if current scheduled power actions are correctly set
TEMPERATURE NUMERIC_RANGE Check if current scheduled power actions are correctly set
INSTALLED_PACKAGE MATCH_STRING Check if specified package is installed
SCREENSHOT OCCURRENCES_IN_TIME_RANGE_TO_PAST Check if number of screenshots was received in time
FEATURE_TESTS BOOLEAN Check if feature tests has passed

Policy condition

Condition Condition values Description
POLICY_VIOLATION_VOLUME BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_BRIGHTNESS BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_TIMERS BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_PROPRIETARY_TIMERS BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_RESOLUTION BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_ORIENTATION BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_REMOTE_CONTROL BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_APPLICATION_VERSION BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_FIRMWARE_VERSION BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_DEBUG BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_DATETIME BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_POWER_ACTIONS_SCHEDULE BOOLEAN Check violation of any of existing policy device settings type
POLICY_VIOLATION_TEMPERATURE BOOLEAN Check violation of any of existing policy device settings type

Applet condition

Condition Condition values Description
APPLET_COMMAND STRING_OCCURRENCES_IN_TIME_RANGE_TO_PAST Is used when to check custom user defined commands occurrences in time

Threshold

Field Type Required Description
type string required Currently only percentage implemented - percentage'
percentage number required The number of percent from 0 to 99 (100 is never matched)

Periodicity

Field Type Required Description
interval string required How often alert will be checked against current state in SECONDS'
activeTimeWindows array required Alert rule won't be checked against current state out of specified active time windows when at least one specified. If no active time window specified, alert rule will be checked anytime.

Action

Account alert actions

Action type Type Required Description
type string required All specified accounts are notified using account notification settings' - (type: 'accounts')
accountIds array of accountIds required AccountIds in array, which will be notified about alert

Organization accounts alert actions

Action type Type Required Description
type string required All accounts assigned to organization of creating rule are notified using account notification settings' (type: 'organization_accounts')

Email alert actions

Action type Type Required Description
type string required All accounts assigned to organization of creating rule are notified using account notification settings' (type: 'emailAddresses')
emailAddresses array of emails required Array of email addresses, which will be notified about alert
path Parameters
alertRuleUid
required
string
Example: {{alertRuleUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "My updated Alert rule name",
  • "description": "Some sort of updated",
  • "alertType": "DEVICE",
  • "organizationUids": [
    ],
  • "conditions": {
    },
  • "filter": {
    },
  • "threshold": {
    },
  • "periodicity": 30,
  • "action": {
    }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Archive Alert Rule

Archive one alert rule by alertRuleUid.

Parameters

Field Type Required Description
alertRuleUid string required Unique Alert Rule Identification
path Parameters
alertRuleUid
required
string
Example: {{alertRuleUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
# Empty response

Unarchive Alert Rule

Unarchive one alert rule by alertRuleUid.

Parameters

Field Type Required Description
alertRuleUid string required Unique Alert Rule Identification
path Parameters
alertRuleUid
required
string
Example: {{alertRuleUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Pause Alert Rule

Pause one alert rule by alertRuleUid.

Parameters

Field Type Required Description
alertRuleUid string required Unique Alert Rule Identification
path Parameters
alertRuleUid
required
string
Example: {{alertRuleUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
# Empty response

Unpause Alert Rule

Unpause one alert rule by alertRuleUid.

Parameters

Field Type Required Description
alertRuleUid string required Unique Alert Rule Identification
path Parameters
alertRuleUid
required
string
Example: {{alertRuleUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
# Empty response

BulkProvisioning/Recipe

Create Provision recipe

Creates a new Provision recipe for current Organization

Body

Field Type Required Description
brand string required
seriaNumber string optional
model string optional
macAddress string optional
tagUids string optional List of tags.
deviceName string optional
policyUid string optional Unique policy identification.
locationUid string optional
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "deviceName": "Nice device name",
  • "serialNumber": "1",
  • "macAddress": "12:34:56:78:90:ab",
  • "model": "Good Display LCD",
  • "brand": "Good Display",
  • "tagUids": [
    ],
  • "policyUid": "1234567890c641df0b1a1701a1c6efb93fe053a8faeba5bce2",
  • "locationUid": "123456789071821f914dcfbca02e6a27dd0eaf74b853f108cc"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Provision recipes

Get all provision recipes for current Organization.

query Parameters
limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

search
string
Example: search=TV

search by string contained in model, brand, serialNumber or macAddress

status
string
Enum: "Pending" "Applied"
Example: status=Pending

filter by device status

brand
string
Example: brand=Sony

filter by device brand

tagUids
Array of strings
Example: tagUids={{tagUid}}

filter by list of tags

policyUids
Array of strings
Example: policyUids={{policyUid}}

filter by list of policies

locationUid
string
Example: locationUid={{locationUid}}

filter by location

model
string
Example: model=LGE-55SM5C-BF-1

filter by device model matching

macAddress
string
Example: macAddress=12:34:56:78:90:ab

filter by device mac address

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get Provision recipe

Get Provision recipe for current Organization by recipeUid.

Parameters

Field Type Required Description
recipeUid string required
path Parameters
recipeUid
required
string
Example: {{recipeUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": "Pending",
  • "uid": "1234567890c7dbe8ccd61e80e30d46b12902",
  • "organizationUid": "1234567890423d4171e348d6a1a1222e3b0075c8d7ebac868a",
  • "model": "Good Display LCD",
  • "brand": "Good Display",
  • "macAddress": "12:34:56:78:90:ab",
  • "serialNumber": "1"
}

Update Provision recipe

Update existing Provision recipe for current Organization

Parameters

Field Type Required Description
recipeUid string required

Body

Field Type Required Description
brand string optional
seriaNumber string optional
model string optional
macAddress string optional
tagUids string optional List of tags.
deviceName string optional
policyUid string optional Unique policy identification.
locationUid string optional
path Parameters
recipeUid
required
string
Example: {{recipeUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "deviceName": "Different name",
  • "model": "Bad Display LCD"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Delete Provision recipe

Delete Provision recipe for current Organization by recipeUid.

Parameters

Field Type Required Description
recipeUid string required
path Parameters
recipeUid
required
string
Example: {{recipeUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Upload provisioning recipes via CSV file

Creates a new Provision recipes for current Organization by uploading CSV file

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Request Body schema: text/csv
string <binary>

Responses

Response samples

Content type
application/json
{
  • "message": "OK",
  • "linesProcessed": 2
}

Device

Device is any digital signage display, player, Windows machine, Raspberry Pi 3, and Raspberry Pi 4. You can see all supported devices here

No matter what device you are using, the APIs are standardized across all of them.

Get Devices v1 Deprecated

This endoint is deprecated and will be removed in the future. Use Get Devices v2 instead.

Get all devices for current Organization.

Parameters

Field Type Required Description
applicationType string - ‘sssp’ , ‘tizen’ , ‘webos’ , ‘android’ , ‘linux’ , ‘default’
optional
 one of supported applicationTypes
search string
optional
 search by string contained in uid, duid, name of device, serial number, MAC address or verification hash
model string
optional
 filter by device model matching
pagination number greater than 0
optional
 Start paginating result by a given number of items on the page. Next page link is available in the response header Link.

E.g.: <https://api.signageos/v1/device?pagination=50&createdUntil=2020-10-22T16%3A10%3A00.000Z>; rel="next"
createdSince string
optional
 filter by device createdAt greater than or equal (inclusive) date time in ISO-8601 format.
createdUntil string
optional
 filter by device createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).

Important note

For Organizations with more than 500 devices, we strongly recommend using pagination.

query Parameters
pagination
integer
Example: pagination=50

Start paginating result by given number items on page. Next page link is available on in response under header Link. E.g.: <https://api.signageos/v1/device?pagination=50&createdUntil=2020-10-22T16%3A10%3A00.000Z>; rel="next"

applicationType
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: applicationType=webos

filter by application type

search
string
Example: search=Marge

search by string contained in uid, duid or name of device

model
string
Example: model=LGE-55SM5C-BF-1

filter by device model matching

createdSince
string
Example: createdSince=2017-08-02T13:45:39.000Z

filter by device createdAt greater than or equal (inclusive) date time in ISO-8601 format.

createdUntil
string
Example: createdUntil=2017-08-02T13:45:40.000Z

filter by device createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get Devices v2

Get all devices for current Organization.

This endpoint uses pagination. For more information view Pagination section. Max allowed page size is 1000.

query Parameters
applicationType
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: applicationType=tizen

filter by application type

search
string
Example: search=Marge

search by string contained in uid, duid or name of device

model
string
Example: model=LGE-55SM5C-BF-1

filter by device model matching

brand
string
Example: brand=Sony

filter by device brand

osVersion
string
Example: osVersion=6.5

filter by device OS version

serialNumber
string
Example: serialNumber=EQK70AAY72Y8

filter by serial number

firmwareVersion
string
Example: firmwareVersion=4.3.0

filter by firmware version

locationUid
string
Example: locationUid={{locationUid}}

filter by location

appletUids
Array of strings
Example: appletUids={{appletUid}}

filter by list of applets

policyUids
Array of strings
Example: policyUids={{policyUid}}

filter by list of policies

tagUids
Array of strings
Example: tagUids={{tagUid}}

filter by list of tags

alertUid
string
Example: alertUid={{alertUid}}

filter by alert

hasPolicy
boolean
Example: hasPolicy={{hasPolicy}}

filter if device is assigned to any policy or not

limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get Device v1 Deprecated

This endoint is deprecated and will be removed in the future. Use Get Device v2 instead.

Get one device detail by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
applicationType string/Enum optional One of supported applicationTypes

tizen, webos, android, linux, brightsign, windows
search string optional Search by string contained in uid, duid, name of device, serial number, MAC address or verification hash
model string optional Filter by device model matching
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "750dbe59c81b60170b3c2b10650fb200cc82d34e6b0120fc344322",
  • "duid": "a69a6f99f89fa3c9df73759c2fca2164f2e695260fef5d234232e",
  • "name": "Test Emulator",
  • "createdAt": "2021-04-07T16:11:13.485Z",
  • "aliveAt": "2021-04-10T13:54:38.226Z",
  • "pinCode": "0000",
  • "applicationType": "default",
  • "applicationVersion": "8.7.0",
  • "frontDisplayVersion": "8.7.0",
  • "firmwareVersion": "Chrome-89.0.4389.114",
  • "model": "Win32",
  • "serialNumber": "5A1FC776B031",
  • "brand": "signageOS",
  • "osVersion": "1.0.0",
  • "organizationUid": "f4dc889c5bfae798bd652e5d0989e6805d45131b75305fba4c",
  • "networkInterfaces": {
    },
  • "storageStatus": {
    },
  • "connections": [ ],
  • "batteryStatus": null,
  • "currentTime": {
    }
}

Update Device Name Deprecated

This endpoint is deprecated and will be removed in the future. Use v2 PUT Configure Device instead. Update one device by deviceUid - Set device name.

Parameters

Field Type Required Description
deviceUid string
required
 unique device identification

Body

Field Type Description
name string device name, eg. Reception Display
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/x-www-form-urlencoded
name
string

device name, eg. Reception Display

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device v2

Get one device detail by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "c0752280cc7d009c57422be6927b660d7d71456d76b5e2dgdfgdfgd",
  • "duid": "2221b195b6350a6c71318e56e4d493a585f42b6d9c387wqqww334",
  • "name": "Test Emulator",
  • "createdAt": "2021-04-18T22:26:39.405Z",
  • "applicationType": "default",
  • "firmwareVersion": "Chrome-89.0.4389.114",
  • "model": "Linux x86_64",
  • "serialNumber": "EQK70AAY72Y8",
  • "organizationUid": "f4dc889c5bfae798bd652e5d0989e6805d45131b753dwwfgrte",
  • "locationUid": "qn7tks6io6vckl59hxpnmgbzdzxwob3xsh0ezowsqi8cox08o3",
  • "connectionMethod": "websocket"
}

Configure Device

Configure Device by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
string
connectionMethod
string
Enum: "websocket" "http"
platformUri
string
staticBaseUrl
string
uploadBaseUrl
string
weinreUri
string
extendedManagementUrl
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "connectionMethod": "websocket",
  • "platformUri": "string",
  • "staticBaseUrl": "string",
  • "uploadBaseUrl": "string",
  • "weinreUri": "string",
  • "extendedManagementUrl": "string"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Authentication Hash

Get authentication contains the authHash for device by deviceUid.

Get device Authentication Hash which is used for device-CMS authentication.

Parameters

Field Type Required Description
deviceUid string required device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "9c83b5e07ee0991dce1216e2ba0338d454f1da7d4f8440676dwdaww",
  • "authHash": "auth-hash-key",
  • "createdAt": "2021-04-25T19:28:05.835Z"
}

Get Device by Authentication Hash

Get device by Authentication Hash which is used for device-CMS authentication by authHash. JS api sos.authHash JS API Basics.

Parameters

Field Type Required Description
authHash string
required
 device autHash from applet (can be used only 6 or more first characters of authHash)
path Parameters
deviceAuthHash
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "9c83b5e07ee0991dce1216e2ba0338d454f1da7d4f84406dwewwq",
  • "authHash": "device-auth-hash",
  • "createdAt": "2021-04-25T19:28:05.835Z"
}

Device/ActionLog (Device History)

Get device history

Action log includes complete history of actions performed with the device as well as the action originator (user/api) and the result. You can see the Action log in a History tab on device detail page in Box.

Parameters

Field Type Required Description
deviceUid string
required
 unique device identification
descending boolean
optional
 true or false
limit number
optional
 limit the number of returned results
since timestamp
optional
 limit result by date and time
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Device/Application Version and update

To use any of the supported devices, you need the signageOS Core App. signageOS Core Apps are a natively-built application for various platforms allowing you to run your HTML5/JS application (aka Applet).

Get latest Device Application Version Changes

Get latest Device Application Versions Changes which are sorted by device creation date.

query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

organizationUids
Array of strings

Filter by Organization UIDs

deviceUids
Array of strings
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update Core App Version

Request upgrade of the signageOS Core App version by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
applicationType
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: {{applicationType}}

Available supported application types. Type "chrome" refers to legacy Chrome OS application, which was discontinued and is deprecated. Use "chromeos" for the current Chrome OS application.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
version
required
string

Responses

Request samples

Content type
application/json
{
  • "version": "{{applicationVersion}}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get History of Device Application Version Changes

Get History of Device Application Version Changes by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get latest Device Application Version Change

Get latest Device Application Version Change by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "ecdd1c06f9203314659dc438085dbe63fbfce951ef1dcbb0d4",
  • "deviceUid": "33bc149a44a3948a57a8b7083fe73fb17d5fe98d6066d86cb1",
  • "createdAt": "2021-04-25T20:23:47.344Z",
  • "succeededAt": "2021-04-25T20:23:47.793Z",
  • "failedAt": null,
  • "version": "8.10.0",
  • "applicationType": "default"
}

Count Device Application Version Changes

Count how many times Application Version was changed

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Device/Applet Command

Create Applet Command

Create device applet command by deviceUid & appletUid which will be delivered to device current active applet.

Command may contain any number of custom properties. The only required one is type which is used to identify the command.

Originally the command was sent using the commandPayload field, which is now deprecated. The command field should be used instead.

Once the command is sent, it can be received inside the applet using the following customField:

sos.command.onCommand((commandEvent) => {
  if (commandEvent.command.type === 'TestCommand') {
    console.log(commandEvent.command.customField)
  }
});

For more information, refer to the JS API documentation.

Parameters

Field Type Required Description
deviceUid string required Device unique identification
appletUid string required Applet unique identification
path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
required
object

Command object. Must contain at least type. May contain any number of custom properties.

type
required
string
property name*
additional property
any

Responses

Request samples

Content type
application/json
{
  • "command": {
    }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Applet Commands

Get commands by deviceUid and appletUid.

Max allowed page size is 200

Device applet commands are available for the previous 3 days. Historical data of all commands is available as ZIP dump at Get Device Reports (Uptime, Applet Commands) endpoint: https://developers.signageos.io/api/#tag/DeviceMonitoring/paths/~1v1~1device~1%7BdeviceUid%7D~1report/get .

Parameters

Field Type Required Description
deviceUid string <div class="red">required
device unique identification appletUid string <div class="red">required
applet unique identification type string <div class="yellow">optional
your log type - e.g.: MyCms.Content.PlayVideo receivedSince Date <div class="yellow">optional
get all commands since exact date (included) receivedUntil Date <div class="yellow">optional
get all commands till exact date (excluded)

This endpoint uses pagination. For more information view Pagination section.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Applet Commands

Get all device applet commands by deviceUid.

Max allowed page size is 200

Device applet commands are available for the previous 3 days. Historical data of all commands is available as ZIP dump at Get Device Reports (Uptime, Applet Commands) endpoint: https://developers.signageos.io/api/#tag/DeviceMonitoring/paths/~1v1~1device~1%7BdeviceUid%7D~1report/get .

Parameters

Field Type Required Description
deviceUid string <div class="red">required
device unique identification appletUid string <div class="yellow">optional
applet unique identification type string <div class="yellow">optional
your log type - e.g.: MyCms.Content.PlayVideo receivedSince Date <div class="yellow">optional
get all commands since exact date (included) receivedUntil Date <div class="yellow">optional
get all commands till exact date (excluded)

This endpoint uses pagination. For more information view Pagination section.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Applet Command By Command UID

Get one device applet command by deviceUid, appletUid & timingCommandUid.

Get commands – information on how the device operates or was set – for the specific device. You can access all device logs, including your custom logs, within this API call.

Device applet commands are available for the previous 3 days. Historical data of all commands is available at Data report CSV dump.

Parameters

Field Type Required Description
deviceUid string required Device unique identification
appletUid string required applet unique identification
commandUid string required Command unique identification

This endpoint uses pagination. For more information view Pagination section.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

commandUid
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Device/Brightness

Update Device Brightness

Request change device brightness by deviceUid.

Parameters

Field Type Required Description
deviceUid string <div class="red">required
device application id

Body

Field Type Description
brightness1 number device brightness in percent 0-100
timeFrom1 HH:MM:SS starting time for brightness 1
brightness2 number device brightness in percent 0-100
timeFrom2 HH:MM:SS starting time for brightness 2
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "brightness1": 90,
  • "timeFrom1": "09:00:00",
  • "brightness2": 40,
  • "timeFrom2": "20:00:00"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Brightness

Get requested device brightness changes by deviceUid.

Parameters

Field Type Required Description
deviceUid string required device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Device/Debug

Set Device Debug

Request begin device debug mode by deviceUid. Set debug flag for device to enable remote debugging.

Parameters

Field Type Required Description
deviceUid string required Device application id

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
appletEnabled boolean Enable weinre for device inside Applet
nativeEnabled boolean Enable native debug

Note 1

Applet debug settings is only on-demand. So when you set it, the inspection tool is started. Once you do the REBOOT, RESTART, RELOAD or REFRESH power action, the tool is stopped & you must set debug again (turn it off then on again in BOX).

Note 2

Native debug settings behavior differs in every device OS brand (SSSP, Tizen, WebOS1,2+, Android etc.). Here are mentioned a little differences however for more info you can look at official documentation of display manufacturer.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "appletEnabled": true,
  • "nativeEnabled": false
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Debug

Get begin device debug mode requests by deviceUid

Parameters

Field Type Required Description
deviceUid string <div class="red">required
device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Device/Firmware

Update Device Firmware

Request change device firmware version by deviceUid.

Set/upgrade Firmware version of a device.

Parameters

Field Type Required Description
deviceUid string required Device uid

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
version string ex.: T-HKMLAKUC-2020.5 Version of FW you want to upgrade to. Versions layout differs vendor to vendor.
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "version": "x86_64"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Firmware

Get last changed device firmware version requested to deviceUid. Get Firmware version last successfully sent to the device.

Parameters

Field Type Required Description
deviceUid string required device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "DEVICE_CREATE_UID:d342377e18f83bc08d76c44e8b35c05c4e786f2bd3f7aeb42d",
  • "deviceUid": "c0752280cc7d009c57422be6927b660d7d71456d76b5e2c9613bc",
  • "createdAt": "2021-04-18T22:26:39.405Z",
  • "succeededAt": null,
  • "failedAt": null
}

Device/Monitoring

Get Device Hourly Connected Status

DEPRECATED in favor of:

https://developers.signageos.io/api/#tag/DeviceMonitoring/paths/1v11device1%7BdeviceUid%7D1report/get

and

https://developers.signageos.io/api/#tag/DeviceApplet-Command

Get all device connected status grouped hourly by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Device unique identification
from Date optional Get all statistics from exact date (included)
to Date optional Get all statistics to exact date (included)
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Device Reports (Uptime, Applet Commands)

Get all device report files by deviceUid.

Get Report files – historical data containing Device Applet commands, Applet Ready events, Connected/Disconnected actions.

Parameters

Field Type Required Description
deviceUid string required device unique identification
createdSince Date optional get all reports since exact date (included)
createdUntil Date optional get all reports till exact date (excluded)
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
createdSince
string
Example: createdSince=2016-08-02T13:45:39.000Z

get all reports since exact date (included)

createdUntil
string
Example: createdUntil=2017-08-02T13:45:39.000Z

get all reports till exact date (excluded)

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[]

Get Device Temperature

Get all device temperature logs by deviceUid.

Get logs of device temperature in time.

Parameters

Field Type Required Description
deviceUid string required Device unique identification
createdSince Date optional Get all temperature logs since exact date (included) - Example: 2018-09-09T10:49:33.352Z
createdUntil Date optional Get all temperature logs until exact date (excluded) - Example: 2018-09-10T10:49:33.352Z
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Device/Offline Range (coming soon)

Get Offline Ranges

This endpoint is in development.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
limit
integer
Example: limit=1
since
string
Example: since=2017-08-02T13:45:40.000Z
until
string
Example: until=2022-12-02T13:45:40.000Z
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Device/Organization

Set Device Organization

This method sets device to a selected organization by organizationUid.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
Content-Type
string
Example: application/json
x-auth
string
Example: {{x-auth-account}}

Replace by token of your account common for both organizations

Request Body schema: application/json
organizationUid
string

Organization UID

Responses

Request samples

Content type
application/json
{
  • "organizationUid": "{{organizationUid}}"
}

Response samples

Content type
text/plain
# Empty response

Device/Orientation and Resolution

Set Device Orientation and Resolution

This method is used for setting device orientation and resolution. Just send desired orientation and resolution.

Parameters

Field Type Required Description
deviceUid string required device application id

Body

content-type: application/json or application/x-www-form-urlencoded

Recommended usage:

Field Type Description
orientation string - ‘PORTRAIT’ ‘PORTRAIT_FLIPPED’ ’LANDSCAPE’ ‘LANDSCAPE_FLIPPED’ ‘AUTO’ must be in uppercase set device orientation to portrait, landscape or auto. Auto works only for tablets with gyroscope.
size JSON
`{ "width": 1920, "height": 1080 }`		 set specific device resolution, only for external players and devices supporting specific resolutions (BrightSign, Windows, selected Android players)
To be used in combination with orientation field and possibly framerate field on supported device (BrightSign). resolution field needs to be omitted.
framerate number - 60 specify exact video output framerate, only for BrightSign. To be used in combination with size and orientation field.

Legacy usage:

Field Type Description
orientation string - ‘PORTRAIT’ ‘PORTRAIT_FLIPPED’ ’LANDSCAPE’ ‘LANDSCAPE_FLIPPED’ ‘AUTO’ must be in uppercase set device orientation to portrait, landscape or auto. Auto works only for tablets with gyroscope.
resolution string ‘FULL_HD’ ‘HD_READY’ must be in uppercase set device resolution.
Deprecated method to set resolution, framerate field is ignored if used in combination with this method
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "orientation": "LANDSCAPE",
  • "size": {
    },
  • "framerate": 60
}

Response samples

Content type
application/json
Example
{
  • "message": "OK"
}

Get Device Orientation and Resolution

Get change device resolution requests by deviceUid

This method is used to get orientation and resolution you set to the device.

Parameters

Field Type Required Description
deviceUid string required Device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Device/Packages

Install Device Package

Install a package with specific version to device by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Device application id

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Required Description
packageName string required PackageName of package to install
version string required Version (typically semver) of package to install
build string optional Build tag of package version to install. Typically architecture (arm, x386, x64 or versionCode for Android)
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "packageName": "com.google.android.webview",
  • "version": "1.0.0",
  • "build": "1000000000"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Installed Device Packages

Get package installs for device by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Start Installed Device Package

Start specified package installation on device by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Device application id
packageName string required Name of the package to start
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
packageName
string
Example: packageName={{packageName}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Started Device Packages

Get package starts for device by deviceUid

Parameters

Field Type Required Description
deviceUid string required Device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Device/Pin code and security

Get Device Pin

Get device PIN code if already exists by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique device identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "device-uid",
  • "pinCode": "8379"
}

(coming soon)

A request to the device to refresh the pin. A new pin will then be sent back from the device to the server asynchronously and will eventually be available to GET.

Parameters

Field Type Required Description
deviceUid string required Unique device identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/Policy

Get Device Policies

Get policies currently assigned to the device by deviceUid.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Assign Policy to Device

Assign policy to device by deviceUid and policyUid.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification

Body

Field Type Required Description
uid string Required Uid of Policy to be assigned to the Device
priority number Required Priority of the policy regarding the Device. Higher the number higher the priority. If multiple policies assigned conflicting policy item will be set by the Policy with higher priority.
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "uid": "{{policyUid}}",
  • "priority": 1
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Policy

Get detail of policy assigned to the device by deviceUid and policyUid.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
policyUid string Required Unique Policy Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
policyUid
required
string
Example: {{policyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "7a4741c842c86c7221ac662899272f7467ecbf30fb8dea5bf1",
  • "name": "Brightness",
  • "createdAt": "2021-06-16T07:51:06.917Z",
  • "items": [
    ],
  • "note": "New policy created"
}

Unassign Policy from Device

Unassign Policy from Device by deviceUid.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
policyUid string Required Unique Policy Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
policyUid
required
string
Example: {{policyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/Policy Status

Policy status provides list of Device Policies assigned to the device.

You get the exact Policy used and list of settings this policy affects (e.g.: volume, brightness, timers,...)

Get Device Policy Status

Get active policy properties assigned on a device by deviceUid, policyUid and itemtype.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
policyUid string Required Unique Policy Identification
itemType string Required Type of policy e.g. VOLUME.
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
policyUid
required
string
Example: {{policyUid}}
itemType
required
string
Example: BRIGHTNESS
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "b8d99e785d90251a459e838888b0649c8754bf77f50b02c18b671",
  • "policyUid": "7a4741c842c86c7221ac662899272f7467ecbf30fb8dea5bf1",
  • "itemType": {
    },
  • "updatedAt": "2021-06-16T07:51:06.917Z"
}

Get Device Policy Status List

Get a list of all active policy properties assigned on a device by deviceUid, policyUid and itemType.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
policyUid string Required Unique Policy Identification
itemType string Required Type of policy e.g. VOLUME.
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
policyUid
string
Example: policyUid={{policyUid}}
itemType
string
Example: itemType=BRIGHTNESS
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "b8d99e785d90251a459e838888b0649c8754bf77f50b02c18b671",
  • "policyUid": "7a4741c842c86c7221ac662899272f7467ecbf30fb8dea5bf1",
  • "itemType": [
    ],
  • "updatedAt": "2021-06-16T07:51:06.917Z"
}

Device/Alive

Get Devices Last Alive

Get list of datetimes, when the devices were last active, for all or list of selected devices in the current organization.

This endpoint uses pagination. For more information view Pagination section.

query Parameters
deviceUids
Array of strings
Deprecated
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section. This parameter is deprecated and will be removed in the future. Use deviceUids in body instead.

limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
deviceUids
Array of strings

Use it for filtering devices by their uids. If the property is specified in parameters the body will take precedence.

Responses

Request samples

Content type
application/json
{
  • "deviceUids": [
    ]
}

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get Device Last Alive

Get the datetime, when the device was last active for a device in current organization.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "ca6319cdf9bbf8ad41001a9c04e54ad13f76cc45d7c80e78a21b8",
  • "createdAt": "2022-01-01T10:00:00.000Z",
  • "aliveAt": "2022-01-02T10:00:00.000Z"
}

Device/Applet

Get Applets assigned to a device

Get all applets assigned to a device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
active
string
Enum: "0" "1" "false" "true"

Filter by active status

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Assign an applet to a device

Assign an applet to a device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
required
appletUid
required
string

unique identifier of the applet

appletVersion
required
string

version of the applet

object
Default: {}

custom configuration that will be passed to the applet

active
boolean
Default: true

Set true, if the applet should be immediately made active. This will deactivate all other applets for the device.

Responses

Request samples

Content type
application/json
{
  • "appletUid": "5c6e6ba12d1f07811c9ec96433868010bd92ef9d0daf8c7807",
  • "appletVersion": "1.0.0",
  • "configuration": {
    },
  • "active": true
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Applet Assignment

Get one applet assignment for a device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
assignmentUid
required
string
Example: {{assignmentUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "uid": "87c7d3391241356f9a7088c70ab6827852077f54ee655eaea9",
  • "deviceUid": "42e454d7db4dd54660a4250888b0c73414ef75e33077c51453142",
  • "appletUid": "5c6e6ba12d1f07811c9ec96433868010bd92ef9d0daf8c7807",
  • "appletVersion": "1.0.0",
  • "createdAt": "2021-11-15T13:02:37.833Z",
  • "updatedAt": "2021-11-15T13:02:37.833Z",
  • "configuration": {
    },
  • "active": true
}

Update Applet Assignment

Update an applet assignment for a device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
assignmentUid
required
string
Example: {{assignmentUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
appletVersion
string

version of the applet

object

custom configuration that will be passed to the applet

active
boolean

Set true, if the applet should be made active. This will deactivate all other applets for the device.

Responses

Request samples

Content type
application/json
{
  • "appletVersion": "1.0.0",
  • "configuration": {
    },
  • "active": true
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Delete Applet Assignment

Delete an applet assignment from device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
assignmentUid
required
string
Example: {{assignmentUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/Power Actions

Reboot, restart, refresh the device

Create Device Power Action

Perform device power action by deviceUid.

Send Power action to a device – restart, shutdown/turn off, turn on, restart an android app, refresh applet and reload applet.

  • APP_RESTART – Restart App on the display and clear HTML caches
  • SYSTEM_REBOOT – Restart device
  • APPLET_RELOAD – Hard reload of saved content and files
  • APPLET_REFRESH – Soft refresh of an applet (like F5)
  • DISPLAY_POWER_ON – Turn on display (not chip)
  • DISPLAY_POWER_OFF – Turn off display (not chip)
  • APPLET_DISABLE – Disable applet for the current session and show basic device info
  • APPLET_ENABLE – Enable applet again for the current session and show the current applet

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
devicePowerAction string - ‘APP_RESTART’ ‘SYSTEM_REBOOT’ ‘APPLET_RELOAD’ ‘APPLET_REFRESH’ ‘DISPLAY_POWER_ON’ ‘DISPLAY_POWER_OFF’ ‘APPLET_DISABLE’ ‘APPLET_ENABLE’ the Power action type, UPPERCASE
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "devicePowerAction": "APP_RESTART"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Performed Device Power Actions

Get all performed device power actions by deviceUid

Get Power actions sent to the device – restart, shutdown/turn off, turn on, restart the android app, refresh applet and reload applet.

  • APP_RESTART – Restart APP on the display and clear HTML caches;
  • SYSTEM_REBOOT – Restart device
  • APPLET_RELOAD – Hard reload of saved content and files
  • APPLET_REFRESH – Soft refresh of the applet (like F5)
  • DISPLAY_POWER_ON – Turn on display (not chip)
  • DISPLAY_POWER_OFF – Turn off the display (not chip)
  • APPLET_DISABLE – Disable applet for the current session and show basic device info
  • APPLET_ENABLE – Enable applet again for the current session and show the current applet

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Device Scheduled Power Action

Set device scheduled power action by deviceUid.

Schedule new power action.

  • APP_RESTART – Restart APP on the display and clear HTML caches;
  • SYSTEM_REBOOT – Restart device
  • APPLET_RELOAD – Hard reload of saved content and files
  • APPLET_REFRESH – Soft refresh of the applet (like F5)
  • DISPLAY_POWER_ON – turn on display (not chip)
  • DISPLAY_POWER_OFF – Turn off the display (not chip)
  • APPLET_DISABLE – Disable applet for the current session and show basic device info
  • APPLET_ENABLE – Enable applet again for the current session and show current applet

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
powerAction string ‘APP_RESTART’ ‘SYSTEM_REBOOT’ ‘APPLET_RELOAD’ ‘APPLET_REFRESH’ ‘DISPLAY_POWER_ON’ ‘DISPLAY_POWER_OFF’ ‘APPLET_DISABLE’ ‘APPLET_ENABLE’ the Power action type, UPPERCASE
weekdays (weekdays[0] - for x-www-form-urlencoded) string[] ‘MONDAY’ ‘TUESDAY’ ‘WEDNESDAY’ ‘THURSDAY’ ‘FRIDAY’ ‘SATURDAY’ ‘SUNDAY’ List of weekdays when the power action should be triggered, UPPERCASE
time string - HH:MM:SS Time in 24 hour format, when the power action should be triggered
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "powerAction": "APP_RESTART",
  • "time": "12:45:00",
  • "weekdays": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Scheduled Power Actions

Get all set device scheduled power actions by deviceUid.

Parameters

Field Type Required Description
deviceUid string Required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete Device Scheduled Power Action

Delete or cancel scheduled power action on a device by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
scheduledPowerActionUid string required Scheduled power action id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
scheduledActionUid
required
string
Example: {{scheduledActionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/Provisioning, Adding and removing devices

Deprovision/remove Device

Unpair device by device UID and reset content Deprovision device (removes device organization and removes device verification).

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
""

Response samples

Content type
application/json
{
  • "message": "OK"
}

Deprovision/remove Device

This endpoint allows you to securely deprovision a signageOS device using its authHash. It is especially useful in cases where the user has physical access to the device, but does not have access to the signageOS account under which the device was originally provisioned. When to Use This Endpoint:

  • You have a “lost” or “orphaned” device that was previously provisioned under a different signageOS account.
  • You physically control the device, but don’t have access to its current provisioning record in the signageOS platform.
  • You are using a custom recovery Applet or utility to retrieve the device’s authHash directly via the sos.authHash property in the JavaScript SDK.
  • You need to reset or reclaim ownership of a device to provision it under a new account.
  • How to deprovision device via Box or REST API Attention: this endpoint requires your Account token. You cannot use organization token.
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
required
authHash
required
string

unique device identification

Responses

Request samples

Content type
application/json
{
  • "authHash": "5c6e6ba12d1f07811c9ec96433868010bd92ef9d0daf8c7807"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Verify Device via Verification Hash

Register device to your account by sending Verification Hash.

When a device is successfully verified & paired with an organization. The request returns response code 201. Additionally in response Header Location will be available link to just verified device verification resource.

Parameters

Field Type Required Description
none

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
verificationHash string Verification hash generated on screen during deployment
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "verificationHash": "{{verificationHash}}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Verification

Get device verification containing hash by deviceVerificationUid.

Parameters

Field Type Required Description
deviceVerificationUid string required Unique device verification identification
path Parameters
deviceVerificationUid
required
string
Example: {{deviceVerificationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "d2f3e255fad2dd6f3e12f0f16dc594fe99654fec351f3fa338",
  • "createdAt": "2021-05-04T10:38:54.483Z",
  • "deviceUid": "e3f9f4291feff2dc0ee17319f1cdab15fb41007bbd0cd5c37a244",
  • "hash": "e0a7fe",
  • "verifiedAt": "2022-02-22T16:34:42.518Z"
}

Device/Kiosk mode & IR Remote Control

Update Device Kiosk Mode/IR Remote Control

This endpoint enables/disables the IR Remote Control sensor on the SoC devices & locks/unlocks Android devices Kiosk mode.

If you want to disable IR Remote Control sensor to prevent anyone from controlling your device over IR remote control or if you want to lock tablet into kiosk mode.

Android Device Attention Required:

In order to prevent Android from displaying Android homepage and thus not showing your content, you must Enable Kiosk Mode (= Lock Remote Control) either through Box device settings or through API.

Always set the Remote Control to enabled=false via this REST API or in Box on the device detail's Settings tab.

Parameters

Field Type Required Description
deviceUid string required device application id

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
locked boolean FALSE – device is unlocked (possible to use IR control and kiosk mode is disabled)
TRUE – device is locked (no IR control, kiosk mode enabled)
kiosk boolean alias to locked
enabled boolean DEPRECATED - TRUE – device is unlocked (possible to use IR control and kiosk mode is disabled)
FALSE – device is locked (no IR control, kiosk mode enabled)
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "locked": false
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Kiosk Mode / IR Remote Control Status

If you want to know if you disabled IR Remote Control or if you locked the tablet into kiosk mode.

locked

  • FALSE, IR Remote Control is UNLOCKED, you can use it to adjust device settings, KIOSK mode is disabled
  • TRUE, IR Remote Control is LOCKED, it is not possible to use it, KIOSK mode is enabled

kiosk

  • alias to locked

enabled DEPRECATED

  • TRUE, IR Remote Control is UNLOCKED, you can use it to adjust device settings, KIOSK mode is disabled
  • FALSE, IR Remote Control is LOCKED, it is not possible to use it, KIOSK mode is enabled

Parameters

Field Type Required Description
deviceUid string required device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Device/Location

Get Location for Device

Get Location for Device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
locationUid
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "string",
  • "name": "string",
  • "feature": {
    },
  • "city": "string",
  • "countryCode": "string",
  • "organizationUid": "string",
  • "customId": "string",
  • "attachments": [
    ],
  • "description": "string",
  • "tagUids": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "deletedAt": "2019-08-24T14:15:22Z",
  • "deletedBy": {
    }
}

Assign Device to Location

Assign Device to Location

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
locationUid
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Unassign Location from Device

Unassign Location from Device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
locationUid
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Device/Screenshots

Get Last Screenshot By Devices

Get list of last screenshots. One screenshot for each listed device in current organization. If device doesn't have any screenshots, it will be skipped. If device has disabled screen capture, it will be skipped.

This endpoint uses pagination. For more information view Pagination section.

query Parameters
limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

deviceUids
Array of strings
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section.

organizationUids
Array of strings

Filter by Organization UIDs

uids
Array of strings

Filter by UIDs

aHash
string
Example: aHash=a234dasgpio4r23gdsagwpio

Average hash of image

dHash
string
Example: dHash=a234dasgpio4r23gdsagwpio

Difference hash of image

pHash
string
Example: pHash=a234dasgpio4r23gdsagwpio

Perceptual hash of image

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Count Last Screenshot By Devices

Get count of last screenshots. One screenshot for each listed device in current organization. If device doesn't have any screenshots, it will be skipped. If device has disabled screen capture, it will be skipped.

This endpoint uses pagination. For more information view Pagination section.

query Parameters
limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

deviceUids
Array of strings
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section.

organizationUids
Array of strings

Filter by Organization UIDs

aHash
string
Example: aHash=a234dasgpio4r23gdsagwpio

Average hash of image

dHash
string
Example: dHash=a234dasgpio4r23gdsagwpio

Difference hash of image

pHash
string
Example: pHash=a234dasgpio4r23gdsagwpio

Perceptual hash of image

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Request New Device Screenshot

Request to take live screenshots from the device by deviceUid. You can obtain extra screenshots at any time and it will be shown in a standard list of taken screenshots.

The request will fail if the device has disabled screen capture.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Screenshots

Get live screenshots from the device by deviceUid. Usually, we take screenshots automatically every 6 minutes. But you can obtain extra screenshots at any time.

The request will fail if the device has disabled screen capture.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
takenSince
string <date-time>
Example: takenSince={{takenSince}}

Fetch data since this parameter.

takenUntil
string <date-time>
Example: takenUntil={{takenUntil}}

Fetch data until this parameter.

aHash
string
Example: aHash=a234dasgpio4r23gdsagwpio

Average hash of image

dHash
string
Example: dHash=a234dasgpio4r23gdsagwpio

Difference hash of image

pHash
string
Example: pHash=a234dasgpio4r23gdsagwpio

Perceptual hash of image

limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Count Device Screenshots

Get count of live screenshots from the device by deviceUid. Usually, we take screenshots automatically every 6 minutes. But you can obtain extra screenshots at any time.

The request will fail if the device has disabled screen capture.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
takenSince
string <date-time>
Example: takenSince={{takenSince}}

Fetch data since this parameter.

takenUntil
string <date-time>
Example: takenUntil={{takenUntil}}

Fetch data until this parameter.

aHash
string
Example: aHash=a234dasgpio4r23gdsagwpio

Average hash of image

dHash
string
Example: dHash=a234dasgpio4r23gdsagwpio

Difference hash of image

pHash
string
Example: pHash=a234dasgpio4r23gdsagwpio

Perceptual hash of image

limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Device/Storage

Get Device Storage

Get Current storage status of free, used & total memory in internal & external storage by deviceUid.

Returned values are in Bytes.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "internal": {
    },
  • "removable": {
    },
  • "updatedAt": "2021-04-25T22:22:42.198Z"
}

Device/Tests

Put Device Feature Test

Sets device feature tests by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "tests": [
    ]
}

Response samples

Content type
text/plain
# Empty response

Get Device Feature Test

Get the latest device feature tests by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "f4a08a660c9e935abad3679001eff5646bfa657d5365aabf48749",
  • "pendingTests": [ ],
  • "successfulTests": [
    ],
  • "failedTests": [
    ],
  • "testResults": {
    },
  • "createdAt": "2022-02-22T17:57:12.433Z",
  • "finishedAt": "2022-02-22T17:57:46.024Z"
}

Put Device Applet Test with Applet UID and Applet Version

Sets applet tests by deviceUid, appletUid and appletVersion.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
appletUid string required Unique Applet Identification
appletVersion string (semver) required Applet version e.g. 2.0.1
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "tests": [
    ]
}

Response samples

Content type
text/plain
# Empty response

Get Device Applet Test By UID And Applet Version

Gets the latest applet test results by deviceUid, appletUid and appletVersion.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
appletUid string required Unique Applet Identification
appletVersion string (semver) required Applet version e.g. 2.0.1
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

appletVersion
required
string
Example: {{appletVersion}}

Version of your Applet, e.g. 1.0.12

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "appletUid": "d1aa183da1a70ca702f9f58bb991454363e37e3c21a6c1dc42",
  • "appletVersion": "2.0.0",
  • "deviceUid": "f4a08a660c9e935abad3679001eff5646bfa657d5365aabf48749",
  • "pendingTests": [
    ],
  • "successfulTests": [ ],
  • "failedTests": [ ],
  • "createdAt": "2022-02-22T18:06:58.628Z"
}

Device/Time

Update Device Time, Date and Timezone

Request change device time by deviceUid

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
time datetime - YYYY-MM-DDTHH:MM:SS Set current device date & time e.g. 2017-11-22T09:26:49

Input must be without timezone offset. The offset will be taken from the timezone parameter
Accepted formats are:
- YYYY-MM-DDTHH:MM:SS.mmm (2017-11-22T09:26:49.345)
- YYYY-MM-DDTHH:MM:SS (2017-11-22T09:26:49)
- YYYY-MM-DDT:HH:MM (2017-11-22T09:26) Will be set as 2017-11-22T09:26:00
- UNIX timestamp (1616140800000)
- SQL TIMESTAMP (2013-01-01 00:00:00.000)
timezone string - {Continent}/{City} Set device timezone by the IANA - List of all timezones can be found here - but read more about Tizen below.
ntpServer string Optional NTP server, e.g.: pool.ntp.org

Remarks

Setting NTP server and timezone has side effects:

Platform Side effect
Tizen After calling this API, display Reboots!

Tizen has limited set of available timezones
RaspberryPi After calling this API, RPi Reboots backend server which can take up to 60 seconds!
During the reboot no JS API is available.
Always wait for Promise resolution.
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "time": "2021-03-19T22:37",
  • "timezone": "Europe/Prague",
  • "ntpServer": "pool.ntp.org"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Time, Date and Timezone

This method is used for get settings of timestamp and timezone on device by devideUid.

Current device date and time is available under /device endpoint

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Device/Timers

Scheduled turning on and off devices based on day in a week and time.

Create, Update and Remove Device Timer

When the device should be woken up and when to turn it off to standby.

This endpoint is used for adding the Timers and also for removing Timers.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
type string - ‘TIMER_1’, ‘TIMER_2’, ‘TIMER_3’, ‘TIMER_4’, ‘TIMER_5’, ‘TIMER_6’, ‘TIMER_7’ Which of seven timers you would like to set
timeOn time / NULL, HH:MM:SS / NULL Wake up time for selected timer
timeOff time / NULL, HH:MM:SS / NULL Turn off time for selected timer
volume number / 0-100 Volume, if device has speakers
weekdays (weekdays[0-6] - for x-www-form-urlencoded) string[] / ex.: sun, mon, tue, wed, thu, fri, sat For which days the timer should be applied
level string - ‘NATIVE’ / ‘PROPRIETARY’ Should the device turn off completely or should it just turn off the display

How to remove Timers

Set timeOn and timeOff for respective type (TIMER_1, TIMER_2,..) to NULL.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "type": "TIMER_1",
  • "timeOn": "08:00:00",
  • "timeOff": "23:00:00",
  • "volume": "50",
  • "weekdays": [
    ],
  • "level": "PROPRIETARY"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Timers

List of device timer sets when the device should be woken up and when to turn it off. This retrieves previously set timers.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Device/Telemetry

Get Device Latest Telemetry by Type

Telemetry provides access to the latest device settings reported from the device. Telemetry frequency is defined by telemetry intervals based on your device plan.

Using this endpoint you can get the current value of:

Telemetry type Notes
APPLET Current active applet on device, incl. version and configuration.
IMPORTANT: Telemetry works on the following Core Apps versions
Platform Min. version
Tizen 2.3.0
webOS 2.3.0
Brightsign 1.5.0
Android 3.13.0
signageOS OS 2.0.0
Windows 2.2.0
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
telemetryType
required
string
Example: {{telemetryType}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "f4a08a660c9e935abad3679001eff5646bfa657d5365aabf48749",
  • "uid": "dec419cdf9bbf8ad41001a9c04e54ad13f76cc45d7c80e78a21b8",
  • "type": "BRIGHTNESS",
  • "createdAt": "2022-01-27T17:26:42.640Z",
  • "data": {
    }
}

Get Device History by Type

Telemetry history provides access to the device settings reported from the device.
This endpoint uses pagination. For more information view Pagination section. Max allowed page size is 100.
Using this endpoint you can get the current value of:

Telemetry type Notes
APPLET Current active applet on device, incl. version and configuration.

IMPORTANT: Telemetry works on the following Core Apps versions

Platform Min. version
Tizen 2.3.0
webOS 2.3.0
Brightsign 1.5.0
Android 3.13.0
signageOS OS 2.0.0
Windows 2.2.0
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
telemetryType
required
string
Example: {{telemetryType}}
query Parameters
limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get Devices Latest Telemetries

Get list all telemetry records (e.g.: REMOTE_CONTROL, OFFLINE_RANGE and etc.), for all or list of selected devices in the current organization.

This endpoint uses pagination. For more information view Pagination section.

query Parameters
deviceUids
Array of strings
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section.

limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Get Device Latest Telemetries

Get the latest telemetry readings of all types (e.g.: REMOTE_CONTROL, OFFLINE_RANGE and etc.), for a device in the current organization.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "deviceUid": "ca6319cdf9bbf8ad41001a9c04e54ad13f76cc45d7c80e78a21b8",
  • "createdAt": "2022-01-03T10:00:00.000Z",
  • "telemetries": {
    }
}

Device/Volume

Get latest Device Volume Changes

Get latest Device Volume Changes which are sorted by device creation date.

query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

organizationUids
Array of strings

Filter by Organization UIDs

deviceUids
Array of strings
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Change Device Volume on Device

Set Device Volume on the Device by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
volume
required
number [ 0 .. 100 ]

Responses

Request samples

Content type
application/json
{
  • "volume": 90
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get History of Device Volume Changes

Get History of Device Volume Changes by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get latest Device Volume Change

Get latest Device Volume Change by deviceUid.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "string",
  • "deviceUid": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "succeededAt": "2019-08-24T14:15:22Z",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "originator": {
    },
  • "createdBy": {
    },
  • "volume": 90
}

Count Device Volume Changes

Count how many times Device Volume was changed

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Device/AutoRecovery

Get Device Auto Recovery

Get configuration of device auto recovery process if device supports that

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Set Device Auto Recovery

Set configuration of device auto recovery process if device supports that.

Parameters

Field Type Required Description
enabled boolean required Indicates whether peer recovery should be enabled or disabled
healthcheckIntervalMs integer required When auto recovery is enabled, watchdog in node process checks periodically browser process with interval specified in ms. This attribute is required only if enabled is true
autoEnableTimeoutMs integer required When peer recovery is disabled, a time period in ms can be specified, after which the process is enabled automatically. This attribute is required only if enabled is false
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
required
enabled
boolean

When set to true, process is enabled, otherwise it is disabled

healthcheckIntervalMs
integer >= 30000

When auto recovery is enabled, watchdog in node process checks periodically browser process with interval specified in ms

autoEnableTimeoutMs
integer >= 30000

When peer recovery is disabled, a time period in ms can be specified, after which the process is enabled automatically

Responses

Request samples

Content type
application/json
{
  • "enabled": true,
  • "healthcheckIntervalMs": 60000,
  • "autoEnableTimeoutMs": 600000
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/PeerRecovery

Get Device Peer Recovery

Get peer recovery settings history of a single device.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Update Device Peer Recovery

Set device peer recovery on the device by deviceUid.

Parameters

Field Type Required Description
enabled boolean required Indicates whether peer recovery should be enabled or disabled
urlLauncherAddress string required When peer recovery is enabled, this URL address has to be set in URL launcher on device that is recovered. This attribute is required only if enabled is true
autoEnableTimeoutMs integer required When peer recovery is disabled, a time period in ms can be specified, after which the process is enabled automatically. This attribute is required only if enabled is false
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
enabled
boolean

Indicates whether peer recovery should be enabled or disabled

urlLauncherAddress
string

When peer recovery is enabled, this URL address has to be set in URL launcher on device that is recovered

autoEnableTimeoutMs
integer >= 30000

When peer recovery is disabled, a time period in ms can be specified, after which the process is enabled automatically

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/VPN

Get VPN settings

Get VPN settings for current Organization by deviceUid.

Parameters

Field Type Required Description
deviceUid string required device application id
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update VPN settings

Update existing VPN settings

Parameters

Field Type Required Description
deviceUid string required device application id

Body

Field Type Required Description
enable boolean required
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
enable
boolean

Responses

Request samples

Content type
application/json
{
  • "enable": true
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Firmware

Get Firmwares

Get all available firmware versions

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Firmware

Create new firmware version.

Currently for internal usage only

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "applicationType": "linux",
  • "version": "0.378",
  • "hashes": [
    ]
}

Location

Get Locations

Get all locations

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Locations

Get all locations

path Parameters
locationUid
required
string
Example: {{locationUid}}
query Parameters
organizationUids
Array of strings

Filter by Organization UIDs

uids
Array of strings

Filter by UIDs

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Locations

Get all locations

query Parameters
organizationUids
Array of strings

Filter by Organization UIDs

uids
Array of strings

Filter by UIDs

tagUids
Array of strings
tagsWithChildrenUids
Array of strings
cities
Array of strings
states
Array of strings
countries
Array of strings
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Location

Create location

Body

Field Type Required Description
name string yes name of the location
coordinates { lat: number, long: number } no this field is mutually exclusive with field address, only one can be in payload. Range from -90 to 90 for latitude and -180 to 180 for longitude
address string no this field is mutually exclusive with field coordinates, only one can be in payload
customId string no unique id which might be used e.g. for referencing the device to other systems
description string no any additional info about the location

Warning: Fields coordinates and address are mutually exclusive, but at least one of them must be in payload

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
organizationUid
string

Required if authenticating as an Account

name
required
string
address
string
object
customId
string
description
string
attachments
Array of strings

Responses

Request samples

Content type
application/json
{
  • "name": "test location",
  • "address": "Howard Street, San Francisco, CA, USA",
  • "coordinates": {
    },
  • "customId": "custom-id-123",
  • "description": "description note"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Count Locations

Count Locations

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Get Location

Get location

Parameters

Field Type Required Description
uid string
required
 location id
path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "uid": "7ebd44a3c6f0397eadce3b4c4ff0edf299ac",
  • "name": "test location (2)",
  • "feature": {
    },
  • "city": "South Alvah",
  • "countryCode": "AT",
  • "organizationUid": "9adaf389cbfffc81ca92e9563bc83df669c8",
  • "customId": "fb2ff797-da5b-40fa-8f3a-1306a5bc1a08",
  • "attachments": [
    ],
  • "description": "Research",
  • "tagUids": [
    ],
  • "createdAt": "2022-01-01T11:00:00.000Z",
  • "updatedAt": "2022-01-01T11:00:00.000Z"
}

Update Location

Update location

Body

Field Type Required Description
name string no name of the location
coordinates { lat: number, long: number } no this field is mutually exclusive with field address, only one can be in payload. Range from -90 to 90 for latitude and -180 to 180 for longitude
address string no this field is mutually exclusive with field coordinates, only one can be in payload
customId string no unique id which might be used e.g. for referencing the device
description string no any additional info about the location

Warning: Fields coordinates and address are mutually exclusive, but at least one of them must be in payload

path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
required
string
object
organizationUid
string
address
string
customId
string [ 1 .. 256 ] characters
description
string

Responses

Request samples

Content type
application/json
{
  • "name": "test location",
  • "coordinates": {
    },
  • "organizationUid": "org-uuid-123",
  • "customId": "custom-id-123",
  • "description": "description note updated"
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Delete Location

Delete location

Parameters

Field Type Required Description
uid string required unique location id
path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Delete Location

Delete location

Parameters

Field Type Required Description
uid string required unique location id
path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Delete Location

Unelete location

Parameters

Field Type Required Description
uid string required unique location id
path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Add Attachment to Location

Add one file attachment to location

path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: image/*
Request Body schema: image/*

Accepts only binary image files

string <binary>

Only Content-type of 'image/png', 'image/jpeg' or 'image/gif' is allowed

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Remove Attachments from Location

path Parameters
locationUid
required
string
Example: {{locationUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
attachmentsToRemove
required
Array of strings

Responses

Request samples

Content type
application/json
{
  • "attachmentsToRemove": [
    ]
}

Location/Tag

Assign Organization Tag To Location

path Parameters
locationUid
required
string
Example: {{locationUid}}
tagUid
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Unassign Organization Tag To Location

path Parameters
locationUid
required
string
Example: {{locationUid}}
tagUid
required
string
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Organization

Create Organization

Creates a new Organization for the current account

  1. We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET(separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
  2. Are you using REST API for creating Organizations? Make sure that the user token used for creating a new Organization belongs to the user with Company role Master or Owner.
  3. It is important to note that after creating a Company through REST API, the default Device plan is set to 3.0. This can be changed from within SignageOS Box under your Company profile

Parameters

Field Type Required Description
no parameters required

Body

Field Type Required Description
name string required Organization name

Can contain only letters and numbers separated by dashes and it must start and end with a letter or a number

Min 2 and max 255 length

Example: signageos-test-org-1
title string required Organization title

Min 2 and max 255 length

Example: SignageOS Testing Organization
In the response, you can find Location header with a link to the created organization.
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "my-organization",
  • "title": "My new organization"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Organizations

Get all Organizations for current account

  1. We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

Parameters

Field Type Required Description
organizationUid string optional filter by organization identification
accountId number optional filter by account identification
name string optional filter by name of the organization
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
x-oauth-client_secret
string
Example: {{x-oauth-client_secret}}

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Organization

Get the Organization details by organizationUid for the current account

path Parameters
organizationUid
required
string
Example: {{organizationUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "9fefb9905b6195c5f77062a40c6fee79abc0",
  • "name": "zEh88XYPcQ_signageOS_Organization",
  • "title": "signageOS Organization",
  • "createdAt": "2024-09-15T21:07:16.496Z",
  • "oauthClientId": "uBIHzhrTZF",
  • "oauthClientSecret": "afeQ2Aiay09vAWf",
  • "parentUid": "989e5bc65bc563a62ed5b73a732b997539ba",
  • "subscriptionType": "open,",
  • "organizationFeatureEntitlements": [
    ]
}

Delete Organization

Delete Organization by organizationUid for the current account.

  1. We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

Parameters

Field Type Required Description
organizationUid string required organization identification
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Update Organization

Update existing organization

path Parameters
organizationUid
required
string
Example: {{organizationUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
title
required
string

Organization title

Min 2 and max 255 length

Example: SignageOS Testing Organization

Responses

Request samples

Content type
application/json
{
  • "title": "My new organization title"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Update Organization Device Plan

Sets the organization's Device Plan.

We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

Available Device Plans

  • open
  • 1.0
  • 2.0
  • 3.0

Parameters

Field Type Required Description
organizationUID string required unique organization identification
subscriptionType string required subscription type. (One of: "open", "1.0", "2.0", "3.0")
path Parameters
organizationUID
required
string
Example: {{organizationUID}}
subscriptiontype
required
string
Example: {{subscriptiontype}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get organization tokens

Retrieves the list of organization tokens

We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

path Parameters
organizationUID
required
string
Example: {{organizationUID}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create organization token

Creates organization token.

We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

path Parameters
organizationUID
required
string
Example: {{organizationUID}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "Your Token Name"
}

Response samples

Content type
application/json
{
  • "id": "fbb807a23f009af05dww",
  • "securityToken": "454f512635cd7dwdwdwdwdwfwwxw2eb161a7fdwdwerr",
  • "name": "Example Token Name"
}

Delete organization token

Deletes organization token in your organization by organizationUid and organizationSecurityTokenId.

  1. We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

Parameters

Field Type Required Description
organizationUid string required Unique Organization Identification
organizationSecurityTokenId string required Security token Identification
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
organizationSecurityTokenID
required
string
Example: {{organizationSecurityTokenID}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get organization devices count

Get count of all devices in your organization by organizationUid.

  1. We use different authentication in the x-auth header for /organization endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.

Parameters

Field Type Required Description
organizationUid string required Unique Organization Identification
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "a326d675e4688a7ee2bf4ab951a5299a87c036a8e69e9e2dwwq",
  • "name": "example-org",
  • "title": "Example",
  • "createdAt": "2021-05-25T08:28:50.372Z",
  • "oauthClientId": "8a2cfadab69a748e7595c8eb11e547f7361c7429f00f4cxxwQ",
  • "oauthClientSecret": "cca347855de76c22f84c7109307a50afa980111a77542ea389b99bb2ebdwerrw",
  • "devicesCount": 42
}

Policy

Get Policies

Get all policies for current Organization.

Parameters

Field Type Required Description
pagination number greater than 0
optional
 Start paginating result by a given number of items on the page. Next page link is available in the response header Link.

E.g.: <https://api.signageos/v1/policy?pagination=50&createdUntil=2020-10-22T16%3A10%3A00.000Z>; rel="next"
createdUntil string
optional
 Filter by policy createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).
archived boolean
optional
 Filter archived/active policies. Accepted values '0', '1', 'true', 'false'
query Parameters
pagination
number
Example: pagination=50

Start paginating result by given number items on page. Next page link is available on in response under header Link. E.g.: <https://api.signageos/v1/policy?pagination=50&createdUntil=2020-10-22T16%3A10%3A00.000Z>; rel="next"

createdUntil
string
Example: createdUntil=2017-08-02T13:45:40.000Z

Filter by policy createdAt lower than (exclusive) date time in ISO-8601 format. Internally used for pagination (see pagination parameter).

archived
boolean

Filter archived/active policies. Accepted values '0', '1', 'true', 'false'

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Policy

Create new policy in specified Organization.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
required
string
organizationUid
string

Required if authenticating as an Account

items
Array of arrays

Responses

Request samples

Content type
application/json
{
  • "name": "My new policy",
  • "organizationUid": "{{organizationUid}}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Policy

Get one policy by policyUid.

path Parameters
policyUid
required
string
Example: {{policyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "a75e1c9087af913c32ec35cd7b5b812193163d06cef952cb00",
  • "name": "My device Policy",
  • "createdAt": "2021-03-30T18:57:33.669Z",
  • "items": [ ],
  • "note": "New policy created"
}

Update Policy

Update existing policy in the organization by policyUid.

path Parameters
policyUid
required
string
Example: {{policyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
string
note
string
items
Array of arrays

Responses

Request samples

Content type
application/json
{
  • "name": "My updated Policy name",
  • "note": "Set high volume and brightness by my store opening hours",
  • "items": [
    ]
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Clone Policy

Clone existing policy in organization by policyUid.

Parameters

Field Type Required Description
policyUid string required Unique Policy Identification

Body

Field Type Required Description
name string required New name of the cloned policy.
organizationUid string required Organization UID where will be new policy cloned.
path Parameters
policyUid
required
string
Example: {{policyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "My new cloned policy",
  • "organizationUid": "{{organizationUid}}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Archive Policy

Archive existing policy by policyUid.

Parameters

Field Type Required Description
policyUid string required Unique Policy Identification

Body

Field Type Required Description
archived boolean required If true policy is archived and not active.
path Parameters
policyUid
required
string
Example: {{policyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "archived": true
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Tag

Get organization tags

Get all tags for current organization

This endpoint uses pagination. For more information view Pagination section. Max allowed page size is 500.

query Parameters
limit
integer
Example: limit={{limit}}

Page size. For more information, view Pagination section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Tag

Create tag

Payload

{
    name: string;
    color?: string;
    parentTagUid?: string;
}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "Organization tag 1"
}

Get Organization Tag

Gets organization tag

path Parameters
uid
required
string
Example: {{uid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "8dda7620af7b485ab14fb1e6fb9952717d276e32adb8aa291c",
  • "organizationUid": "48889e30b1423d4171e348d6a1a1222e3b0075c8d7abcc868a",
  • "name": "example",
  • "createdAt": "2022-07-22T13:00:00.000Z",
  • "color": null,
  • "parentTagUid": null
}

Update Tag

Update tag

Payload

{
    name: string;
    color?: string;
    parentTagUid?: string;
}
path Parameters
uid
required
string
Example: {{uid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "name": "Tag 1 updated"
}

Delete Tag

Delete tag

path Parameters
uid
required
string
Example: {{uid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Timing

Create Timing

Timing might be a misleading name (apologies), but it has nothing to do with scheduling content. Timing is an endpoint that will allow you to set your Applet on device.

Create new Timing record for deploying selected Applet and to the target device.

Body

content-type: application/json or application/x-www-form-urlencoded

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
appletUid
required
string

Applet unique identification

appletVersion
required
string

Version of your applet

deviceUid
required
string

Unique device identification

object or string

Unique configuration specific to the applet and device, usually your internal ID’s, links to APIs, etc.

startsAt
string
Deprecated

Since when the Applet should be set on device

endsAt
string
Deprecated

Untill when the Applet should be set on device

number or string
Deprecated

When more then one Applet is set for device, in which order are they available on the device

object
Deprecated
finishEventType
string
Deprecated
Enum: "DURATION" "IDLE_TIMEOUT" "SCREEN_TAP"

Which event is triggering switch between multiple Applets‘DURATION’ – after specific amount of time‘SCREEN_TAP’ – after display is touched‘IDLE_TIMEOUT’ – after time of inactivity (without any tapping on display)

finishEventData
any
Deprecated

Used for setting DURATION or IDLE_TIMEOUT values of finishEventType

Responses

Request samples

Content type
application/json
{
  • "deviceUid": "{{deviceUid}}",
  • "appletUid": "{{appletUid}}",
  • "appletVersion": "{{appletVersion}}",
  • "startsAt": "2017-12-01T12:00:00",
  • "endsAt": "2017-12-31T12:00:00",
  • "position": "1",
  • "finishEventType": "DURATION",
  • "finishEventData": 1000,
  • "configuration": "{\"identification\":\"XXX\"}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Timings

Timing might be a misleading name (apologies), but it has nothing to do with scheduling content. Timing is an endpoint that will allow you to set your Applet on device.

Get all your Timings.

Parameters

Field Type Required Description
timingUid string optional unique timing identification
deviceUid string optional unique device identification
current boolean optional retrieve current timing set for device
query Parameters
deviceUid
string
Example: deviceUid={{deviceUid}}
current
boolean
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Timing

Timing might be a misleading name (apologies), but it has nothing to do with scheduling content. Timing is an endpoint that will allow you to set your Applet on device.

Get Timing by timingUid or by deviceUid.

Parameters

Field Type Required Description
timingUid string
required
 unique timing identification
deviceUid string
optional
 unique device identification
current boolean
optional
 retrieve current timing set for device
path Parameters
timingUid
required
string
Example: {{timingUid}}
query Parameters
deviceUid
string
current
boolean
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "4dcb018285c5ca8709bcc3beea45c306e6823ff9648e8edf6c",
  • "appletUid": "ae831411425df581cae9d74c2a8c04386166d0cbb70ef377f2",
  • "deviceUid": "cf98c9d5f3442737e40221838bf2ef92f2b1173786ad3cb61519b",
  • "createdAt": "2021-03-31T09:40:30.431Z",
  • "updatedAt": "2021-04-12T13:24:01.269Z",
  • "startsAt": "2021-04-09T06:40:00.000Z",
  • "endsAt": "2021-04-11T06:40:00.000Z",
  • "configuration": {
    },
  • "appletVersion": "0.0.1",
  • "finishEvent": {
    },
  • "position": 1
}

Update Timing

Timing might be a misleading name (apologies), but it has nothing to do with scheduling content. Timing is an endpoint that will allow you to set your Applet on device.

Update device Timing with the selected Applet and assign it to the device. You can update the applet version and more.

Parameters

Field Type Required Description
timingUid string required unique Timing identification

Body

content-type: application/json or application/x-www-form-urlencoded

Remarks on startsAt and endsAt:

  • When you set endsAt to timing, it sticks to device until applet with later startsAt date is in the system. In the most of cases you just set startsAt and endsAt date to the same value.
  • configuration values have to be always a key-value pairs where value is a string. To pass JSON object use JSON.stringify()
path Parameters
timingUid
required
string
Example: {{timingUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
appletVersion
string

Version of your applet

object or string

Unique configuration specific to the applet and device, usually your internal ID’s, links to APIs, etc.

configurationSet
object

For partial update of timing configuration. Cannot be used together with configuration in same request

configurationRemoveKeys
Array of strings

For removing parts of timing configuration. Cannot be used together with configuration in same request

active
boolean

If true, other timings on the same device will be disabled. If not provided, default value will be generated from startsAt/endsAt based on the current time. If neither startsAt nor endsAt is provided, the default value will be true.

startsAt
string
Deprecated

Since when the Applet should be set on device

endsAt
string
Deprecated

Untill when the Applet should be set on device

number or string
Deprecated

When more then one Applet is set for device, in which order are they available on the device

object
finishEventType
string
Deprecated
Enum: "DURATION" "IDLE_TIMEOUT" "SCREEN_TAP"

Which event is triggering switch between multiple Applets‘DURATION’ – after specific amount of time‘SCREEN_TAP’ – after display is touched‘IDLE_TIMEOUT’ – after time of inactivity (without any tapping on display)

finishEventData
any
Deprecated

Used for setting DURATION or IDLE_TIMEOUT values of finishEventType

Responses

Request samples

Content type
application/json
{
  • "deviceUid": "{{deviceUid}}",
  • "appletUid": "{{appletUid}}",
  • "appletVersion": "{{appletVersion}}",
  • "startsAt": "2017-12-01T12:00:00",
  • "endsAt": "2018-12-31T12:00:00",
  • "position": "1",
  • "finishEventType": "DURATION",
  • "finishEventData": 1000,
  • "configuration": "{'identification':'XXX'}"
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Delete Timing

Timing might be a misleading name (apologies), but it has nothing to do with scheduling content. Timing is an endpoint that will allow you to set your Applet on device.

Delete existing Timing by unique id.

Parameters

Field Type Required Description
timingUid string
required
 unique timing identification
path Parameters
timingUid
required
string
Example: {{timingUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Emulator

Create new emulator

Create a new emulator in your organization.

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "organizationUid": "{{organizationUid}}"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get list of emulators

Get all emulators within your organization.

query Parameters
organizationUid
string
Example: organizationUid=2b6d9c3873b5a852221b195b6350a6c71318e56e4d493a585f4

filter by organizationUid

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Remove emulator

Delete specific emulator by emulatorUid.

path Parameters
emulatorUid
required
string
Example: {{emulatorUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
text/plain
# Empty response

Uptime

Get uptime stats

Get device connection uptime for the device.

query Parameters
since
string
Example: since=2017-08-02T13:45:40.000Z

Default date is month ago

until
string
Example: until=2017-08-02T13:45:40.000Z

Default date is today

deviceUid
string
Example: deviceUid={{deviceUid}}

All devices per organization are included by default and you can specify one device by its uid

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "uptime": 58728858,
  • "downtime": 61175894,
  • "total": 119904752,
  • "availabilityPercent": 96,
  • "since": "2022-03-01T14:37:02.972Z",
  • "until": "2022-04-01T14:37:02.973Z"
}

Device/Extended Management Remote Server

Update extended management remote server URL

Set device extended management remote server URL on the device by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification

Body

content-type: application/json or application/x-www-form-urlencoded

Field Type Description
url string Device extended management remote server URL
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get extended management remote server URL

Get device extended management remote server URL on the device by deviceUid.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "33bc149a44a3948a57a8b7083fe73fb17d5fe98d6066d86cb1",
  • "deviceUid": "9c83b5e07ee0991dce1216e2ba0338d454f1da7d4f84406761fb6",
  • "createdAt": "2021-04-30T01:31:35.756Z",
  • "succeededAt": null,
  • "failedAt": "2021-04-30T01:31:35.955Z",
  • "url": "https://www.google.com"
}

Applet/Command

Get Applet Commands

Get all applet commands by appletUid.

Max allowed page size is 200

Device applet commands are available for the previous 3 days. Historical data of all commands is available as ZIP dump at Get Device Reports (Uptime, Applet Commands) endpoint: https://developers.signageos.io/api/#tag/DeviceMonitoring/paths/~1v1~1device~1%7BdeviceUid%7D~1report/get .

Parameters

Field Type Required Description
appletUid string <div class="red">required
applet unique identification type string <div class="yellow">optional
your log type - e.g.: MyCms.Content.PlayVideo receivedSince Date <div class="yellow">optional
get all commands since exact date (included) receivedUntil Date <div class="yellow">optional
get all commands till exact date (excluded)

This endpoint uses pagination. For more information view Pagination section.

path Parameters
appletUid
required
string
Example: {{appletUid}}

Unique Applet Identifier

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Applet Commands

Get all applet commands in your organization.

Max allowed page size is 200

Device applet commands are available for the previous 3 days. Historical data of all commands is available as ZIP dump at Get Device Reports (Uptime, Applet Commands) endpoint: https://developers.signageos.io/api/#tag/DeviceMonitoring/paths/~1v1~1device~1%7BdeviceUid%7D~1report/get .

Parameters

Field Type Required Description
type string <div class="yellow">optional
your log type - e.g.: MyCms.Content.PlayVideo receivedSince Date <div class="yellow">optional
get all commands since exact date (included) receivedUntil Date <div class="yellow">optional
get all commands till exact date (excluded)

This endpoint uses pagination. For more information view Pagination section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Configuration

Set telemetry intervals

Configure device telemetry check intervals

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
screenshots
number or null
temperature
number or null
applicationVersion
number or null
frontDisplayVersion
number or null
brightness
number or null
datetime
number or null
orientation
number or null
powerActionsSchedule
number or null
proprietaryTimers
number or null
remoteControl
number or null
resolution
number or null
timers
number or null
volume
number or null
storage
number or null
battery
number or null
policy
number or null
peerRecovery
number or null
autoRecovery
number or null
default
number or null

Responses

Request samples

Content type
application/json
{
  • "battery": 1500000,
  • "brightness": 1600000,
  • "screenshots": 1200000,
  • "temperature": 1200000,
  • "applicationVersion": 1200000,
  • "frontDisplayVersion": 1200000,
  • "datetime": 1200000,
  • "orientation": 1200000,
  • "powerActionsSchedule": 1200000,
  • "proprietaryTimers": 1200000,
  • "remoteControl": 1200000,
  • "resolution": 1200000,
  • "timers": 1200000,
  • "volume": 1200000,
  • "storage": 1200000,
  • "policy": 1200000,
  • "peerRecovery": 1200000,
  • "autoRecovery": 1200000,
  • "default": 1200000
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get telemetry intervals

Get device telemetry check intervals

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "battery": 1500000,
  • "brightness": 1600000,
  • "screenshots": 1200000,
  • "temperature": 1200000,
  • "applicationVersion": 1200000,
  • "frontDisplayVersion": 1200000,
  • "datetime": 1200000,
  • "orientation": 1200000,
  • "powerActionsSchedule": 1200000,
  • "proprietaryTimers": 1200000,
  • "remoteControl": 1200000,
  • "resolution": 1200000,
  • "timers": 1200000,
  • "volume": 1200000,
  • "storage": 1200000,
  • "policy": 1200000,
  • "peerRecovery": 1200000,
  • "autoRecovery": 1200000,
  • "default": 1200000
}

Device/System Log

Get Device System Logs

Get system logs for device by deviceUid.

Returned values are in Bytes.

Parameters

Field Type Required Description
deviceUid string required Unique Device Identification
This endpoint uses pagination. For more information view Pagination section.
path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Device/Tag (Device Tags)

Assign organization tag to the device.

Enables to assign organization tag to the device that belongs to this organization.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
tagUid
required
string
Example: {{tagUid}}

Organization tag uid

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Unassign organization tag which is assigned to the device.

Enables to unassign organization tag on the device.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
tagUid
required
string
Example: {{tagUid}}

Organization tag uid

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get tags assigned to the device

Get list of tags which was assigned to the device

This endpoint uses pagination. For more information view Pagination section.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Device/Security

Get Device Security

Get a device security options

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "bluetoothEnabled": true,
  • "usbEnabled": true,
  • "wifiEnabled": true,
  • "menuAccessEnabled": true,
  • "buttonsEnabled": true,
  • "remoteControlEnabled": true,
  • "kioskModeEnabled": true,
  • "createdAt": "2021-01-30T08:30:00Z",
  • "updatedAt": "2021-01-30T08:30:00Z"
}

Update Device Security

Update a device security options

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
bluetoothEnabled
boolean or null
usbEnabled
boolean or null
wifiEnabled
boolean or null
menuAccessEnabled
boolean or null
buttonsEnabled
boolean or null
remoteControlEnabled
boolean or null
kioskModeEnabled
boolean or null

Responses

Request samples

Content type
application/json
{
  • "bluetoothEnabled": true,
  • "wifiEnabled": false
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/Screen Capture

Enable/disable Device Screen Capture

Enable or disable screen capture on a device.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
enable
boolean

Responses

Request samples

Content type
application/json
{
  • "enable": true
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Device Screen Capture status

Get current device screen capture status.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "enabled": true
}

Device/Custom Script

Get latest Device Custom Script Executions

Get latest Device Custom Script Executions which are sorted by device creation date.

query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

organizationUids
Array of strings

Filter by Organization UIDs

customScriptUids
Array of strings
Example: customScriptUids=33bc149a44a3948a57a8b7083fe73fb17d5fe98d6066d86cb1

Filter by Custom Script UIDs

versions
Array of strings
Example: versions=1.0.0

Filter by Custom Script Versions

deviceUids
Array of strings
Example: deviceUids={{deviceUid}}

List of device uids. For more information, view List parameters section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Execute Device Custom on Device

Execute Device Custom on Device.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
customScriptUid
required
string
version
required
string
object

Responses

Request samples

Content type
application/json
{
  • "customScriptUid": "string",
  • "version": "string",
  • "configuration": { }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get History of Device Custom Script Executions

Get History of Device Custom Script Executions.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

customScriptUids
Array of strings
Example: customScriptUids=33bc149a44a3948a57a8b7083fe73fb17d5fe98d6066d86cb1

Filter by Custom Script UIDs

versions
Array of strings
Example: versions=1.0.0

Filter by Custom Script Versions

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get latest Device Custom Script Execution

Get latest Device Custom Script Execution.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "string",
  • "customScriptUid": "string",
  • "version": "string",
  • "deviceUid": "string",
  • "configuration": { },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "succeededAt": "2019-08-24T14:15:22Z",
  • "failedAt": "2019-08-24T14:15:22Z",
  • "result": {
    }
}

Count Device Custom Script Executions

Count how many times Custom Scripts were executed on a Device.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Device/Revoke Key

Revokes public key on the device

In signageOS device management, it is possible to send encrypted configurations to a device, typically for applets, scripts, etc. The process uses asymmetric encryption, including the device's own private-public key pair. This key pair is automatically renewed when it expires. However, there may be situations where the device user wants to forcibly renew the key pair. This endpoint handles that process. Upon a successful request, the previous key is revoked, and a new one is automatically created. For more details, visit https://developers.signageos.io/docs/devspace-extras/env-variables-configuration and https://developers.signageos.io/docs/devspace-basics/use-secrets.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get history of device public key revocations

Get history of device public key revocations

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get latest device public key revocation

Get latest device public key revocation

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "string",
  • "deviceUid": "string",
  • "deviceIdentityHash": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "succeededAt": "2019-08-24T14:15:22Z",
  • "failedAt": "2019-08-24T14:15:22Z"
}

Count device public key revocations

Count how many times public key were revoked on a device.

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Device/Plugin (Coming Soon)

List device plugins

Retrieves all plugins assigned to a specific device with their assigned versions

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
query Parameters
status
Array of strings
Items Enum: "active" "inactive" "error"

Filter by plugin status on device

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Assign plugin to device

Creates a new plugin assignment for a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
pluginUid
required
string
version
required
string
deviceUid
required
string
active
boolean
Default: true

Responses

Request samples

Content type
application/json
{
  • "deviceUid": "device123",
  • "pluginUid": "abc123def456",
  • "version": "1.2.0",
  • "active": true
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Plugin Assignment

Retrieves a specific plugin assignment to a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
assignmentUid
required
string
Example: abc123def456

Unique plugin-to-device assignmentx identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "string",
  • "pluginUid": "string",
  • "version": "string",
  • "deviceUid": "string",
  • "active": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Update Plugin Assignment

Updates an existing plugin assignment for a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
assignmentUid
required
string
Example: abc123def456

Unique plugin-to-device assignmentx identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
version
string
active
boolean
Default: true

Responses

Request samples

Content type
application/json
{
  • "version": "1.1.0",
  • "active": true
}

Response samples

Content type
application/json
{
  • "status": 403,
  • "message": "Access forbidden",
  • "errorCode": 403001,
  • "errorName": "EXAMPLE_ACCESS_FORBIDDEN",
  • "errorDetail": "Example \"403 Forbidden\" error"
}

Delete Plugin Assignment

Deletes a specific plugin assignment from a device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
assignmentUid
required
string
Example: abc123def456

Unique plugin-to-device assignmentx identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 403,
  • "message": "Access forbidden",
  • "errorCode": 403001,
  • "errorName": "EXAMPLE_ACCESS_FORBIDDEN",
  • "errorDetail": "Example \"403 Forbidden\" error"
}

Set Plugin property on Device

Sends a "set property" command to a specific plugin on a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object
property name*
additional property
any

Responses

Request samples

Content type
application/json
{
  • "data": {
    }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Device/Plugin/Telemetry (Coming soon)

Get history of telemetry data from plugins

Retrieves telemetry data from plugins on devices

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get latest telemetry data from plugins

Retrieves the latest telemetry data from plugins on devices

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get history of telemetry data from plugins on a specific device

Retrieves telemetry data from plugins on a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get latest telemetry data from plugins on a specific device

Retrieves latest telemetry data from plugins on a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get history of telemetry data from plugins on a specific device

Retrieves telemetry data from plugins on a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get latest telemetry data from a specific plugin on a specific device

Retrieves latest telemetry data from a specific plugin on a specific device

path Parameters
deviceUid
required
string
Example: {{deviceUid}}
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Organization/Member

Add organization member

Adds a new organization member for the provided organization. If the email does not exist, invitation email is sent.

  1. We use different authentication in the x-auth header for /organization/:organizationUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET(separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
organizationUid
required
string
Example: {{organizationUid}}

Organization uid

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
role
required
string
Enum: "owner" "manager" "user" "guest"
email
required
string

Responses

Request samples

Content type
application/json
{
  • "role": "user",
  • "email": "john.doe@signageos.io"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get organization members

Gets all organization members for given organization

  1. We use different authentication in the x-auth header for /organization/:organizationUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
organizationUid
required
string
Example: {{organizationUid}}

Organization uid

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Edit organization member

Edits organization member role for the provided organization.

  1. We use different authentication in the x-auth header for /organization/:organizationUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET(separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
organizationUid
required
string
Example: {{organizationUid}}

Organization uid

accountId
required
string
Example: {{accountId}}

Account id

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
role
required
string
Enum: "owner" "manager" "user" "guest"

Responses

Request samples

Content type
application/json
{
  • "role": "user"
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Get organization member

Get all organization members for given organization

  1. We use different authentication in the x-auth header for /organization/:organizationUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
organizationUid
required
string
Example: {{organizationUid}}

Organization uid

accountId
required
string
Example: {{accountId}}

Account id

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "id": 1252866600347193,
  • "username": "john.doe_fea0bcc5",
  • "email": "john.doe@signageos.io",
  • "firstname": "John",
  • "lastname": "Doe",
  • "role": "user",
  • "assignedAt": "2022-10-07T14:10:39.444Z"
}

Delete organization member

Deletes organization member for given organization

  1. We use different authentication in the x-auth header for /organization/:organizationUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
organizationUid
required
string
Example: {{organizationUid}}

Organization uid

accountId
required
string
Example: {{accountId}}

Account id

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Company/Member

Add company member

Adds a new company member for the provided company. If the email does not exist, invitation email is sent.

  1. We use different authentication in the x-auth header for /company/:companyUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET(separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
companyUid
required
string
Example: {{companyUid}}

Company uid

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
role
required
string
Enum: "owner" "manager" "user" "guest"
email
required
string

Responses

Request samples

Content type
application/json
{
  • "role": "user",
  • "email": "john.doe@signageos.io"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get company members

Gets all company members for given company

  1. We use different authentication in the x-auth header for /company/:companyUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
companyUid
required
string
Example: {{companyUid}}

Company uid

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Edit company member

Edits company member role for the provided company.

  1. We use different authentication in the x-auth header for /company/:companyUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET(separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
companyUid
required
string
Example: {{companyUid}}

Company uid

accountId
required
string
Example: {{accountId}}

Account id

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
role
required
string
Enum: "owner" "manager" "user" "guest"

Responses

Request samples

Content type
application/json
{
  • "role": "user"
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Get company member

Get all company members for given company

  1. We use different authentication in the x-auth header for /company/:companyUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
companyUid
required
string
Example: {{companyUid}}

Company uid

accountId
required
string
Example: {{accountId}}

Account id

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "id": 1252866600347193,
  • "username": "john.doe_fea0bcc5",
  • "email": "john.doe@signageos.io",
  • "firstname": "John",
  • "lastname": "Doe",
  • "role": "user",
  • "assignedAt": "2022-10-07T14:10:39.444Z"
}

Delete company member

Deletes company member for given company

  1. We use different authentication in the x-auth header for /company/:companyUid/member endpoints, which consists of USER TOKEN_ID and TOKEN_SECRET (separated by “:”). You can find both on the Settings page (https://box.signageos.io/settings) in SignageOS Box. Learn more here.
path Parameters
companyUid
required
string
Example: {{companyUid}}

Company uid

accountId
required
string
Example: {{accountId}}

Account id

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Company / Public Key

Get company's public key

Returns the company's public key, which can be used for asymmetric encryption of sensitive data for processing within the signageOS system.

Parameters

| Field | Type | Required | Description | | --- | --- | --- | --- | | companyUid | string | required | Company identification |

path Parameters
companyUid
required
string
Example: {{companyUid}}

Company uid

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "publicKey": "-----BEGIN PUBLIC KEY-----\\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA-----END PUBLIC KEY-----\\n"
}

Company

Get Company

Get Company by uid.

path Parameters
companyUid
required
string
Example: {{companyUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "6dc408e8f8059b60465b9d4363feeffe14fd",
  • "name": "signageos-bd551bc989",
  • "title": "signageOS",
  • "createdAt": "2025-02-20T16:22:24.605Z",
  • "devices": 10,
  • "users": 10,
  • "organizations": 10,
  • "trialStatus": "trial",
  • "credits": 100,
  • "projectedCreditsUsage": 10,
  • "monthsLeftCredits": 10,
  • "totalUsedCredits": 10
}

Get Companies

Get all Companies

query Parameters
name
string
Example: name=signageos

Filter by company name

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Company

Create Company, new Underling Organization and new User Account assigned to the company as an owner and to the Organization as a manager. Company is assigned to the Company network

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
companyTitle
required
string
companyNetworkUid
required
string
userEmail
required
string
userFirstName
required
string
userLastName
required
string

Responses

Request samples

Content type
application/json
{
  • "companyTitle": "JohnDoeCompany",
  • "userEmail": "JohnDoe@John.co",
  • "userFirstName": "John",
  • "userLastName": "Doe",
  • "companyNetworkUid": "347eacf8a8a461e9c60d639496a8959cb9b73ad5ba4f973d81"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Count Companies

Count Companies

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Company credit transaction

Get company credit transactions

Get all company credit transactions for a company

path Parameters
companyUid
required
string
Example: {{companyUid}}
query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

uids
Array of strings

Filter by UIDs

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Get company credit transaction

Gets company credit transaction by creditTransactionUid.

path Parameters
companyUid
required
string
Example: {{companyUid}}
creditTransactionUid
required
string
Example: {{creditTransactionUid}}

Unique credit transaction identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "uid": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "companyUid": "5d9bd72df4d187053cc7d2474c781cf590b10d2d7a12d7a6db",
  • "transactionType": "charge",
  • "amount": 100,
  • "note": "test",
  • "createdAt": "2021-12-08T14:29:50.372Z",
  • "updatedAt": "2021-12-08T14:29:50.372Z",
  • "createdBy": {
    },
  • "updatedBy": {
    }
}

Count company credit transactions

Count company credit transactions

path Parameters
companyUid
required
string
Example: {{companyUid}}
query Parameters
uids
Array of strings

Filter by UIDs

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Package

Get Packages

Get all packages for current Organization.

query Parameters
limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create New Package

Creates new package with the specified properties

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Request Body schema: application/json
packageName
required
string^[a-zA-Z][\w\-.]*\w$

No special chars

label
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "packageName": "com.example.new.package",
  • "label": "Example New Package",
  • "description": "This is newly created package"
}

Get One Package

Get one package by the given uid.

path Parameters
packageUid
required
string
Example: {{packageUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "uid": "23568258a06d973c8876ffe41c288a19f3833bd2c9fbe5d7cd",
  • "createdAt": "2022-05-24T08:58:56.994Z",
  • "packageName": "com.example.android.kiosk",
  • "label": "Example Kiosk",
  • "description": "Example Kiosk is a signage experience for your TV",
  • "ownerOrganizationUid": "a326d675e4688a7ee2bf4ab951a5299a87c036a8e69e9e2dwwq",
  • "createdByAccountId": 436778
}

Update one Package

Updates package properties

path Parameters
packageUid
required
string
Example: {{packageUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Request Body schema: application/json
label
string
description
string

Responses

Request samples

Content type
application/json
{
  • "label": "Updated Example Package Label",
  • "description": "Updated example description"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Package/Version

Get Package Versions

Get all version of the given package.

path Parameters
packageUid
required
string
Example: {{packageUid}}
query Parameters
limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create New Package Version

Creates new package version with the specified properties. This resource have to be called after uploading the package version binary to the /package/{packageUid}/file resource. If the file is missing the package version can't be created.

path Parameters
packageUid
required
string
Example: {{packageUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Request Body schema: multipart/form-data
metadata
required
string
binary
required
string <binary>

Responses

Request samples

Content type
multipart/form-data
{
  "metadata": "{ \"version\": \" 1.2.0-rc.2\", \"build\": \"ef430098dd\" }",
  "binary": "JUUyJTlDJTkzJTIwJUMzJUEwJTIwbGElMjBtb2Rl"
}

Get One Package Version

Get one Package Version by the given buildHash and applicationType.

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "uid": "bd74395949f7de6",
  • "createdAt": "2022-06-22T17:07:52Z",
  • "packageName": "com.example.android.webview",
  • "applicationType": "android",
  • "version": "1.2.3-beta.4",
  • "build": "59f00e8e351b8a0",
  • "buildHash": "a06d973c8876ffe41c288a1",
  • "publishedSince": "2022-06-28T17:07:52Z",
  • "note": "Example WebView note",
  • "specs": {
    }
}

Update one Package Version

Updates Package Version properties

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Request Body schema: application/json
note
required
string or null

Responses

Request samples

Content type
application/json
{
  • "note": "Update package version note"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Delete one Package Version

Deletes Package Version

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Package Version Binary

Redirect to the Package Version Binary

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Get Package Version Icon

Redirect to the Package Version Icon

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Publish Package Version

Published Package Version is available for installation to a device

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Unpublish Package Version

Unpublished Package Version is not available for installation to a device

path Parameters
packageUid
required
string
Example: {{packageUid}}
packageVersionUid
required
string
Example: {{packageVersionUid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Bulk Operation

Get bulk operations

Get bulk operations by organizationUid.

query Parameters
limit
integer
Example: limit=50
offset
integer
Example: offset=50
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "a75e1c9087af913c32ec35cd7b5b812193163d06cef952cb00",
  • "name": "My Bulk Operation",
  • "filter": {
    },
  • "deviceUids": [
    ],
  • "failedDeviceUids": [
    ],
  • "successfulDeviceUids": [
    ],
  • "skippedDeviceUids": [
    ],
  • "createdAt": "2021-03-30T18:57:33.669Z",
  • "pausedAt": "2021-03-30T18:57:33.669Z",
  • "stoppedAt": "2021-03-30T18:57:33.669Z",
  • "resumedAt": "2021-03-30T18:57:33.669Z",
  • "archivedAt": "2021-03-30T18:57:33.669Z",
  • "finishedAt": "2021-03-30T18:57:33.669Z",
  • "isRunning": true,
  • "schedule": {
    },
  • "rollingUpdate": {
    },
  • "operationType": "SET_APPLICATION_VERSION",
  • "data": {
    },
  • "progress": {
    }
}

Create bulk operation

Create bulk operation.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
One of
name
string
required
object
object
object
operationType
required
string
Value: "SET_APPLICATION_VERSION"
required
object

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "filter": {
    },
  • "schedule": {
    },
  • "rollingUpdate": {
    },
  • "operationType": "REVOKE_DEVICE_KEY",
  • "data": { }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get bulk operation

Get bulk operation by bulkOperationUid.

path Parameters
bulkOperationUid
required
string
Example: b14606b90abe94acd006349f2cftd53d650d6dd545a2e40b5a83d

Unique Bulk Operation Identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "a75e1c9087af913c32ec35cd7b5b812193163d06cef952cb00",
  • "name": "My Bulk Operation",
  • "filter": {
    },
  • "deviceUids": [
    ],
  • "failedDeviceUids": [
    ],
  • "successfulDeviceUids": [
    ],
  • "skippedDeviceUids": [
    ],
  • "createdAt": "2021-03-30T18:57:33.669Z",
  • "pausedAt": "2021-03-30T18:57:33.669Z",
  • "stoppedAt": "2021-03-30T18:57:33.669Z",
  • "resumedAt": "2021-03-30T18:57:33.669Z",
  • "archivedAt": "2021-03-30T18:57:33.669Z",
  • "finishedAt": "2021-03-30T18:57:33.669Z",
  • "isRunning": true,
  • "schedule": {
    },
  • "rollingUpdate": {
    },
  • "operationType": "SET_APPLICATION_VERSION",
  • "data": {
    },
  • "progress": {
    }
}

Pause bulk operation

Pause bulk operation by bulkOperationUid.

path Parameters
bulkOperationUid
required
string
Example: b14606b90abe94acd006349f2cftd53d650d6dd545a2e40b5a83d

Unique Bulk Operation Identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Stop bulk operation

Stop bulk operation by bulkOperationUid.

path Parameters
bulkOperationUid
required
string
Example: b14606b90abe94acd006349f2cftd53d650d6dd545a2e40b5a83d

Unique Bulk Operation Identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Resume bulk operation

Resume bulk operation by bulkOperationUid.

path Parameters
bulkOperationUid
required
string
Example: b14606b90abe94acd006349f2cftd53d650d6dd545a2e40b5a83d

Unique Bulk Operation Identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object
batchSize
integer
batchDelay
integer
stopThreshold
integer

Responses

Request samples

Content type
application/json
{
  • "rollingUpdate": {
    }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Archive bulk operation

Archive bulk operation by bulkOperationUid.

path Parameters
bulkOperationUid
required
string
Example: b14606b90abe94acd006349f2cftd53d650d6dd545a2e40b5a83d

Unique Bulk Operation Identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

BulkOperation

Preview bulk operation impact before creation

Allows users to preview how a bulk action will affect their device network before actual execution. Bulk operations enable simultaneous management of multiple devices, saving time and effort when managing large device networks. The preview shows the expected count of affected devices, which may differ from final execution count if the operation is scheduled. This preview step is recommended to validate your bulk action configuration before committing changes across your organization's network.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
One of
name
string
required
object
object
object
operationType
required
string
Value: "SET_APPLICATION_VERSION"
required
object

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "filter": {
    },
  • "schedule": {
    },
  • "rollingUpdate": {
    },
  • "operationType": "REVOKE_DEVICE_KEY",
  • "data": { }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Organization/VPN

Get VPN configuration list

Get VPN client configuration file for current Organization.

Parameters

Field Type Required Description
organizationUid string required organization uid
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "vpnConfigurations": [
    ]
}

Generate vpn client vpn configuration and add it to VPN server

Generate vpn client vpn configuration and add it to VPN server

Parameters

Field Type Required Description
organizationUid string required organization uid
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "e286bcc40506c43f238146fd1a663cd6630e"
}

Get VPN configuration

Get VPN client configuration file for current Organization.

Parameters

Field Type Required Description
organizationUid string required organization uid
uid string required uid
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
uid
required
string
Example: {{uid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "ac46517bf93150e8e8aec009c75236c82340",
  • "configuration": "client\\r\\nproto udp\\r\\nexplicit-exit-notify\\r\\nremote 34.155.182.211 1194\\r\\ndev tun\\r\\nresolv-retry infinite\\r\\nnobind\\r\\npersist-key\\r\\npersist-tun\\r\\nremote-cert-tls server\\r\\nverify-x509-name server_g8aJNipATezF3sfj name\\r\\nauth SHA256\\r\\nauth-nocache\\r\\ncipher AES-128-GCM\\r\\ntls-client\\r\\ntls-version-min 1.2\\r\\ntls-cipher TLS-ECDHE-ECDSA-WITH-AES-128-GCM-SHA256\\r\\nignore-unknown-option block-outside-dns\\r\\nsetenv opt block-outside-dns # Prevent Windows 10 DNS leak\\r\\nverb 3\\r\\n<ca>\\r\\n-----BEGIN CERTIFICATE-----\\r\\nMIIB1zCCAX2gAwIBAgIUGuiwHq5vhpOpjllmN9pc1iusnogwCgYIKoZIzj0EAwIw\\r\\nHjEcMBoGA1UEAwwTY25faEgyOVNKZ1I3bW1WVFpabDAeFw0yNDAyMjYxMTAxMDha\\r\\nFw0zNDAyMjMxMTAxMDhaMB4xHDAaBgNVBAMME2NuX2hIMjlTSmdSN21tVlRaWmww\\r\\nWTATBgcqhkjOPQ This is an EXAMPLE SlSrINDcqY/fwTfXpFm1kOZQVJBdf0\\r\\nw8LJpOfcY+GrYMJrtIbxdnEm3G+tqC8v This is an EXAMPLE Ilhao4GYMIGV\\r\\nMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFMyuC2eQJV5BETIF/s4JIH4N4393MFkG\\r\\nA1UdIwRSMFCAFMyuC2eQJV5BETIF/s4JIH4N4393oSKkIDAeMRwwGgYDVQQDDBNj\\r\\nbl9oSDI5U0pnUjdtbVZUWlpsghQa6LAerm+Gk6mOWWY32lzWK6yeiDALBgNVHQ8E\\r\\nBAMCA This is an EXAMPLE AAwRQIgUALUHcmpIBGpj77+90YCFUHFebV2gGSC\\r\\nKiwci+u4vG8CIQDerNThdeKJNeSrw1xFOiT+wiT+k4Bse6qEH1uZw497TQ==\\r\\n-----END CERTIFICATE-----\\r\\n</ca>\\r\\n<cert>\\r\\n-----BEGIN CERTIFICATE-----\\r\\nMII This is an EXAMPLE l0bhd60nY3DDQpHFyvQEwCgYIKoZIzj0EAwIwHjEc\\r\\nMBoGA1UEAwwTY25faEgyOVNKZ1I3bW1WVFpabDAeFw0yNDA1MDYwNzQzMjRaFw0y\\r\\nNjA4MDkwNzQzMjRaMBYxFDASBgNVBAMMC2Vaa2U3bk5SVnk4MFkwEwYHKoZIzj0C\\r\\nAQYIKoZIzj0DAQcDQgAE4SUhCcZnizboxaN0nlcjfPiJitvEfrD+cuDDjQQ/hx+i\\r\\nGDwV9pI9UQoak+YRzU/HA2OUdo/y1beAuWN8zytJsqOBqjCBpzAJBgNVHRMEAjAA\\r\\nMB0GA1UdDgQWBBTu0MBYxC2zO/thn2twV5U4ci+tRTBZBgNVHSMEUjBQgBTMrgtn\\r\\nkCVeQREyBf7OCSB+DeN/d6EipCAwHjEcMBoGA1UEAwwTY25faEgyOVNKZ1I3bW1W\\r\\nVFpabIIUGuiwHq5vhpOpjllmN9pc1iusnogwEwYDVR0lBAwwCgYIKwYBBQUHAwIw\\r\\nCwYDVR0PBAQDAgeAMAoGCCqGSM49BAMCA0gAMEUCIQCpsJHdkH8kGDYVfY9pjkBm\\r\\nJJM This is an EXAMPLE gRIf3kXZzG1BSxWZoHdlbKJUC7h2YrNlRsTimNDwW\\r\\n9UA=\\r\\n-----END CERTIFICATE-----\\r\\n</cert>\\r\\n<key>\\r\\n-----BEGIN PRIVATE KEY-----\\r\\nMIGH This is an EXAMPLE CCqGSM49AwEHBG0wawIBAQQgC6JhvtYB73lv/cwO\\r\\nJnohVq+RhWbC This is an EXAMPLE AAThJSEJxmeLNujFo3SeVyN8+ImK28R+\\r\\nsP5y4MONBD+H This is an EXAMPLE T8cDY5R2j/LVt4C5Y3zPK0my\\r\\n-----END PRIVATE KEY-----\\r\\n</key>\\r\\n<tls-crypt>\\r\\n#\\r\\n# 2048 bit OpenVPN static key\\r\\n#\\r\\n-----BEGIN OpenVPN Static key V1-----\\r\\n0ee2cc97240a6804ce9c9ac121228466\\r\\n463939f8fc8800a966a50a498cc92b65\\r\\n8cf23923e8100a38a8af2ec8cdecb1ab\\r\\nf648fb82c811d43bf30573fedf4cfa63\\r\\n4cd495ecce073f8b69ae59602a1ad9d6\\r\\n80b077b0b1ff3687d4b37b965d78b211\\r\\nb06553245cde72eef4470f320de5e983\\r\\ncdc98dcd3b2b2ef7ce9a2b20b600e3f3\\r\\n9ce4bd8ef09bb8e4ae3eda88dc587756\\r\\ne0a86f7e293ff15e2e59b4bfba7b378b\\r\\n185ecfae041c60b4daad25ad0a69a55f\\r\\ne6b0514744d92b0cf7bc4a9194ae9bda\\r\\n52e4badf276c7c29563e88dd72fef7f4\\r\\ne This is an EXAMPLE 2cfc0f030c7\\r\\n0e2b50eb4ce0977f77d480f9bfe1c195\\r\\n8ed030a599bb3236b90bd1f96c4670f8\\r\\n-----END OpenVPN Static key V1-----\\r\\n</tls-crypt>\n"
}

Revoke VPN configuration

Revoke VPN client configuration for current Organization.

Parameters

Field Type Required Description
organizationUid string required organization uid
uid string required uid
path Parameters
organizationUid
required
string
Example: {{organizationUid}}
uid
required
string
Example: {{uid}}
header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "message": "OK"
}

Organization/System Log

Get Organization System Logs

Get system logs for organization.

Parameters

This endpoint uses pagination. For more information view Pagination section.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Export

Request export of list of devices

Request export of list of devices in the current organization. It's an asynchronous operation. Response contains header Link, that contains link to the result. Once the export is ready, it will contain the URL where it can be downloaded.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
object
Array of strings

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "fields": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get export

Get export result, if ready. Otherwise the response indicates whether the export is still pending or if there was a problem. After an export request is created, poll this endpoint until it's resolved

path Parameters
uid
required
string
Example: {{uid}}
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{}

CustomScript

Get Custom Scripts

Get list of Custom Scripts

query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

uids
Array of strings

Filter by UIDs

organizationUids
Array of strings

Filter by Organization UIDs

name
string

Filters results based on a partial match of the name. Returns records where the name contains the specified text.

title
string

Filters results based on a partial match of the title. Returns records where the title contains the specified text.

dangerLevel
string
Enum: "low" "medium" "high" "critical"

Filter by danger level

platforms
Array of strings
Items Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"

Filter by platforms

tagUids
Array of strings

Filter by tags

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Create Custom Script

Create new custom script in organization by customScriptUid.

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
organizationUid
string

Required if authenticating as an Account

name
required
string
title
required
string
description
string
dangerLevel
required
string
Enum: "low" "medium" "high" "critical"
tagUids
Array of strings

Responses

Request samples

Content type
application/json
{
  • "name": "test",
  • "title": "test",
  • "description": "test",
  • "dangerLevel": "low",
  • "tagUids": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Count Custom Scripts

Count Custom Scripts

query Parameters
uids
Array of strings

Filter by UIDs

organizationUids
Array of strings

Filter by Organization UIDs

name
string

Filter by name

title
string

Filter by title

dangerLevel
string
Enum: "low" "medium" "high" "critical"

Filter by danger level

platforms
Array of strings
Items Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"

Filter by platforms

tagUids
Array of strings

Filter by tags

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Get Custom Script

Get Custom Script.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "name": "test",
  • "title": "test",
  • "description": "test",
  • "dangerLevel": "low",
  • "organizationUid": "5d9bd72df4d187053cc7d2474c781cf590b10d2d7a12d7a6db",
  • "createdAt": "2021-12-08T14:29:50.372Z",
  • "updatedAt": "2021-12-08T14:29:50.372Z",
  • "createdBy": {
    },
  • "updatedBy": {
    },
  • "supportedPlatforms": [
    ],
  • "tagUids": [
    ]
}

Update Custom Script

Update existing custom script in organization by customScriptUid.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
string
title
string
description
string
dangerLevel
string
Enum: "low" "medium" "high" "critical"
tagUids
Array of strings

Responses

Request samples

Content type
application/json
{
  • "name": "test",
  • "title": "test",
  • "description": "test",
  • "dangerLevel": "low",
  • "tagUids": [
    ]
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Delete Custom Script

Delete Custom Script.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

query Parameters
deleteVersions
boolean

Should delete all versions of the custom script. If not provided, only the custom script will be deleted or the request will fail if the custom script has versions.

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

CustomScript/Version

Get Custom Script Versions

Get Custom Script Versions by customScriptUid

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

platforms
Array of strings
Items Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"

Filter by platforms

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Custom Script Version

Create new Custom Script Version

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
jsApiVersion
string

Picks which version of JS API will be available in the Custom Script runtime. This only applies to "browser" runtime. If not provided, the latest version will be used.

version
required
string
Array of objects or objects or objects or objects or objects or objects or objects
Default: []

Responses

Request samples

Content type
application/json
{
  • "jsApiVersion": "string",
  • "version": "string",
  • "configDefinition": [ ]
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Count Custom Script Versions

Count Custom Script Versions by customScriptUid

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Get Custom Script Version

Get Custom Script Version.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "string",
  • "customScriptUid": "string",
  • "version": "string",
  • "configDefinition": [ ],
  • "jsApiVersion": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "publishedAt": "2019-08-24T14:15:22Z",
  • "deprecatedAt": "2019-08-24T14:15:22Z",
  • "tagUids": [
    ]
}

Update Custom Script Version

Update Custom Script Version.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
Array of objects or objects or objects or objects or objects or objects or objects
Default: []
jsApiVersion
string

Picks which version of JS API will be available in the Custom Script runtime. This only applies to "browser" runtime. If not provided, the latest version will be used.

Responses

Request samples

Content type
application/json
{
  • "configDefinition": [
    ],
  • "jsApiVersion": "1.0.0"
}

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Delete Custom Script Version

Delete Custom Script Version

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

CustomScript/Version/Platform

Get Custom Script Version Platforms

Get Custom Script Version Platforms.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Custom Script Version Platform

Create Custom Script Version Platform.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"

Available supported application types. Type "chrome" refers to legacy Chrome OS application, which was discontinued and is deprecated. Use "chromeos" for the current Chrome OS application.

runtime
required
string
Enum: "ps1" "bash" "sh" "nodejs" "browser" "brs"
md5Checksum
required
string
mainFile
required
string

Responses

Request samples

Content type
application/json
{
  • "platform": "tizen",
  • "runtime": "sh",
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "mainFile": "run.sh"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Custom Script Version Platform

Get Custom Script Version Platform.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "platform": "linux",
  • "runtime": "sh",
  • "archiveUri": "https://example.com",
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "mainFile": "run.sh"
}

Update Custom Script Version Platform

Update Custom Script Version Platform.

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
runtime
required
string
Enum: "ps1" "bash" "sh" "nodejs" "browser" "brs"
md5Checksum
required
string
mainFile
required
string

Responses

Request samples

Content type
application/json
{
  • "runtime": "sh",
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "mainFile": "run.sh"
}

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Delete Custom Script Version Platform

Delete Custom Script Version Platform

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Get presigned URL to upload Custom Script Version Platform archive

Get presigned URL to upload Custom Script Version Platform archive containing the code

path Parameters
customScriptUid
required
string
Example: {{customScriptUid}}

Unique Custom Script Identification

version
required
string
Example: 1.0.0

version of the custom script

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the custom script

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
md5Checksum
required
string

Responses

Request samples

Content type
application/json
{
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab"
}

Response samples

Content type
application/json
{
  • "upload": {
    },
  • "file": {}
}

License

Get licenses

Get all licenses

query Parameters
descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

uids
Array of strings

Filter by UIDs

companyNetworkUid
string

Filter by company network UID

companyUid
string

Filter by company UID that activated the license

description
string

Filter by description

status
Array of strings
Items Enum: "active" "expired" "used"
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create license

Creates a license.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
companyNetworkUid
required
string

ID of a company network

licenseType
required
string
Enum: "trial" "production"

Type of license (trial, production)

credits
required
number [ 1 .. 2000000 ]

Number of credits to be assigned to the license

description
string <= 500 characters

Additional information about the license

object

This object enables license creator to restrict license validity. It can be valid from some date in the future and it can also expire on some date. Both fields are optional.

Responses

Request samples

Content type
application/json
{
  • "companyNetworkUid": "company-network-123",
  • "licenseType": "test",
  • "credits": 10,
  • "description": "license for company 123",
  • "validity": {
    }
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Count licenses

Count licenses

query Parameters
uids
Array of strings

Filter by UIDs

companyNetworkUid
string

Filter by company network UID

companyUid
string

Filter by company UID that activated the license

description
string

Filter by description

status
Array of strings
Items Enum: "active" "valid" "used"
header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "count": 5
}

Redeem license

Redeems a license for a company by a license key.

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
licenseKey
required
string

License key to be redeemed

companyUid
required
string

UID of the company

Responses

Request samples

Content type
application/json
{
  • "licenseKey": "8566D-9RPSY-39N95-2HAJR-715D8",
  • "companyUid": "o45563j45oi4567u6453452o55i34j33"
}

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Get license

Gets license by licenseUid.

path Parameters
licenseUid
required
string
Example: {{licenseUid}}

Unique license identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Content-Type
string
Example: application/x-www-form-urlencoded

Responses

Response samples

Content type
application/json
{
  • "uid": "9hgd8f76hdf87g6h89dfg7h987d6fghe",
  • "createdBy": {
    },
  • "companyNetworkUid": "company-network-123",
  • "licenseType": "trial",
  • "licenseKey": "8566D-9RPSY-39N95-2HAJR-715D8",
  • "description": "license for company 123",
  • "validity": {
    },
  • "createdAt": "2025-01-01T11:00:00.000Z",
  • "credit": 100,
  • "updatedAt": "2025-01-01T11:00:00.000Z",
  • "activatedBy": {
    }
}

Delete one license

Deletes one license by licenseUid.

path Parameters
licenseUid
required
string
Example: {{licenseUid}}

Unique license identification

header Parameters
x-auth
string
Example: {{x-auth}}

Authorization key and token

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Plugin (Coming Soon)

List plugins

Retrieves a list of plugins for the organization

query Parameters
limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

name
string

Filter by plugin name

platform
Array of strings
Items Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"

Filter by supported platforms

status
Array of strings
Items Enum: "draft" "published" "deprecated"

Filter by plugin status

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create plugin

Creates a new plugin

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
name
required
string

Plugin name

description
string

Plugin description

object
object

Responses

Request samples

Content type
application/json
{
  • "name": "Color Profile Manager",
  • "description": "Manages device color profiles and S-curve settings",
  • "version": "1.0.0"
}

Response samples

Content type
application/json
{
  • "uid": "plugin_abc123def456",
  • "name": "Color Profile Manager",
  • "description": "Manages device color profiles and S-curve settings",
  • "supportedPlatforms": [
    ],
  • "createdAt": "2024-01-15T10:30:00.000Z",
  • "updatedAt": "2024-01-20T14:45:00.000Z",
  • "createdBy": {
    },
  • "updatedBy": {
    }
}

Get plugin

Retrieves a specific plugin by UID

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "plugin_abc123def456",
  • "name": "Color Profile Manager",
  • "description": "Manages device color profiles and S-curve settings",
  • "supportedPlatforms": [
    ],
  • "createdAt": "2024-01-15T10:30:00.000Z",
  • "updatedAt": "2024-01-20T14:45:00.000Z",
  • "createdBy": {
    },
  • "updatedBy": {
    }
}

Update plugin

Updates an existing plugin

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
required
name
required
string

Plugin name

description
string

Plugin description

object
object

Responses

Request samples

Content type
application/json
{
  • "name": "Color Profile Manager Pro",
  • "description": "Advanced color profile management with enhanced S-curve controls",
  • "status": "published"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Delete plugin

Deletes a plugin by UID

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

query Parameters
deleteVersions
boolean

Should delete all versions of the plugin. If not provided, only the plugin will be deleted or the request will fail if the plugin has versions.

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Responses

Response samples

Content type
application/json
{
  • "status": 400,
  • "message": "Bad request",
  • "errorCode": 400001,
  • "errorName": "EXAMPLE_BAD_REQUEST",
  • "errorDetail": "Example \"400 Bad Request\" error"
}

Plugin/Version (Coming Soon)

List plugin versions

Retrieves all versions of a specific plugin

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

query Parameters
limit
number
Example: limit=50

Start paginating result by given number items on page. Next page link is available in response under header Link. E.g.: <https://api.signageos/v1/example?limit=50&until=2020-10-22T16%3A10%3A00.000Z>; rel="next"

descending
boolean
Default: false
Example: descending=true

Order resource in descending or ascending order by createdAt.

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create plugin version

Creates a new version of an existing plugin

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
version
required
string

Version number

changelog
string

Version changelog

object
object

Responses

Request samples

Content type
application/json
{
  • "version": "1.3.0",
  • "changelog": "Added support for advanced S-curve presets"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get plugin version by uid

Retrieves a specific version of a specific plugin

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "uid": "xyz789abc123",
  • "pluginUid": "abc123def456",
  • "version": "1.2.0",
  • "status": "published",
  • "changelog": "Improved color profile detection accuracy",
  • "createdAt": "2024-01-20T14:45:00.000Z",
  • "updatedAt": "2024-01-20T14:45:00.000Z",
  • "createdBy": {
    },
  • "updatedBy": {
    }
}

Update plugin version

Updates a specific version of an existing plugin

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
version
required
string

Version number

changelog
string

Version changelog

object
object

Responses

Request samples

Content type
application/json
{
  • "version": "1.3.0",
  • "changelog": "Added support for advanced S-curve presets"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Delete plugin version

Deletes a specific version of an existing plugin

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Plugin/Version/Platform (Coming Soon)

Get Plugin Version Platforms

Get all existing platforms for a specific Plugin version.

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create Plugin Version Platform

Add a new supported platform for specific Plugin version.

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"

Available supported application types. Type "chrome" refers to legacy Chrome OS application, which was discontinued and is deprecated. Use "chromeos" for the current Chrome OS application.

archiveUri
required
string
md5Checksum
required
string
mainFile
required
string

Responses

Request samples

Content type
application/json
{
  • "platform": "tizen",
  • "archiveUri": "https://example.com",
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "mainFile": "bundle.js"
}

Response samples

Content type
application/json
{
  • "message": "OK"
}

Get Plugin Version Platform

Get supported platforms for a specific Plugin version.

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the plugin

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "platform": "tizen",
  • "archiveUri": "https://example.com",
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "mainFile": "bundle.js"
}

Update Plugin Version Platform

Update platform for a specific Plugin version.

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the plugin

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
md5Checksum
required
string
mainFile
required
string

Responses

Request samples

Content type
application/json
{
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab",
  • "mainFile": "bundle.js"
}

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Delete Plugin Version Platform

Delete platform for a specific Plugin version

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the plugin

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json

Responses

Response samples

Content type
application/json
{
  • "status": 404,
  • "message": "Resource not found",
  • "errorCode": 404001,
  • "errorName": "EXAMPLE_NOT_FOUND",
  • "errorDetail": "Example \"404 Not Found\" error"
}

Get presigned URL to upload Plugin Version Platform archive

Get presigned URL to upload Plugin Version Platform archive containing the code

path Parameters
pluginUid
required
string
Example: plugin_abc123def456

Unique plugin identification

version
required
string
Example: 1.3.0

Plugin version

platform
required
string
Enum: "sssp" "tizen" "webos" "android" "brightsign" "linux" "windows" "default" "chromeos" "chrome"
Example: tizen

platform of the plugin

header Parameters
x-auth
string
Example: {{x-auth-account}}

Account authorization key and token

Content-Type
string
Example: application/json
Request Body schema: application/json
md5Checksum
required
string

Responses

Request samples

Content type
application/json
{
  • "md5Checksum": "5c407402c8268f54d1459946de7ba7a2b7711788d9bb036aab"
}

Response samples

Content type
application/json
{
  • "upload": {
    },
  • "file": {}
}