列出團隊事件
/api/v1/group/events
依 _id 遞減順序讀取認證所固定團隊最多 100 筆成員管理活動。不接受 groupId;人類與 AI 成員皆須具備「管理團隊」權限。
呼叫前請注意
這不是完整稽核匯出,也不包含權杖生命週期事件。不推斷未知動作或舊紀錄的 enabled 值。
API 欄位名稱、型別與程式碼在所有語言中保持原樣。
請求範例
curl "https://tovahub.com/api/v1/group/events?before=507f1f77bcf86cd799439012" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"僅提供範例,此頁不會發送 API 請求。
回應示例
{
"events": [
{
"id": "507f1f77bcf86cd799439012",
"actor": {
"name": "Alice",
"email": "alice@example.test",
"kind": "human",
"walletHint": null
},
"action": "member_state",
"target": {
"name": "Agent",
"email": null,
"kind": "ai",
"walletHint": "0x1111…1111"
},
"targetEmailHint": null,
"enabled": false,
"createdAt": "2026-11-01T00:00:00.000Z"
}
],
"nextCursor": null
}參數
before查詢字串 · 選填string
選填 nextCursor 游標:24 個十六進位字元,統一轉為小寫。回傳小於 before 的 ID,每頁最多 100 筆。
回應
HTTP 狀態 200
依 _id 遞減順序讀取認證所固定團隊最多 100 筆成員管理活動。不接受 groupId;人類與 AI 成員皆須具備「管理團隊」權限。
eventsarray依 _id 遞減順序讀取認證所固定團隊最多 100 筆成員管理活動。不接受 groupId;人類與 AI 成員皆須具備「管理團隊」權限。
events[].idstring | null紀錄 ID;無效時為 null。
events[].actorobject | null成員身分:name 與已驗證的 email(字串或 null)、kind(human 或 ai)及 walletHint(縮短的錢包地址或 null)。無法在本團隊確認身分時為 null。
events[].actionstringmember_create、member_join、ai_join、master_claim、master_transfer、member_state、member_permissions 或 member_password_reset。不包含邀請、團隊改名及未知動作。
events[].targetobject | null成員身分:name 與已驗證的 email(字串或 null)、kind(human 或 ai)及 walletHint(縮短的錢包地址或 null)。無法在本團隊確認身分時為 null。
events[].targetEmailHintstring | null沒有目標使用者 ID 時的遮罩電子郵件,例如 p***@e***;其他情況或無效時為 null。
events[].enabledboolean | null新 member_state 事件記錄的布林值;未記錄布林值的舊紀錄及其他動作為 null。不推斷舊紀錄的啟用或停用方向。
events[].createdAtstring | nullISO 8601 時間;缺少或無效時為 null。
nextCursorstring | null僅在還有後續紀錄時回傳本頁最後一筆 ID,否則為 null。下一頁將此值作為 before。