Claude Platform Docs

분석

Models
class BetaAnalyticsArtifactActivity { artifactType; artifactsCreatedCount; distinctUserCount; /* 6 more */ }

Artifact-creation activity for one (artifact_type, is_shared) bucket on a given day.

Artifacts form a small finite cube — the canonical MIME type (8 values incl. other) crossed with shared-vs-private — so the response is the full set of non-empty buckets, not a ranked/paginated list. Claude Code and Cowork artifacts report under text/html and are counted from 2026-08-17 onward; earlier days contain claude.ai chat artifacts only. With group_by[]=product / user_id / rbac_group_id each row is further split by the flat group keys and counts are scoped to that cut.

class BetaAnalyticsChatCoworkUnifiedChatMetrics { connectorsUsedCount; distinctArtifactsCreatedCount; distinctConnectorsUsedCount; /* 9 more */ }

Chat activity recorded while members had Chat and Cowork unified turned on.

class BetaAnalyticsChatCoworkUnifiedSessionsMetrics { actionCount; artifactsCreatedCount; connectorsUsedCount; /* 14 more */ }

Cowork session activity recorded while members had Chat and Cowork unified turned on.

class BetaAnalyticsChatMetrics { connectorsUsedCount; distinctArtifactsCreatedCount; distinctConnectorsUsedCount; /* 9 more */ }

Claude.ai activity metrics for a single user on a given day.

class BetaAnalyticsClaudeCodeMetrics { coreMetrics; toolActions; }

Claude Code activity metrics for a single user on a given day.

enum BetaAnalyticsClaudeTagCategory
DM("dm")
ENGAGED("engaged")
MONITORING("monitoring")
PROACTIVE("proactive")
SCHEDULED("scheduled")
class BetaAnalyticsConnectorActivity { chatMetrics; claudeCodeMetrics; connectorName; /* 14 more */ }

Per-connector activity data for a given day.

class BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics { distinctConversationConnectorUsedCount; }

A connector's use in chat conversations recorded while members had Chat and Cowork unified turned on.

Optional<Long> distinctConversationConnectorUsedCount

Same measure as chat_metrics.distinct_conversation_connector_used_count, for activity recorded while members had Chat and Cowork unified turned on. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

class BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics { distinctSessionConnectorUsedCount; }

A connector's use in Cowork sessions recorded while members had Chat and Cowork unified turned on.

Optional<Long> distinctSessionConnectorUsedCount

Same measure as cowork_metrics.distinct_session_connector_used_count, for activity recorded while members had Chat and Cowork unified turned on. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

class BetaAnalyticsConnectorChatMetrics { distinctConversationConnectorUsedCount; }

Claude.ai activity metrics for a single connector on a given day.

Optional<Long> distinctConversationConnectorUsedCount

Number of distinct conversations 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.

class BetaAnalyticsConnectorClaudeCodeMetrics { distinctSessionConnectorUsedCount; }

Claude Code activity metrics for a single connector on a given day.

Optional<Long> distinctSessionConnectorUsedCount

Number of distinct Claude Code 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.

class BetaAnalyticsConnectorCoworkMetrics { distinctSessionConnectorUsedCount; }

Cowork activity metrics for a single connector on a given day.

Optional<Long> distinctSessionConnectorUsedCount

Number of distinct Cowork 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.

class BetaAnalyticsConnectorOfficeMetrics { excel; outlook; powerpoint; word; }

Office Agent activity metrics for a single connector on a given day, broken out by Office product.

class BetaAnalyticsConnectorOfficeProductMetrics { distinctSessionConnectorUsedCount; }

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

Optional<Long> distinctSessionConnectorUsedCount

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.

enum BetaAnalyticsContextWindow
FROM_0_TO_200K("0-200k")
FROM_200K_TO_1_M("200k-1M")
class BetaAnalyticsCoreCodeMetrics { artifactsCreatedCount; commitCount; distinctSessionCount; /* 2 more */ }

Core Claude Code activity metrics for a single user on a given day.

long artifactsCreatedCount

