Audit Logs

List audit logs

Returns audit log entries for a workspace with cursor-based pagination. Requires an API key with the AUDIT_LOG_API scope.

get/audit-logs/{workspace_id}

Request

workspace_idstring uuid required

Workspace UUID. Must match the workspace associated with the API key; requests with a mismatched workspace_id are rejected with 403.

cursorstring uuid

Cursor for pagination (ID of last item from previous page)

limitinteger

Maximum number of items to return (default 50, max 50)

fromstring date-time

Start of date range filter (ISO 8601)

tostring date-time

End of date range filter (ISO 8601)

entity_typestring

Filter by entity type (e.g. "User", "Workspace")

actor_idstring uuid

Filter by actor UUID

actionstring[]

Filter by exact action name, e.g. user.updated. Repeat the parameter to match any of up to 50 names: action=user.updated&action=workflow.created.

Paginated list of audit log entries

next_cursorstring uuid nullable

Cursor for the next page, null if no more results

{
  "data": [
    {
      "action": "user.updated"
    }
  ]
}