List user audit events¶

View a specified user’s activity records in the current workspace in chronological order.

HTTP
GET $CLOUDSIGMA_API_BASE/workspaces/{workspace_id}/iam/users/{user_id}/audit-events

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

First select the user. To continue reading, retain the cursor returned by the previous page.

Request parameters¶

Input examples

Shell
curl -G "$CLOUDSIGMA_API_BASE/workspaces/$WORKSPACE_ID/iam/users/$USER_ID/audit-events" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --data-urlencode "limit=20"

Parameter description

Path parameters

Parameter	Type	Required	Description
`workspace_id`	string	Yes	Target workspace ID.
`user_id`	string	Yes	ID of the user whose activity records you want to view.

Query parameters

Parameter	Type	Required	Description
`cursor`	string	No	Cursor returned by the previous page.
`limit`	integer	No	Number of items per page. The default is 20; the range is 1–100.

When data.next_cursor is non-empty, use it as the cursor for the next request. Stop paginating when data.next_cursor is empty.

Successful response¶

On success, returns structured user activity records for the current page and the next-page cursor.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "events": [],
    "next_cursor": "",
    "request_id": "req-001",
    "trace_id": "trace-001"
  }
}

Field details

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.
`data.events`	object (array)	User activity records for the current page.
`data.next_cursor`	string	Cursor for the next page; empty when there is no next page.
`data.request_id`	string	Request correlation ID.
`data.trace_id`	string	Trace ID.

Error response¶

Response example

JSON
{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

Field details

Field	Type	Description
`code`	string	Error code.
`msg`	string	Error message.
`data`	null	—

Last updated on Sep 15, 2026