管理合規 API

查詢活動動態

擷取、篩選及分頁瀏覽您組織的 Compliance API 活動動態。

Compliance API 需申請後方可啟用。Claude Enterprise 組織可存取完整的 API；Claude Console 組織僅可存取活動動態（本頁面）。請參閱取得 Compliance API 存取權限。

必要範圍： Compliance Access Key 或 Admin API 金鑰上的 read:compliance_activities。

帶有此範圍的 Compliance Access Key（sk-ant-api01-...）與 Admin API 金鑰（sk-ant-admin01-...）皆可呼叫活動動態。請參閱取得 Compliance API 存取權限，了解各金鑰類型在何種條件下帶有此範圍。

「Activity Feed」（活動動態）會以反向時間順序記錄您組織中發生的每一項驗證、對話、檔案、專案、管理及平台操作。活動在發生後 1 分鐘內即可查詢，並保留 6 年。

cURL

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

Response

{
  "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": "[email protected]",
        "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"
}

篩選活動

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

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

cURL

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"

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

分頁瀏覽結果

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

Compliance API 依端點系列使用兩種分頁機制：

端點系列	排序順序	機制	參數
活動	最新優先	游標	`after_id`、`before_id`（回傳為 `first_id`、`last_id`）
對話與對話訊息	最舊優先	游標	`after_id`、`before_id`（回傳為 `first_id`、`last_id`）
專案、專案附件、使用者、角色、角色權限、群組、群組成員	依端點而定	頁面權杖	`page`（回傳為 `next_page`）

組織與檔案不進行分頁：列出組織會在單一回應中回傳所有結果，而檔案則依 ID 個別擷取。

分頁游標與頁面權杖皆為不透明字串：請原封不動地傳回。其內部格式並不穩定，解析它們將會在無預警的情況下失效。每個請求中只能設定 after_id 或 before_id 其中之一，且兩種機制皆會回傳 has_more，讓您知道何時停止。

若要分頁瀏覽活動：

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

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

游標可在重試時安全重複使用。 來自成功回傳頁面的游標或頁面權杖仍然有效；失敗的請求（5xx、逾時、網路錯誤）不會推進您的位置。請使用相同的游標重試相同的請求。只有在您已儲存游標所指向之後的頁面後，才移至下一個游標。

cURL

# 擷取第一頁（最新的活動優先）並記錄其結尾游標。
last_id=$(curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=2" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" | jq -er '.last_id')

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

生產環境的回填迴圈會透過 has_more 與 last_id 驅動迭代，以分頁瀏覽較舊的活動：

從您儲存的游標開始（或省略 after_id 以從頭開始）。
使用 after_id=<last_id> 分頁瀏覽，直到 has_more 為 false。
只有在您已儲存其涵蓋的每一頁後，才保存最終的 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，具有以下頂層結構：

欄位	類型	說明
`id`	字串	活動的唯一識別碼。
`created_at`	RFC 3339 字串	活動發生的時間。
`organization_id`	字串或 null	活動發生的組織，若事件未繫結至組織（登入、登出、Compliance API 呼叫）則為 `null`。
`organization_uuid`	字串或 null	範圍與 `organization_id` 相同，以 UUID 表示。
`actor`	Actor 聯集	執行活動的人員或系統。請參閱下方的執行者表格。
`type`	字串	活動類型，例如 `claude_chat_created`。
其他欄位	不定	類型專屬欄位，例如對話事件上的 `claude_chat_id` 或檔案事件上的 `filename`。請參閱 API 參考文件中的查詢合規活動以取得各類型的欄位清單。

actor 欄位是一個判別聯集。type 判別子會告訴您存在哪些其他欄位：

`actor.type`	出現時機	主要欄位
`user_actor`	已登入的 claude.ai 或 Claude Console 使用者執行了該操作。	`email_address`、`user_id`、`ip_address`、`user_agent`
`api_actor`	請求使用客戶核發的 API 金鑰呼叫 Claude API 或 Compliance API。無論使用 Compliance Access Key 或 Admin API 金鑰，Compliance API 呼叫皆會產生此執行者類型。	`api_key_id`、`ip_address`、`user_agent`
`admin_api_key_actor`	組織管理員使用 Admin API 金鑰管理使用者、邀請、工作區或 API 金鑰。	`admin_api_key_id`
`unauthenticated_user_actor`	在登入完成前發生的操作，例如 `sso_login_initiated`。	`unauthenticated_email_address`、`ip_address`、`user_agent`
`anthropic_actor`	Anthropic 對組織執行了操作，例如透過內部工具。	`email_address`（一律為 `null`；存在此欄位是為了與 `user_actor` 保持結構一致，因為 Anthropic 操作人員並非以個別電子郵件表示）
`scim_directory_sync_actor`	身分識別提供者（例如 Okta、Microsoft Entra ID 或 JumpCloud）透過 SCIM 目錄同步推送了變更。	`workos_event_id`、`directory_id`、`idp_connection_type`（可為 null；例如 `OktaSCIMV2`、`AzureSCIMV2`）

