Analysen
Models
interface BetaAnalyticsArtifactActivity { artifact_type; artifacts_created_count; distinct_user_count; /* 6 more */ }Artifact-creation activity for one (artifact_type, is_shared) bucket
on a given day.
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.
interface BetaAnalyticsChatCoworkUnifiedChatMetrics { connectors_used_count; distinct_artifacts_created_count; distinct_connectors_used_count; /* 9 more */ }Chat activity recorded while members had Chat and Cowork unified turned
on.
Chat activity recorded while members had Chat and Cowork unified turned on.
interface BetaAnalyticsChatCoworkUnifiedSessionsMetrics { action_count; artifacts_created_count; connectors_used_count; /* 14 more */ }Cowork session activity recorded while members had Chat and Cowork
unified turned on.
Cowork session activity recorded while members had Chat and Cowork unified turned on.
interface BetaAnalyticsChatMetrics { connectors_used_count; distinct_artifacts_created_count; distinct_connectors_used_count; /* 9 more */ }Claude.ai activity metrics for a single user on a given day.
Claude.ai activity metrics for a single user on a given day.
interface BetaAnalyticsClaudeCodeMetrics { core_metrics; tool_actions }Claude Code activity metrics for a single user on a given day.
Claude Code activity metrics for a single user on a given day.
type BetaAnalyticsClaudeTagCategory = "dm" | "engaged" | "monitoring" | 2 more
interface BetaAnalyticsConnectorActivity { chat_metrics; claude_code_metrics; connector_name; /* 14 more */ }Per-connector activity data for a given day.
Per-connector activity data for a given day.
interface BetaAnalyticsConnectorChatCoworkUnifiedChatMetrics { distinct_conversation_connector_used_count }A connector's use in chat conversations recorded while members had
Chat and Cowork unified turned on.
A connector's use in chat conversations recorded while members had Chat and Cowork unified turned on.
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.
interface BetaAnalyticsConnectorChatCoworkUnifiedSessionsMetrics { distinct_session_connector_used_count }A connector's use in Cowork sessions recorded while members had
Chat and Cowork unified turned on.
A connector's use in Cowork sessions recorded while members had Chat and Cowork unified turned on.
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.
interface BetaAnalyticsConnectorChatMetrics { distinct_conversation_connector_used_count }Claude.ai activity metrics for a single connector on a given day.
Claude.ai activity metrics for a single connector on a given day.
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.
interface BetaAnalyticsConnectorClaudeCodeMetrics { distinct_session_connector_used_count }Claude Code activity metrics for a single connector on a given day.
Claude Code activity metrics for a single connector on a given day.
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.
interface BetaAnalyticsConnectorCoworkMetrics { distinct_session_connector_used_count }Cowork activity metrics for a single connector on a given day.
Cowork activity metrics for a single connector on a given day.
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.
interface BetaAnalyticsConnectorOfficeMetrics { excel; outlook; powerpoint; word }Office Agent activity metrics for a single connector on a given day, broken out by Office product.
Office Agent activity metrics for a single connector on a given day, broken out by Office product.
interface BetaAnalyticsConnectorOfficeProductMetrics { distinct_session_connector_used_count }Office Agent activity metrics for a single connector on a given day within one Office product.
Office Agent activity metrics for a single connector on a given day within one Office product.
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.
type BetaAnalyticsContextWindow = "0-200k" | "200k-1M"
interface BetaAnalyticsCoreCodeMetrics { artifacts_created_count; commit_count; distinct_session_count; /* 2 more */ }Core Claude Code activity metrics for a single user on a given day.
Core Claude Code activity metrics for a single user on a given day.
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.
Number of commits made via Claude Code
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: BetaAnalyticsLinesOfCode { added_count; removed_count }Lines of code added and removed via Claude Code.
Lines of code added and removed via Claude Code.
Lines of code added
Lines of code removed
Number of pull requests created via Claude Code
interface BetaAnalyticsCostBucketedResult { amount; claude_tag_category; claude_tag_user_id; /* 12 more */ }
interface BetaAnalyticsCostReportTimeBucket { ending_at; results; starting_at }
type BetaAnalyticsCostType = "code_execution" | "tokens" | "web_search"
interface BetaAnalyticsCostUsersItem { actor; amount; claude_tag_category; /* 15 more */ }
interface BetaAnalyticsCoworkMetrics { action_count; artifacts_created_count; connectors_used_count; /* 14 more */ }Cowork activity metrics for a single user on a given day.
Cowork activity metrics for a single user on a given day.
interface BetaAnalyticsDesignMetrics { distinct_projects_created_count; distinct_projects_used_count; distinct_session_count; message_count }Claude Design activity metrics for a single user on a given day.
Claude Design activity metrics for a single user on a given day.
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.
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.
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.
Number of messages sent in Claude Design sessions
type BetaAnalyticsInferenceGeoFilter = "global" | "not_available" | "us"
interface BetaAnalyticsLinesOfCode { added_count; removed_count }Lines of code added and removed via Claude Code.
Lines of code added and removed via Claude Code.
Lines of code added
Lines of code removed
interface BetaAnalyticsOfficeMetrics { excel; outlook; powerpoint; word }Office Agent activity metrics for a single user on a given day, broken out by Office product.
Office Agent activity metrics for a single user on a given day, broken out by Office product.
interface BetaAnalyticsOfficeProductMetrics { 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.
Office Agent activity metrics for a single user on a given day within one Office product.
Number of MCP connector invocations
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.
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.
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.
Number of messages sent
Number of skill invocations
interface BetaAnalyticsPluginActivity { claude_code_metrics; cowork_metrics; distinct_user_count; /* 9 more */ }Per-plugin install + invocation activity for a given day.
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.
interface BetaAnalyticsPluginClaudeCodeMetrics { distinct_session_plugin_used_count }Claude Code activity metrics for a single plugin on a given day.
Claude Code activity metrics for a single plugin on a given day.
Number of distinct Claude Code sessions in which the plugin was invoked. Null on aggregated rows where a distinct count cannot be computed.
interface BetaAnalyticsPluginCoworkMetrics { distinct_session_plugin_used_count }Cowork activity metrics for a single plugin on a given day.
Cowork activity metrics for a single plugin on a given day.
Number of distinct Cowork sessions in which the plugin was invoked. Null on aggregated rows where a distinct count cannot be computed.
type BetaAnalyticsProductFilter = "chat" | "chat_cowork_unified" | "claude-tag" | 5 morePublicly 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.
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.
interface BetaAnalyticsProjectActivity { distinct_user_count; message_count; project_id; /* 8 more */ }Per-project activity data for a given day.
Per-project activity data for a given day.
interface BetaAnalyticsScienceMetrics { delegation_count; distinct_session_count; message_count; /* 2 more */ }Claude Science activity metrics for a single user on a given day.
Claude Science activity metrics for a single user on a given day.
Number of delegations (handoffs to a specialized agent) in Claude Science sessions
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.
Number of messages sent in Claude Science sessions
Number of remote compute jobs launched from Claude Science sessions
Total number of skill invocations in Claude Science sessions
interface BetaAnalyticsServerToolUse { web_search_requests }
The number of web search requests made.
interface BetaAnalyticsSingleDayActivitySummary { assigned_seat_count; cowork_daily_active_user_count; cowork_monthly_active_user_count; /* 29 more */ }Per-day entry in the /summaries response.
Per-day entry in the /summaries response.
interface BetaAnalyticsSkillActivity { chat_metrics; claude_code_metrics; cowork_metrics; /* 15 more */ }Per-skill activity data for a given day.
Per-skill activity data for a given day.
interface BetaAnalyticsSkillChatCoworkUnifiedChatMetrics { distinct_conversation_skill_used_count }A skill's use in chat conversations recorded while members had
Chat and Cowork unified turned on.
A skill's use in chat conversations recorded while members had Chat and Cowork unified turned on.
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.
interface BetaAnalyticsSkillChatCoworkUnifiedSessionsMetrics { distinct_session_skill_used_count }A skill's use in Cowork sessions recorded while members had Chat
and Cowork unified turned on.
A skill's use in Cowork sessions recorded while members had Chat and Cowork unified turned on.
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.
interface BetaAnalyticsSkillChatMetrics { distinct_conversation_skill_used_count }Claude.ai activity metrics for a single skill on a given day.
Claude.ai activity metrics for a single skill on a given day.
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.
interface BetaAnalyticsSkillClaudeCodeMetrics { distinct_session_skill_used_count }Claude Code activity metrics for a single skill on a given day.
Claude Code activity metrics for a single skill on a given day.
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.
interface BetaAnalyticsSkillCoworkMetrics { distinct_session_skill_used_count }Cowork activity metrics for a single skill on a given day.
Cowork activity metrics for a single skill on a given day.
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.
interface BetaAnalyticsSkillOfficeMetrics { excel; outlook; powerpoint; word }Office Agent activity metrics for a single skill on a given day, broken out by Office product.
Office Agent activity metrics for a single skill on a given day, broken out by Office product.
interface BetaAnalyticsSkillOfficeProductMetrics { distinct_session_skill_used_count }Office Agent activity metrics for a single skill on a given day within one Office product.
Office Agent activity metrics for a single skill on a given day within one Office product.
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.
type BetaAnalyticsTokenType = "cache_creation.ephemeral_1h_input_tokens" | "cache_creation.ephemeral_5m_input_tokens" | "cache_read_input_tokens" | 2 more
interface BetaAnalyticsToolActionCounts { accepted_count; rejected_count }Accepted/rejected counts for a single Claude Code tool type.
Accepted/rejected counts for a single Claude Code tool type.
Number of tool proposals accepted
Number of tool proposals rejected
interface BetaAnalyticsToolActions { edit_tool; multi_edit_tool; notebook_edit_tool; write_tool }Per-tool accepted/rejected counts for Claude Code file modification tools.
Per-tool accepted/rejected counts for Claude Code file modification tools.
interface BetaAnalyticsUsageBucketedResult { cache_creation; cache_read_input_tokens; claude_tag_category; /* 12 more */ }
interface BetaAnalyticsUsageReportTimeBucket { ending_at; results; starting_at }
interface BetaAnalyticsUsageUsersItem { actor; cache_creation; cache_read_input_tokens; /* 16 more */ }
interface BetaAnalyticsUser { type: "user"; id; email_address }A user in the organization, identified by tagged id and email address.
A user in the organization, identified by tagged id and email address.
type: "user"Object type. Always user.
Object type. Always user.
Tagged user identifier (e.g. user_...)
Email address of the user
interface BetaAnalyticsUserActivity { chat_metrics; claude_code_metrics; cowork_metrics; /* 10 more */ }Per-user activity data for a given day.
Per-user activity data for a given day.
interface BetaAnalyticsUserActor { type: "user_actor"; deleted; email_address; /* 2 more */ }
Actor type. Always "user_actor".
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.
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).
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.
Tagged user ID.
AnalysenZusammenfassungen
Aktivitätszusammenfassungen abrufen
client.beta.organization.analytics.summaries.list(query, options?): PageCursor<BetaAnalyticsSingleDayActivitySummary>Ruft organisationsweite Aktivitätszusammenfassungen für einen Datumsbereich ab.
AnalysenBenutzer
Benutzeraktivität auflisten
client.beta.organization.analytics.users.list(query?, options?): PageCursor<BetaAnalyticsUserActivity>Ruft die Aktivität pro Benutzer für einen bestimmten Tag ab, mit Cursor-basierter Paginierung.
AnalysenAppsChatProjekte
Chat-Projektnutzung abrufen
client.beta.organization.analytics.apps.chat.projects.list(query?, options?): PageCursor<BetaAnalyticsProjectActivity>Ruft die Aktivität pro Projekt für einen bestimmten Tag ab, mit cursorbasierter Paginierung.
AnalysenKonnektoren
Konnektor-Nutzung abrufen
client.beta.organization.analytics.connectors.list(query?, options?): PageCursor<BetaAnalyticsConnectorActivity>Ruft die Nutzung pro Konnektor für einen bestimmten Tag ab, mit Cursor-basierter Paginierung.
AnalysenPlugins
Plugin-Nutzung abrufen
client.beta.organization.analytics.plugins.list(query?, options?): PageCursor<BetaAnalyticsPluginActivity>Ruft die Installations- und Aufrufnutzung pro Plugin für einen bestimmten Tag ab, mit Paginierung.
AnalysenSkills
Skill-Nutzung abrufen
client.beta.organization.analytics.skills.list(query?, options?): PageCursor<BetaAnalyticsSkillActivity>Ruft die Nutzung pro Skill für einen bestimmten Tag ab, mit Cursor-basierter Paginierung.
AnalysenArtifacts
Artifact-Aktivität abrufen
client.beta.organization.analytics.artifacts.list(query, options?): PageCursor<BetaAnalyticsArtifactActivity>Ruft die Aktivität zur Artifact-Erstellung für einen bestimmten Tag ab, aufgeschlüsselt nach MIME-Typ.
AnalysenNutzungsbericht
Token-Nutzung im Zeitverlauf abrufen
client.beta.organization.analytics.usageReport.list(query, options?): PageCursor<BetaAnalyticsUsageReportTimeBucket>Ruft die Token-Nutzung im Zeitverlauf über einen Datumsbereich ab.
AnalysenNutzungsbericht pro Benutzer
Token-Nutzung pro Benutzer abrufen
client.beta.organization.analytics.userUsageReport.list(query, options?): PageCursor<BetaAnalyticsUsageUsersItem>Ruft die Token-Nutzung pro Benutzer über einen Datumsbereich ab.
AnalysenKostenbericht
Kosten im Zeitverlauf abrufen
client.beta.organization.analytics.costReport.list(query, options?): PageCursor<BetaAnalyticsCostReportTimeBucket>Ruft die Kosten in USD im Zeitverlauf über einen Datumsbereich ab.
AnalysenKostenbericht pro Benutzer
Kosten pro Benutzer abrufen
client.beta.organization.analytics.userCostReport.list(query, options?): PageCursor<BetaAnalyticsCostUsersItem>Ruft die Kosten pro Benutzer in USD über einen Datumsbereich ab.