Number of artifacts created in Claude Code sessions: an artifact counts once, on the day a session first saves it. Counted from 2026-08-17; 0 on earlier days. Exact in date-range mode: a creation belongs to exactly one day, so the per-day counts never overlap and their sum over the window is the exact count of distinct creations in it.

long commitCount

Number of commits made via Claude Code

Optional<Long> distinctSessionCount

Number of distinct Claude Code sessions. On aggregated rows and in date-range mode: summed per-day distinct counts. A session essentially never spans a UTC day, so the sum is in practice the true distinct count.

Lines of code added and removed via Claude Code.

long addedCount

Lines of code added

long removedCount

Lines of code removed

long pullRequestCount

Number of pull requests created via Claude Code

class BetaAnalyticsCostBucketedResult { amount; claudeTagCategory; claudeTagUserId; /* 12 more */ }
class BetaAnalyticsCostReportTimeBucket { endingAt; results; startingAt; }
enum BetaAnalyticsCostType
CODE_EXECUTION("code_execution")
TOKENS("tokens")
WEB_SEARCH("web_search")
class BetaAnalyticsCostUsersItem { actor; amount; claudeTagCategory; /* 15 more */ }
class BetaAnalyticsCoworkMetrics { actionCount; artifactsCreatedCount; connectorsUsedCount; /* 14 more */ }

Cowork activity metrics for a single user on a given day.

class BetaAnalyticsDesignMetrics { distinctProjectsCreatedCount; distinctProjectsUsedCount; distinctSessionCount; messageCount; }

Claude Design activity metrics for a single user on a given day.

long distinctProjectsCreatedCount

Number of distinct Claude Design projects created. Exact in date-range mode: a creation belongs to exactly one day, so the per-day counts never overlap and their sum over the window is the exact count of distinct creations in it.

Optional<Long> distinctProjectsUsedCount

Number of distinct Claude Design projects the user worked in. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

Optional<Long> distinctSessionCount

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

long messageCount

Number of messages sent in Claude Design sessions

enum BetaAnalyticsInferenceGeoFilter
GLOBAL("global")
NOT_AVAILABLE("not_available")
US("us")
class BetaAnalyticsLinesOfCode { addedCount; removedCount; }

Lines of code added and removed via Claude Code.

long addedCount

Lines of code added

long removedCount

Lines of code removed

class BetaAnalyticsOfficeMetrics { excel; outlook; powerpoint; word; }

Office Agent activity metrics for a single user on a given day, broken out by Office product.

class BetaAnalyticsOfficeProductMetrics { connectorsUsedCount; distinctConnectorsUsedCount; distinctSessionCount; /* 3 more */ }

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

long connectorsUsedCount

Number of MCP connector invocations

Optional<Long> distinctConnectorsUsedCount

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.

Optional<Long> distinctSessionCount

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.

Optional<Long> distinctSkillsUsedCount

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.

long messageCount

Number of messages sent

long skillsUsedCount

Number of skill invocations

class BetaAnalyticsPluginActivity { claudeCodeMetrics; coworkMetrics; distinctUserCount; /* 9 more */ }

Per-plugin install + invocation activity for a given day.

With group_by[]=user_id / rbac_group_id / product (cowork, claude_code and chat_cowork_unified only on this endpoint) each row is one (plugin, user), (plugin, group), or (plugin, product) cut: the flat user_id / rbac_group_id / product keys carry the cut and the counts are scoped to it.

class BetaAnalyticsPluginClaudeCodeMetrics { distinctSessionPluginUsedCount; }

Claude Code activity metrics for a single plugin on a given day.

Optional<Long> distinctSessionPluginUsedCount

Number of distinct Claude Code sessions in which the plugin was invoked. Null on aggregated rows where a distinct count cannot be computed.

class BetaAnalyticsPluginCoworkMetrics { distinctSessionPluginUsedCount; }

Cowork activity metrics for a single plugin on a given day.

Optional<Long> distinctSessionPluginUsedCount

Number of distinct Cowork sessions in which the plugin was invoked. Null on aggregated rows where a distinct count cannot be computed.

enum BetaAnalyticsProductFilter