建置向前相容的處理常式。 請直接傳遞無法識別的 type 與 actor.type 值，並忽略您的處理常式未預期的欄位，如此當新的活動類型推出時，您的整合仍可持續運作。

後續步驟

API 參考文件

GET /v1/compliance/activities 的完整請求與回應結構描述，包含所有支援的 activity_types[] 值。

擷取與刪除對話、檔案及專案

查詢與刪除您在動態中找到的活動之基礎內容（需要 Compliance Access Key）。

設計您的合規整合

選擇輪詢或批次取用模式，並規劃 SIEM 關聯。

處理 Compliance API 錯誤

完整的錯誤目錄。

Was this page helpful?

管理合規 API

查詢活動動態

擷取、篩選及分頁瀏覽您組織的 Compliance API 活動動態。

Compliance API 需申請後方可啟用。Claude Enterprise 組織可存取完整的 API；Claude Console 組織僅可存取活動動態（本頁面）。請參閱取得 Compliance API 存取權限。

必要範圍： Compliance Access Key 或 Admin API 金鑰上的 read:compliance_activities。

cURL

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

Response

{
  "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": "[email protected]",
        "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"
}

篩選活動

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

cURL

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"

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

分頁瀏覽結果

Compliance API 依端點系列使用兩種分頁機制：

端點系列	排序順序	機制	參數
活動	最新優先	游標	`after_id`、`before_id`（回傳為 `first_id`、`last_id`）
對話與對話訊息	最舊優先	游標	`after_id`、`before_id`（回傳為 `first_id`、`last_id`）
專案、專案附件、使用者、角色、角色權限、群組、群組成員	依端點而定	頁面權杖	`page`（回傳為 `next_page`）

組織與檔案不進行分頁：列出組織會在單一回應中回傳所有結果，而檔案則依 ID 個別擷取。

若要分頁瀏覽活動：

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

cURL

# 擷取第一頁（最新的活動優先）並記錄其結尾游標。
last_id=$(curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=2" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" | jq -er '.last_id')

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

生產環境的回填迴圈會透過 has_more 與 last_id 驅動迭代，以分頁瀏覽較舊的活動：

從您儲存的游標開始（或省略 after_id 以從頭開始）。
使用 after_id=<last_id> 分頁瀏覽，直到 has_more 為 false。
只有在您已儲存其涵蓋的每一頁後，才保存最終的 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，具有以下頂層結構：

欄位	類型	說明
`id`	字串	活動的唯一識別碼。
`created_at`	RFC 3339 字串	活動發生的時間。
`organization_id`	字串或 null	活動發生的組織，若事件未繫結至組織（登入、登出、Compliance API 呼叫）則為 `null`。
`organization_uuid`	字串或 null	範圍與 `organization_id` 相同，以 UUID 表示。
`actor`	Actor 聯集	執行活動的人員或系統。請參閱下方的執行者表格。
`type`	字串	活動類型，例如 `claude_chat_created`。
其他欄位	不定	類型專屬欄位，例如對話事件上的 `claude_chat_id` 或檔案事件上的 `filename`。請參閱 API 參考文件中的查詢合規活動以取得各類型的欄位清單。

actor 欄位是一個判別聯集。type 判別子會告訴您存在哪些其他欄位：

`actor.type`	出現時機	主要欄位
`user_actor`	已登入的 claude.ai 或 Claude Console 使用者執行了該操作。	`email_address`、`user_id`、`ip_address`、`user_agent`
`api_actor`	請求使用客戶核發的 API 金鑰呼叫 Claude API 或 Compliance API。無論使用 Compliance Access Key 或 Admin API 金鑰，Compliance API 呼叫皆會產生此執行者類型。	`api_key_id`、`ip_address`、`user_agent`
`admin_api_key_actor`	組織管理員使用 Admin API 金鑰管理使用者、邀請、工作區或 API 金鑰。	`admin_api_key_id`
`unauthenticated_user_actor`	在登入完成前發生的操作，例如 `sso_login_initiated`。	`unauthenticated_email_address`、`ip_address`、`user_agent`
`anthropic_actor`	Anthropic 對組織執行了操作，例如透過內部工具。	`email_address`（一律為 `null`；存在此欄位是為了與 `user_actor` 保持結構一致，因為 Anthropic 操作人員並非以個別電子郵件表示）
`scim_directory_sync_actor`	身分識別提供者（例如 Okta、Microsoft Entra ID 或 JumpCloud）透過 SCIM 目錄同步推送了變更。	`workos_event_id`、`directory_id`、`idp_connection_type`（可為 null；例如 `OktaSCIMV2`、`AzureSCIMV2`）

後續步驟

API 參考文件

GET /v1/compliance/activities 的完整請求與回應結構描述，包含所有支援的 activity_types[] 值。

擷取與刪除對話、檔案及專案

查詢與刪除您在動態中找到的活動之基礎內容（需要 Compliance Access Key）。

設計您的合規整合

選擇輪詢或批次取用模式，並規劃 SIEM 關聯。

處理 Compliance API 錯誤

完整的錯誤目錄。

Was this page helpful?