Check for updates
/instances/updates/read Read: looks, changes nothing. Scopes
The release the panel runs, the newest one its license may have, whether a security update is due, the releases it may roll back to, and how the last update, streaming and address changes went. The releases are checked every few minutes; refresh=1 checks now. Panel operators only.
Query parameters
refreshstring1asks the download server again now.One of:
"1"
Response
200 OK
versionstringrequiredThe build the panel runs.
releasestringrequiredcan be nullThe release it is, or null.
trackstringrequiredThe release track of this license.
sandboxbooleanrequiredA test build: it is offered no release.
latestobjectrequiredcan be nullThe newest release this license may have.
versionstringrequiredThe release, e.g.
2026.11.2.published_atstring (date-time)requiredcan be nullnotesstringWhat it brings, in plain words.
trackstringstableorbeta.ltsbooleanrequiredA long-term release: one the panel may roll back to.
forcedbooleanrequiredA security release: it cannot be rolled back.
allowedbooleanrequiredNot older than the newest security release, so it may be installed.
buildsobjectrequiredThe build of each part:
panel,uiandnode(the streaming software).
securitystringrequiredcan be nullThe newest security release, if any.
must_updatebooleanrequiredA security update is due: the panel installs it on its own.
forced_currentbooleanrequiredWhat runs is a security release: no rolling back.
rollbackobject[]requiredThe releases the panel may go back to.
versionstringrequiredThe release, e.g.
2026.11.2.published_atstring (date-time)requiredcan be nullnotesstringWhat it brings, in plain words.
trackstringstableorbeta.ltsbooleanrequiredA long-term release: one the panel may roll back to.
forcedbooleanrequiredA security release: it cannot be rolled back.
allowedbooleanrequiredNot older than the newest security release, so it may be installed.
buildsobjectrequiredThe build of each part:
panel,uiandnode(the streaming software).
newsobject[]requiredNotes of every newer release, newest first.
versionstringrequiredpublished_atstring (date-time)requiredcan be nullnotesstringrequired
releasesobject[]requiredEvery release, to tell which one each server runs.
versionstringrequiredThe release, e.g.
2026.11.2.published_atstring (date-time)requiredcan be nullnotesstringWhat it brings, in plain words.
trackstringstableorbeta.ltsbooleanrequiredA long-term release: one the panel may roll back to.
forcedbooleanrequiredA security release: it cannot be rolled back.
allowedbooleanrequiredNot older than the newest security release, so it may be installed.
buildsobjectrequiredThe build of each part:
panel,uiandnode(the streaming software).
checked_atstring (date-time)requirederrorstringrequiredWhy the releases could not be checked, or empty.
panelobjectrequiredHow updating the panel is going.
statestringrequiredidle,requested,running,doneorfailed.messagestringrequiredWhat the server said, in plain words.
atstringrequiredWhen it was asked or last moved (ISO 8601), or empty.
installedbooleanrequiredThe panel's server can update it from the dashboard (set up once on the server).
logstringrequiredThe end of the update's log, when it failed.
streamingobjectrequiredWhether the panel's own server streams too.
statestringrequiredidle,requested,running,doneorfailed.messagestringrequiredWhat the server said, in plain words.
atstringrequiredWhen it was asked or last moved (ISO 8601), or empty.
streamingbooleanrequireddomainstringrequiredIts main streaming address.
addressesstring[]requiredEvery address viewers may be sent to, the main one first.
rulestringrequiredHow each new viewer gets an address:
turns,least_busy,same_viewerorrandom.possiblebooleanrequiredThe panel's server can add or remove streaming from here.
addressesobjectrequiredThe panel's and its dashboard's addresses and ports.
statestringrequiredidle,requested,running,doneorfailed.messagestringrequiredWhat the server said, in plain words.
atstringrequiredWhen it was asked or last moved (ISO 8601), or empty.
panelstringrequiredWhere players and streaming servers connect.
dashboardstringrequiredWhere people sign in.
old_panelstring[]requiredEarlier panel addresses that still work.
old_dashboardstring[]requiredEarlier dashboard addresses that still work.
panel_portintegerrequiredui_portintegerrequiredThe dashboard's port.
stream_portintegerrequiredThe port the panel's own server streams on.
old_panel_portsinteger[]requiredold_ui_portsinteger[]requiredpossiblebooleanrequiredThe addresses can be changed from here.
ports_possiblebooleanrequiredThe ports can be changed from here too.
watchedbooleanrequiredA new address is kept only once it answers; otherwise the previous ones come back.
untilstringrequiredWhile a change is being watched: until when (ISO 8601), else empty.
rolled_backbooleanrequiredThe last change was put back (
messagesays why).rescueobjectrequiredcan be nullThe rescue address, open only while the addresses change; shown to the panel's owner only. Null while it is closed.
portintegerrequiredurlstringrequiredEmpty when the server's IP address is not known.
Errors
- 401 No credential, or one that is wrong, expired or revoked.
- 403 The account, or the key's or app's scopes, may not do this.
- 429 Slow down: wait the seconds in the Retry-After header, then try again.