List Operation Logs

List NineData operation audit logs with pagination. This API requires Audit module permissions.

Endpoint: /openapi/v1/actionTrail/list

Method: GET

Request parameters

Parameter	Type	Required	Description
accountId	String	No	Account ID. Omit it to query all accounts.
startTime	DateTime	No	Start of the operation time range in ISO 8601 format, for example, 2025-07-31T09:12:30Z.
endTime	DateTime	No	End of the operation time range in ISO 8601 format.
module	String	No	Module. See the values below.
type	String	No	Event type. See the values below.
objectId	String	No	Event object ID.
current	Integer	No	Current page number, starting at 1. Default: 1.
pageSize	Integer	No	Records per page. Default: 10; maximum: 1000.

Module values

sqlWindow, dsql, sqlTask, dataGenerate, sqlExport, dataExport, dataImport, dataArchive, sqlReview, dataTrack, slowLog, sqlReadSensitive, sqlWriteSensitive, backupTask, restore, backupQuery, replicationTask, compareData, compareSchema, datasourceOperate, gateway, accesscredential, privatelink, user, role, organization, permissionApply, ruleSet, rule, approval, reportManage, group, flow, externalApplication, and externalApproval.

Event type values

create, modify, delete, execute, revert, cancel, export, transfer, login, download, enable, disable, debug, start, suspend, and stop.

Response parameters

Parameter	Type	Description
success	Boolean	Whether the request succeeded.
requestId	String	Request ID.
current	Integer	Current page.
pageSize	Integer	Page size.
total	Integer	Total number of records.
data	Array	Operation log details.
data[].trailId	String	Log ID.
data[].eventTime	DateTime	Operation time.
data[].accountId	String	Account ID.
data[].accountName	String	Account name.
data[].module	String	Module.
data[].type	String	Event type.
data[].objectId	String	Event object ID.
data[].detail	String	Event detail.

Success response

{
  "success": true,
  "requestId": "<requestId>",
  "current": 1,
  "pageSize": 10,
  "total": 1,
  "data": [{
    "trailId": "<trailId>",
    "eventTime": "2026-07-30T10:00:00Z",
    "accountId": "<accountId>",
    "accountName": "example-user",
    "module": "datasourceOperate",
    "type": "create",
    "objectId": "<datasourceId>",
    "detail": "<detail>"
  }]
}