Skip to content

List node audit events

Request

Returns a paginated list of node audit events for the organization, such as connects, disconnects, and other node actions.

The x-total-count response header contains the total number of records matching the query.

Requires audits::read:node permission.

Security
JWTAuthorizer
Query
sTimestring

Start time (ISO 8601) to query from

eTimestring

End time (ISO 8601) to query to

pageinteger

Page number (1-based)

Default:1
limitinteger, <= 200

Maximum number of results per page (max 200)

Default:50
sortstring

Sort field and direction, e.g. timestamp:desc

qstring

Free-text search query

categoriesArray of strings

Filter by event categories

fqdnsArray of strings

Filter by node FQDNs

curl -i -X GET \
  'https://apidocs.trustgrid.io/_mock/v2/audit/node?sTime=string&eTime=string&page=1&limit=50&sort=string&q=string&categories=string&fqdns=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Headers
x-total-countinteger

Total number of records matching the query

Bodyapplication/json
Array [
uidstring

Unique identifier

orgstring

Organization ID

timestampstring

Timestamp of the event (ISO 8601)

Example:"2024-10-21T17:35:26Z"
categorystring

Event category

Example:"Node Action"
expiresinteger

Unix epoch timestamp (seconds) when this audit record expires

fqdnstring

FQDN of the node

valuestring

Human-readable description of the action taken

]
Response
[
  {
    "uid": "string",
    "org": "string",
    "timestamp": "2024-10-21T17:35:26Z",
    "category": "Node Action",
    "expires": 0,
    "fqdn": "string",
    "value": "string"
  }
]