문서 본문으로 이동
문서API 참조팀 이벤트 목록
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를 페이지당 최대 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[].actionstring

member_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 | null

ISO 8601 시간이며 없거나 유효하지 않으면 null입니다.

nextCursorstring | null

후속 기록이 있을 때만 반환된 마지막 기록의 ID이며 그 외에는 null입니다. 다음 페이지의 before로 전달합니다.