Publicly documented product surfaces. claude-tag is Claude Tag, the Claude product in Slack. chat_cowork_unified is Chat and Cowork unified, Cowork's features inside claude.ai chat: chat and Cowork usage by a member who has it turned on is reported under this value instead of chat or cowork. It is accepted as a filter only on deployments that offer Chat and Cowork unified.

CHAT("chat")
CHAT_COWORK_UNIFIED("chat_cowork_unified")
CLAUDE_TAG("claude-tag")
CLAUDE_CODE("claude_code")
CLAUDE_DESIGN("claude_design")
CLAUDE_IN_CHROME("claude_in_chrome")
COWORK("cowork")
OFFICE_AGENT("office_agent")
class BetaAnalyticsProjectActivity { distinctUserCount; messageCount; projectId; /* 8 more */ }

Per-project activity data for a given day.

class BetaAnalyticsScienceMetrics { delegationCount; distinctSessionCount; messageCount; /* 2 more */ }

Claude Science activity metrics for a single user on a given day.

long delegationCount

Number of delegations (handoffs to a specialized agent) in Claude Science sessions

Optional<Long> distinctSessionCount

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

long messageCount

Number of messages sent in Claude Science sessions

long remoteComputeJobCount

Number of remote compute jobs launched from Claude Science sessions

long skillsUsedCount

Total number of skill invocations in Claude Science sessions

class BetaAnalyticsServerToolUse { webSearchRequests; }
long webSearchRequests

The number of web search requests made.

class BetaAnalyticsSingleDayActivitySummary { assignedSeatCount; coworkDailyActiveUserCount; coworkMonthlyActiveUserCount; /* 29 more */ }

Per-day entry in the /summaries response.

class BetaAnalyticsSkillActivity { chatMetrics; claudeCodeMetrics; coworkMetrics; /* 15 more */ }

Per-skill activity data for a given day.

class BetaAnalyticsSkillChatCoworkUnifiedChatMetrics { distinctConversationSkillUsedCount; }

A skill's use in chat conversations recorded while members had Chat and Cowork unified turned on.

Optional<Long> distinctConversationSkillUsedCount

Same measure as chat_metrics.distinct_conversation_skill_used_count, for activity recorded while members had Chat and Cowork unified turned on. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

class BetaAnalyticsSkillChatCoworkUnifiedSessionsMetrics { distinctSessionSkillUsedCount; }

A skill's use in Cowork sessions recorded while members had Chat and Cowork unified turned on.

Optional<Long> distinctSessionSkillUsedCount

Same measure as cowork_metrics.distinct_session_skill_used_count, for activity recorded while members had Chat and Cowork unified turned on. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.

class BetaAnalyticsSkillChatMetrics { distinctConversationSkillUsedCount; }

Claude.ai activity metrics for a single skill on a given day.

Optional<Long> distinctConversationSkillUsedCount

Number of distinct conversations 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.

class BetaAnalyticsSkillClaudeCodeMetrics { distinctSessionSkillUsedCount; }

Claude Code activity metrics for a single skill on a given day.

Optional<Long> distinctSessionSkillUsedCount

Number of distinct Claude Code 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.

class BetaAnalyticsSkillCoworkMetrics { distinctSessionSkillUsedCount; }

Cowork activity metrics for a single skill on a given day.

Optional<Long> distinctSessionSkillUsedCount

Number of distinct Cowork 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.

class BetaAnalyticsSkillOfficeMetrics { excel; outlook; powerpoint; word; }

Office Agent activity metrics for a single skill on a given day, broken out by Office product.

class BetaAnalyticsSkillOfficeProductMetrics { distinctSessionSkillUsedCount; }

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

Optional<Long> distinctSessionSkillUsedCount

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.

enum BetaAnalyticsTokenType
CACHE_CREATION_EPHEMERAL_1H_INPUT_TOKENS("cache_creation.ephemeral_1h_input_tokens")
CACHE_CREATION_EPHEMERAL_5M_INPUT_TOKENS("cache_creation.ephemeral_5m_input_tokens")
CACHE_READ_INPUT_TOKENS("cache_read_input_tokens")
OUTPUT_TOKENS("output_tokens")
UNCACHED_INPUT_TOKENS("uncached_input_tokens")
class BetaAnalyticsToolActionCounts { acceptedCount; rejectedCount; }

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

