Get node posture

GET

/api/v1/nodes/{env}/node/{uuid}/posture

curl --request GET \
  --url https://osctrl.net/api/v1/nodes/example/node/example/posture \
  --header 'Authorization: <Authorization>'

Returns security and compliance posture data for a node.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

env

required

string

Environment name or UUID

uuid

required

string

Node UUID

Responses

200

OK

Media typeapplication/json

Array<object>

object

category

string

created_at

string

environment

string

first_seen

FirstSeen is when this category was first observed for this node.

string

id

integer

last_seen

string

node_uuid

string

query_name

QueryName is the full osquery scheduled-query name including prefix.

string

row_count

RowCount is the number of rows in the result (e.g. 3 packages, 5 users).

integer

summary

Summary is a compact JSON snapshot of the result data. For small results this is the full columns array; for large results it’s truncated to the first 100 rows to keep the record manageable.

string

updated_at

string

Example^generated

[
  {
    "category": "example",
    "created_at": "example",
    "environment": "example",
    "first_seen": "example",
    "id": 1,
    "last_seen": "example",
    "node_uuid": "example",
    "query_name": "example",
    "row_count": 1,
    "summary": "example",
    "updated_at": "example"
  }
]

401

Unauthorized

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

404

Not found

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}