Claude Platform Docs

分析

取得活動摘要
GET/v1/organizations/analytics/summaries

取得某日期範圍內全組織的活動摘要。

Models
BetaActivitySummary object{ summaries }

Response for GET /v1/organizations/analytics/summaries.

BetaAnalyticsUser object{ type: "user", id, email_address }

A user in the organization, identified by tagged id and email address.

type: "user"

Object type. Always user.

defaultuser
id: string

Tagged user identifier (e.g. user_...)

email_address: string

Email address of the user

BetaAnalyticsUserActor object{ type: "user_actor", deleted, email, 2 more }
type: "user_actor"

Actor type. Always "user_actor".

deleted: boolean

True when the account has been deleted, or when the user is no longer a member of the organization or its associated organizations (for example, their membership was removed or they were deprovisioned via your identity provider). email stays populated for removed users and is null when the account has been deleted. name follows the rules described on that field. The user_id is still populated for reconciliation.

email: string or null

The user's email address, including for users who are no longer members of the organization or its associated organizations. Null when the account has been deleted (check deleted) and for system-minted service accounts, which have no person's mailbox behind them (check name).

name: string or null

The user's full name. Null when the user has not set a name. Returns "Deleted User" when the account itself has been deleted, or when the user is no longer a member of the organization or its associated organizations and the organization has chosen to hide the names of removed users. Otherwise, the name stays populated for removed users. Rows for system-minted service accounts render the service name (for example, "Claude Security" for usage by Anthropic's security-patching service) or null.

user_id: string

Tagged user ID.

BetaConnectorOfficeProductMetrics object{ distinct_session_connector_used_count }

Office Agent activity metrics for a single connector on a given day within one Office product.

distinct_session_connector_used_count: number or null

Number of distinct Office Agent sessions in which the connector was used. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

BetaOfficeProductMetrics object{ connectors_used_count, distinct_connectors_used_count, distinct_session_count, 3 more }

Office Agent activity metrics for a single user on a given day within one Office product.

connectors_used_count: number

Number of MCP connector invocations

distinct_connectors_used_count: number or null

Number of distinct MCP connectors used. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

distinct_session_count: number or null

Number of distinct Office Agent sessions. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

distinct_skills_used_count: number or null

Number of distinct skills used. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

message_count: number

Number of messages sent

skills_used_count: number

Number of skill invocations

BetaSkillOfficeProductMetrics object{ distinct_session_skill_used_count }

Office Agent activity metrics for a single skill on a given day within one Office product.

distinct_session_skill_used_count: number or null

Number of distinct Office Agent sessions in which the skill was used. A skill counts as used only when it is explicitly activated — the model (or the user, via the skill's slash command) invokes it, reading its instructions into context as part of that activation. Skills that are merely installed or listed as available, or whose content reaches the context without an activation (preloaded, hook-injected, or read as a plain file), are not counted. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

BetaToolActionCounts object{ accepted_count, rejected_count }

Accepted/rejected counts for a single Claude Code tool type.

accepted_count: number

Number of tool proposals accepted

rejected_count: number

Number of tool proposals rejected

分析用量

取得隨時間變化的 Token 使用量
GET/v1/organizations/analytics/usage_report

取得某日期範圍內隨時間變化的 token 使用量。

取得每位使用者的 Token 使用量
GET/v1/organizations/analytics/user_usage_report

取得某日期範圍內每位使用者的 token 使用量。

分析成本

取得隨時間變化的成本
GET/v1/organizations/analytics/cost_report

取得某日期範圍內隨時間變化的成本(以美元計)。

取得每位使用者的成本
GET/v1/organizations/analytics/user_cost_report

取得某日期範圍內每位使用者的成本(以美元計)。

分析使用者

列出使用者活動
GET/v1/organizations/analytics/users

取得指定日期的每位使用者活動,採用游標式分頁。

分析技能

取得技能使用量
GET/v1/organizations/analytics/skills

取得指定日期的每項技能用量,採用游標式分頁。

分析連接器

取得連接器使用量
GET/v1/organizations/analytics/connectors

取得指定日期的每個連接器用量,採用游標式分頁。

分析聊天專案

取得聊天專案使用量
GET/v1/organizations/analytics/apps/chat/projects

取得指定日期的每個專案活動,採用游標式分頁。

分析外掛程式

取得外掛程式使用量
GET/v1/organizations/analytics/plugins

取得指定日期的每個外掛程式安裝與呼叫用量,採用分頁。

分析Artifacts

取得 Artifact 活動
GET/v1/organizations/analytics/artifacts

取得指定日期的 artifact 建立活動,依 MIME 類型細分。