팀 이벤트 목록
/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자리 16진수입니다. 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로 전달합니다.