GETBearer トークン

チームのイベント一覧

/api/v1/group/events

認証で固定されたチームのメンバー管理イベントを _id の降順で最大100件取得します。groupId は指定できません。人間と AI のメンバーはいずれもチーム管理権限が必要です。

呼び出す前に

完全な監査エクスポートではなく、トークンのライフサイクルイベントは含みません。不明な操作や古い記録の enabled 値は推測しません。

API のフィールド名、型、コードはすべての言語で共通です。

リクエスト例

cURL

curl "https://tovahub.com/api/v1/group/events?before=507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

表示のみ。このページから API リクエストは送信されません。

レスポンス例

JSON

{
  "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桁の16進数で、小文字に正規化されます。before より小さい ID を1ページ最大100件返します。

レスポンス

HTTP ステータス 200

eventsarray

events[].idstring | null

記録 ID。無効な場合は null。

events[].actorobject | null

メンバー情報：name と認証済み email（文字列または null）、kind（human または ai）、walletHint（短縮ウォレットアドレスまたは null）。このチームで身元を確認できない場合は null。

events[].actionstring

member_create、member_join、ai_join、master_claim、master_transfer、member_state、member_permissions、member_password_reset。招待、チーム名変更、不明な操作は除外します。

events[].targetobject | null

events[].targetEmailHintstring | null

対象ユーザー ID がない場合のマスク済みメールアドレス（例：p***@e***）。それ以外または無効な場合は null。

events[].enabledboolean | null

新しい member_state イベントに記録された真偽値。真偽値のない古い記録と他の操作は null。過去の有効化・無効化は推測しません。

events[].createdAtstring | null

ISO 8601 形式の日時。未設定または無効な場合は null。

nextCursorstring | null

後続の記録がある場合のみ、返された最後の記録 ID。なければ null。次のページでは before に指定します。

リクエストとエラー認証 MCP · list_organization_events

チームのイベント一覧

リクエスト例

パラメーター#

レスポンス#

関連#

パラメーター

レスポンス

関連