long acceptedCount

Number of tool proposals accepted

long rejectedCount

Number of tool proposals rejected

class BetaAnalyticsToolActions { editTool; multiEditTool; notebookEditTool; writeTool; }

Per-tool accepted/rejected counts for Claude Code file modification tools.

class BetaAnalyticsUsageBucketedResult { cacheCreation; cacheReadInputTokens; claudeTagCategory; /* 12 more */ }
class BetaAnalyticsUsageReportTimeBucket { endingAt; results; startingAt; }
class BetaAnalyticsUsageUsersItem { actor; cacheCreation; cacheReadInputTokens; /* 16 more */ }
class BetaAnalyticsUser { type = "user"; id; emailAddress; }

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

JsonValue type = "user"

Object type. Always user.

String id

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

String emailAddress

Email address of the user

class BetaAnalyticsUserActivity { chatMetrics; claudeCodeMetrics; coworkMetrics; /* 10 more */ }

Per-user activity data for a given day.

class BetaAnalyticsUserActor { type = "user_actor"; deleted; emailAddress; /* 2 more */ }
JsonValue type = "user_actor"

Actor type. Always "user_actor".

boolean deleted

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_address 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.

Optional<String> emailAddress

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).

Optional<String> name

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.

String userId

Tagged user ID.

분석요약

활동 요약 조회
SummaryListPage beta().organization().analytics().summaries().list(params, requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/summaries

지정한 날짜 범위에 대한 조직 전체의 활동 요약을 조회합니다.

분석사용자

사용자 활동 목록 조회
UserListPage beta().organization().analytics().users().list(params = UserListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/users

커서 기반 페이지네이션으로 특정 날짜의 사용자별 활동을 가져옵니다.

분석앱채팅프로젝트

채팅 프로젝트 사용량 조회
ProjectListPage beta().organization().analytics().apps().chat().projects().list(params = ProjectListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/apps/chat/projects

특정 날짜의 프로젝트별 활동을 커서 기반 페이지네이션으로 조회합니다.

분석커넥터

커넥터 사용량 조회
ConnectorListPage beta().organization().analytics().connectors().list(params = ConnectorListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/connectors

커서 기반 페이지네이션으로 특정 날짜의 커넥터별 사용량을 가져옵니다.

분석플러그인

플러그인 사용량 조회
PluginListPage beta().organization().analytics().plugins().list(params = PluginListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/plugins

페이지네이션으로 특정 날짜의 플러그인별 설치 + 호출 사용량을 가져옵니다.

분석스킬

스킬 사용량 조회
SkillListPage beta().organization().analytics().skills().list(params = SkillListParams.none(), requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/skills

커서 기반 페이지네이션으로 특정 날짜의 스킬별 사용량을 가져옵니다.

분석Artifacts

Artifact 활동 조회
ArtifactListPage beta().organization().analytics().artifacts().list(params, requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/artifacts

특정 날짜의 아티팩트 생성 활동을 MIME 유형별로 세분화하여 가져옵니다.

시간 경과에 따른 토큰 사용량 조회
UsageReportListPage beta().organization().analytics().usageReport().list(params, requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/usage_report

날짜 범위에 걸친 시간 경과에 따른 토큰 사용량을 조회합니다.

사용자별 토큰 사용량 조회
UserUsageReportListPage beta().organization().analytics().userUsageReport().list(params, requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/user_usage_report

날짜 범위에 걸친 사용자별 토큰 사용량을 조회합니다.

시간 경과에 따른 비용 조회
CostReportListPage beta().organization().analytics().costReport().list(params, requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/cost_report

날짜 범위에 걸친 시간 경과에 따른 USD 비용을 조회합니다.

사용자별 비용 조회
UserCostReportListPage beta().organization().analytics().userCostReport().list(params, requestOptions = RequestOptions.none())
GET/v1/organizations/analytics/user_cost_report

날짜 범위에 걸친 사용자별 USD 비용을 조회합니다.