Facts about the box

GET

/system

const url = 'http://127.0.0.1:7700/api/system';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://127.0.0.1:7700/api/system \
  --header 'Authorization: Bearer <token>'

The product, edition, version and build, hostname, time zone, network, box id and name, owner, whether a model key is set and where the Droid download stands, whether agents are paused, start time and uptime. A Business box adds its company. For first-run setup and Settings.

Authorizations

deviceToken
accessToken

Responses

200

The facts.

application/json

object

model

Whether tasks can run: the vault holds a model key. via is factory with FACTORY_API_KEY, anthropic with only ANTHROPIC_API_KEY, or null with neither.

object

ready

boolean

via

string | null

Allowed values: factory anthropic

droid

Where the Droid download stands. A task that needs Droid waits, queued, until ready.

object

state

required

string

Allowed values: ready downloading offline retrying missing

message

required

string

company

Business only.

string

paused

object

paused

required

boolean

required

Who pulled the switch. GurtOS when the box paused itself.

string | null

required

string | null format: date-time

via

required

The phone or screen it came from, or an unreadable permissions file when the box paused itself. Check Settings, Permissions, then resume.

string | null

product

string

edition

string

Allowed values: server personal business

editionName

string

version

string

build

The commit that was installed

string

hostname

string

timezone

string

network

object

online

boolean

interfaces

Array<object>

object

name

string

address

string

mac

string

boxId

string

boxName

string

owner

string | null

startedAt

string format: date-time

uptimeSec

integer

Example

{
  "model": {
    "via": "factory"
  },
  "droid": {
    "state": "ready"
  },
  "product": "GurtOS",
  "edition": "server",
  "editionName": "GurtOS Server",
  "hostname": "gurt-3f9a1c"
}