Audit
Actions in the audit namespace of the Nexigon Hub API.
Badges mark actions of the Device API and the Admin API, whose compatibility differs from other actions.
audit_QueryAuditLogEvents
POST/api/v1/actions/invoke/audit_QueryAuditLogEventsAdmin API
Query the events recorded in the audit log.
Requires administrator permissions.
Request QueryAuditLogEventsAction
pageobjectPageRequestoptionalOpt into cursor pagination. Without this field, the existing limit applies.
2 fields
limitintegeroptionalMaximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).
- Page limit must be positive.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
Response QueryAuditLogEventsOutput
pageobjectPageInfooptionalPresent when cursor pagination was requested.
1 field
nextCursorstringPageCursoroptionalCursor for the next page; absent when no more matching rows were visible.
eventsarray<object>AuditLogEventList of audit events.
7 fields
eventIdstringAuditLogEventIdID of the audit log event.
actorobjectActorActor causing the event.
7 variants
One of the following, identified by
actor:actor: "Anonymous"An anonymous, unauthenticated actor.
actor: "System"The system itself, typically used for internal actions.
actor: "Device"A device authenticated via a specific deployment token.
deviceIdstringDeviceIdID of the device.
tokenIdstringDeploymentTokenIdID of the deployment token used for authentication.
actor: "User"A user typically authenticated via a user session.
userIdstringUserIdID of the user.
actor: "UserToken"A user authenticated via a specific token.
userIdstringUserIdID of the user.
tokenIdstringUserTokenIdID of the user token used for authentication.
actor: "ClusterNode"A cluster node.
nodeIdstringClusterNodeIdID of the cluster node.
actor: "OrganizationApiToken"An organization API token.
organizationIdstringOrganizationIdID of the organization.
tokenIdstringOrganizationApiTokenIdID of the API token.
eventstringType of the event that was recorded.
dataanyJsonValueAdditional audit data associated with the event.
createdAtstring (date-time)TimestampTimestamp indicating when the audit log event was recorded.
actionobjectAuditLogEventActionoptionalAction the event has been caused by (if any).
1 field
actionIdstringAuditLogActionIdID of the action.
jobobjectAuditLogEventJoboptionalJob the event has been caused by (if any).
1 field
jobIdstringJobIdID of the job.
referencesobjectAuditLogReferencesoptionalNames of the actors of the returned events.
Absent in responses of Nexigon Hub 2026.3 and earlier.
3 fields
usersarray<object>AuditLogUserReferenceUsers acting directly or through a user token.
3 fields
userIdstringUserIdID of the user.
displayNamestringoptionalName of the user.
emailstringEmail of the user.
devicesarray<object>AuditLogDeviceReferenceDevices.
2 fields
deviceIdstringDeviceIdID of the device.
namestringName of the device.
organizationApiTokensarray<object>AuditLogOrganizationApiTokenReferenceOrganization API tokens.
2 fields
tokenIdstringOrganizationApiTokenIdID of the API token.
namestringName of the API token.
Example
curl --fail-with-body \
-H "Authorization: Bearer $NEXIGON_TOKEN" \
-H "Content-Type: application/json" \
-d '{}' \
$NEXIGON_HUB_URL/api/v1/actions/invoke/audit_QueryAuditLogEvents{
"events": [
{
"eventId": "<audit-log-event-id>",
"actor": {
"actor": "Device",
"deviceId": "<device-id>",
"tokenId": "<deployment-token-id>"
},
"event": "<event>",
"data": {},
"createdAt": "2026-01-01T12:00:00Z"
}
]
}audit_QueryAuditLogActions
POST/api/v1/actions/invoke/audit_QueryAuditLogActionsAdmin API
Query the actions recorded in the audit log.
Requires administrator permissions.
Request QueryAuditLogActionsAction
pageobjectPageRequestoptionalOpt into cursor pagination. Without this field, the existing limit applies.
2 fields
limitintegeroptionalMaximum number of items. The default depends on the endpoint and the ceiling is configured by the Hub operator (1000 by default).
- Page limit must be positive.
cursorstringPageCursoroptionalContinue the same endpoint, scope, filters, and ordering.
Response QueryAuditLogActionsOutput
pageobjectPageInfooptionalPresent when cursor pagination was requested.
1 field
nextCursorstringPageCursoroptionalCursor for the next page; absent when no more matching rows were visible.
actionsarray<object>AuditLogActionList of actions.
6 fields
actionIdstringAuditLogActionIdID of the audit log action.
actorobjectActorActor that performed the action.
7 variants
One of the following, identified by
actor:actor: "Anonymous"An anonymous, unauthenticated actor.
actor: "System"The system itself, typically used for internal actions.
actor: "Device"A device authenticated via a specific deployment token.
deviceIdstringDeviceIdID of the device.
tokenIdstringDeploymentTokenIdID of the deployment token used for authentication.
actor: "User"A user typically authenticated via a user session.
userIdstringUserIdID of the user.
actor: "UserToken"A user authenticated via a specific token.
userIdstringUserIdID of the user.
tokenIdstringUserTokenIdID of the user token used for authentication.
actor: "ClusterNode"A cluster node.
nodeIdstringClusterNodeIdID of the cluster node.
actor: "OrganizationApiToken"An organization API token.
organizationIdstringOrganizationIdID of the organization.
tokenIdstringOrganizationApiTokenIdID of the API token.
actionstringType of the action that was performed.
datamap<string, any>JsonValueAdditional audit data associated with the action.
statusstringAuditLogActionStatusStatus associated with the action
"Rejected"Action got rejected (failed precondition check).
"Panicked"Action or precondition check panicked (e.g., due to a bug).
"Succeeded"Action was executed successfully.
"Failed"Action execution failed (e.g., due to missing permissions).
"Pending"Action is being executed.
createdAtstring (date-time)TimestampTimestamp indicating when the audit log action was recorded.
referencesobjectAuditLogReferencesoptionalNames of the actors of the returned actions.
Absent in responses of Nexigon Hub 2026.3 and earlier.
3 fields
usersarray<object>AuditLogUserReferenceUsers acting directly or through a user token.
3 fields
userIdstringUserIdID of the user.
displayNamestringoptionalName of the user.
emailstringEmail of the user.
devicesarray<object>AuditLogDeviceReferenceDevices.
2 fields
deviceIdstringDeviceIdID of the device.
namestringName of the device.
organizationApiTokensarray<object>AuditLogOrganizationApiTokenReferenceOrganization API tokens.
2 fields
tokenIdstringOrganizationApiTokenIdID of the API token.
namestringName of the API token.
Example
curl --fail-with-body \
-H "Authorization: Bearer $NEXIGON_TOKEN" \
-H "Content-Type: application/json" \
-d '{}' \
$NEXIGON_HUB_URL/api/v1/actions/invoke/audit_QueryAuditLogActions{
"actions": [
{
"actionId": "<audit-log-action-id>",
"actor": {
"actor": "Device",
"deviceId": "<device-id>",
"tokenId": "<deployment-token-id>"
},
"action": "<action>",
"data": {
"<key>": {}
},
"status": "Rejected",
"createdAt": "2026-01-01T12:00:00Z"
}
]
}