Skip to content

Retrieve real-time configuration change audit logs with filtering options
deprecated

Request

This is deprecated; use /v2/audit/changes instead.

Requires audits::read:config permission.

Security
JWTAuthorizer
Query
itemIDstring

ID for the item to audit. If specified, must include itemType.

itemTypestring

Type of item to audit, e.g., Node or Cluster. If specified, must include itemID

timestampstring

Start time (unix timestamp) to query from

eTimestring

End time (unix timestamp) to query to

auditEventstring

Audit type to filter (create, delete, change, or action)

ipstring

IP address filter

userstring

User name filter

detailsstring

Details text filter

curl -i -X GET \
  'https://apidocs.trustgrid.io/_mock/audit/tail/config?itemID=string&itemType=string&timestamp=string&eTime=string&auditEvent=string&ip=string&user=string&details=string' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
Array [
auditTypestring

Type of change

Enum:"change""create""delete""action"
ipstring

IP address of the client that initiated the change

Example:"44.44.44.43"
itemIdstring

Unique ID of the item that was changed

Example:"19084f81-5668-41ee-adbe-295e4c65531a"
itemTypestring

Type of the item that was changed

Example:"Node"
messagestring

Message describing the change

Example:"Node license created"
timestampnumber

Unix timestamp when the change happened

Example:1729533326
uidstring

Unique ID of the change

Example:"8845f684-4ffe-4b01-a62f-5619a7eae486"
userNamestring

User name of the client that initiated the change

Example:"admin@trustgrid.io"
orgstring

Organization ID

typestring

Object type discriminator

Example:"AuditLog"
]
Response
[
  {
    "auditType": "change",
    "ip": "44.44.44.43",
    "itemId": "19084f81-5668-41ee-adbe-295e4c65531a",
    "itemType": "Node",
    "message": "Node license created",
    "timestamp": 1729533326,
    "uid": "8845f684-4ffe-4b01-a62f-5619a7eae486",
    "userName": "admin@trustgrid.io",
    "org": "string",
    "type": "AuditLog"
  }
]