Skip to content
WatchTower15Docs

public.servers.latest

GET
/servers/{server_uuid}/latest
curl --request GET \
  --url https://rest.watchtower15.com/v1/servers/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/latest \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
server_uuid
required
string format: uuid

Responses

Section titled “Responses”

200

Section titled “200”

ServersLatestResource

Media typeapplication/json
object
data
required
ServersLatestResource
object
uuid
required
string
health_status
required

One of unknown, healthy, warning, critical.

string
agent_status
required

One of active, pending_approval, revoked.

string
connectivity_state
required

Connected, catching up, delayed, unreachable, rejected, powered off or never seen: an open set. Null when no agent reports.

string | null
agent_last_seen_at
required

Epoch milliseconds.

integer | null
booted_at
required

Epoch milliseconds: when the host booted, null when its agent never reported it.

integer | null
alarm_summary
required
object
critical
required

Alarms firing at critical, over the server’s own alarms and its volumes’, ports’ and units’.

integer
warning
required
integer
ok
required
integer
inactive
required

Alarms the evaluator does not score.

integer
acknowledged
required

Of the firing ones, the acknowledged.

integer
sample
required

The newest sample of the last 15 minutes; null when there is none.

object
sampled_at
required
integer
cpu_usage_percent
required
number | null
memory_usage_percent
required
number | null
memory_used_mb
required
number | null
memory_free_mb
required
number | null
swap_usage_percent
required
number | null
swap_used_mb
required
number | null
load_avg_1m
required
number | null
load_avg_5m
required
number | null
load_avg_15m
required
number | null
disk_usage_percent
required
number | null
disk_used_gb
required
number | null
disk_free_gb
required
number | null
disk_io_read_mbps
required
number | null
disk_io_write_mbps
required
number | null
net_in_mbps
required
number | null
net_out_mbps
required
number | null
process_count
required
number | null

Example generated

{
  "data": {
    "uuid": "example",
    "health_status": "example",
    "agent_status": "example",
    "connectivity_state": "example",
    "agent_last_seen_at": 1,
    "booted_at": 1,
    "alarm_summary": {
      "critical": 1,
      "warning": 1,
      "ok": 1,
      "inactive": 1,
      "acknowledged": 1
    },
    "sample": {
      "sampled_at": 1,
      "cpu_usage_percent": 1,
      "memory_usage_percent": 1,
      "memory_used_mb": 1,
      "memory_free_mb": 1,
      "swap_usage_percent": 1,
      "swap_used_mb": 1,
      "load_avg_1m": 1,
      "load_avg_5m": 1,
      "load_avg_15m": 1,
      "disk_usage_percent": 1,
      "disk_used_gb": 1,
      "disk_free_gb": 1,
      "disk_io_read_mbps": 1,
      "disk_io_write_mbps": 1,
      "net_in_mbps": 1,
      "net_out_mbps": 1,
      "process_count": 1
    }
  }
}

401

Section titled “401”

The API key is missing, malformed, expired or revoked.

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}

403

Section titled “403”

The key or its owner does not hold what the operation needs.

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}

404

Section titled “404”

No such record in this organisation (an absent id and another organisation’s answer alike).

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}

422

Section titled “422”

The request is invalid; errors names the parameters.

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}

429

Section titled “429”

A rate limit or the organisation’s daily limit is reached; Retry-After says when to retry.

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}

500

Section titled “500”

An unexpected error.

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}

503

Section titled “503”

A data store did not answer within the request’s 10 seconds; try again shortly (store_unavailable).

Media typeapplication/problem+json
Problem
object
type
required

https://docs.watchtower15.com/api/errors/<code>/

string format: uri
title
required
string
status
required
integer
code
required
string
detail
required
string
request_id
required
string
errors
object
key
additional properties
Array<string>
limit
integer
used
integer

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "request_id": "example",
  "errors": {
    "additionalProperty": [
      "example"
    ]
  },
  "limit": 1,
  "used": 1
}