查詢 Activity Feed

「Activity Feed」（活動動態）會記錄您組織中的驗證、聊天、檔案、專案、管理及平台活動，並以時間倒序傳回。活動在發生後 1 分鐘內即可查詢，並保留 6 年。記錄不具追溯性：記錄從您的組織首次啟用 Compliance API 時開始，啟用之前的活動不會被回填。

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

{
  "data": [
    {
      "id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
      "created_at": "2026-04-10T08:09:10Z",
      "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
      "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
      "actor": {
        "type": "user_actor",
        "email_address": "user@example.com",
        "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
        "ip_address": "192.0.2.34",
        "user_agent": "Mozilla/5.0..."
      },
      "type": "claude_chat_created",
      "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    }
  ],
  "has_more": true,
  "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
  "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}

篩選活動

您可以依組織、「actor」（執行者）、活動類型，或使用點號子參數 created_at.gte、.gt、.lte 和 .lt 指定的 created_at 時間範圍進行篩選。請參閱 API 參考文件，了解各參數的類型與可接受的值。

可重複的參數使用陣列方括號查詢語法：每個值各傳入一次 activity_types[]=...、actor_ids[]=... 或 organization_ids[]=...。

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --data-urlencode "activity_types[]=claude_file_uploaded" \
  --data-urlencode "activity_types[]=claude_chat_created" \
  --data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01"

Activity Feed 會產生數百種不同的活動類型。請參閱 API 參考文件中的查詢合規活動，取得 activity_types[] 可接受值的完整清單。

分頁瀏覽結果

活動會以最新的優先傳回，created_at 相同時依活動 ID 排序，且每個回應最多傳回 limit 筆結果（預設 100，上限 5,000）。請參閱 API 參考文件，了解完整的回應結構描述。

Compliance API 依端點系列使用兩種「pagination」（分頁）機制：

檔案不進行分頁：檔案是依 ID 個別擷取。

分頁用的「cursor」（游標）與「page token」（頁面權杖）皆為不透明字串：請原封不動地傳回。其內部格式並不穩定，若加以解析，可能會在未經通知的情況下失效。每個請求中只能設定 after_id 或 before_id 其中之一，且兩種機制都會傳回 has_more，讓您知道何時停止。工作階段端點（本機與遠端）是例外：它們會傳回 next_page 但不傳回 has_more，因此請在 next_page 為 null 時停止。

若要分頁瀏覽活動：

• 將回應中的 last_id 作為 after_id 傳入，以依結果順序前進到下一頁。由於活動以最新的優先排序，下一頁會包含較舊的項目。
• 將 first_id 作為 before_id 傳入，以返回上一頁。
• 當 has_more 為 false 時停止。

游標參數決定頁面方向；端點的排序方式決定時間方向。在此，同一個 after_id 參數會取得較舊的活動。聊天則以最舊的優先排序；請參閱擷取與刪除聊天、檔案和專案，了解該處的游標語意。

# 擷取第一頁（最新的活動在前），並記下其結尾的 cursor。
last_id=$(curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=2" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" | jq -er '.last_id')

# 將 cursor 原封不動傳回，以擷取下一頁（較舊的）。
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data-urlencode "limit=2" \
  --data-urlencode "after_id=${last_id}"

正式環境的「backfill」（回填）迴圈會以 has_more 和 last_id 驅動迭代，分頁瀏覽較舊的活動：

1. 從您儲存的游標開始（或省略 after_id 以從頭開始）。
2. 使用 after_id=<last_id> 分頁瀏覽，直到 has_more 為 false。
3. 只有在您已儲存最後一個 last_id 所涵蓋的每一頁之後，才將其持久保存。

cursor = stored_cursor
loop:
  if cursor is not null:
    page = GET /v1/compliance/activities?after_id={cursor}&limit=100
  else:
    page = GET /v1/compliance/activities?limit=100
  store(page.data)
  if page.last_id is not null:
    cursor = page.last_id
  if not page.has_more: break
persist(cursor)

了解 Activity 物件

data 中的每個項目都是具有以下頂層結構的 Activity：

actor 欄位是一個「discriminated union」（可辨識聯集）。type 辨識欄位會告訴您還有哪些其他欄位存在：

user_actor 活動並不一定代表使用者本人執行了該動作。Anthropic 代表使用者執行的程序目前可能會以受影響使用者的 user_actor 而非 system_actor 出現，且此歸屬方式可能會變更。例如，來自遷移的記憶活動，如 platform_memory_store_created、platform_memory_created 和 platform_memory_deleted，就是以此方式歸屬。無論由誰執行，記憶活動都可能顯示 0.0.0.0 的 ip_address，因此僅憑此值無法識別來自平台程序的活動。

claude_*_viewed 活動表示 Claude 應用程式載入了內容，而非有人檢視了該內容。claude_chat_viewed、claude_file_viewed 和 claude_project_viewed 等類型，會在每次 Claude 應用程式從 Anthropic 伺服器載入聊天、檔案或專案時記錄。重複的載入不會被去除重複。網頁版、桌面版和行動版應用程式會在不同時機載入內容，有時是在背景中進行，也可能在不載入的情況下顯示快取副本。因此，這些活動的數量會因平台而異，且不對應於已傳送的訊息或已檢視的畫面。

關於檔案、專案文件或 artifact 的活動不包含其名稱或標題。自 2026 年 9 月 24 日起，這些活動上的 filename 和 title 欄位一律為 null、空字串或被省略，包括該日期之前記錄的活動。若要查詢名稱或標題，請使用具有 read:compliance_user_data 範圍的 Compliance Access Key，將活動的 claude_file_*、claude_proj_doc_* 或 claude_artifact_version_* ID 傳入擷取檔案與 artifacts 中對應的中繼資料端點。在檔案、文件或 artifact 被刪除後，或活動沒有此類 ID 時，您無法查詢名稱或標題。

後續步驟