Analytics changedapi/organization/analytics
# Analytics ## Domain types ### Analytics Artifact Activity ### Analytics Artifact Group By ### Analytics Chat Cowork Unified Chat Metrics ### Analytics Chat Cowork Unified Metrics ### Analytics Chat Cowork Unified Sessions Metrics ### Analytics Chat Metrics ### Analytics Claude Code Metrics ### Analytics Connector Activity ### Analytics Connector Chat Cowork Unified Chat Metrics ### Analytics Connector Chat Cowork Unified Metrics ### Analytics Connector Chat Cowork Unified Sessions Metrics ### Analytics Connector Chat Metrics ### Analytics Connector Claude Code Metrics ### Analytics Connector Cowork Metrics ### Analytics Connector Group By ### Analytics Connector Office Metrics ### Analytics Connector Office Product Metrics ### Analytics Core Code Metrics ### Analytics Cowork Metrics ### Analytics Design Metrics ### Analytics Lines Of Code ### Analytics Office Metrics ### Analytics Office Product Metrics ### Analytics Order ### Analytics Plugin Activity ### Analytics Plugin Chat Cowork Unified Metrics ### Analytics Plugin Claude Code Metrics ### Analytics Plugin Cowork Metrics ### Analytics Plugin Group By ### Analytics Project Activity ### Analytics Project Group By ### Analytics Science Metrics ### Analytics Single Day Activity Summary ### Analytics Skill Activity ### Analytics Skill Chat Cowork Unified Chat Metrics ### Analytics Skill Chat Cowork Unified Metrics ### Analytics Skill Chat Cowork Unified Sessions Metrics ### Analytics Skill Chat Metrics ### Analytics Skill Claude Code Metrics ### Analytics Skill Cowork Metrics ### Analytics Skill Group By ### Analytics Skill Office Metrics ### Analytics Skill Office Product Metrics ### Analytics Tool Action Counts ### Analytics Tool Actions ### Analytics User ### Analytics User Activity ### Analytics User Group By ## Analytics › Summaries ### Get Activity Summaries #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Analytics › Users ### List User Activity #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Analytics › Apps › Chat › Projects ### Get Chat Project Usage #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Analytics › Connectors ### Get Connector Usage #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Analytics › Plugins ### Get Plugin Usage #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Analytics › Skills ### Get Skill Usage #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ## Analytics › Artifacts ### Get Artifact Activity #### Query parameters #### Headers #### Returns #### Example ##### Response (200)
The whole hunk
4081 lines, new pageA whole new page. There's nothing to diff it against, so here is what it says.
---
title: Analytics
url: https://platform.claude.com/docs/en/api/organization/analytics
---
# Analytics
## Domain types
### Analytics Artifact Activity
- `AnalyticsArtifactActivity object`
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.
- `artifact_type: string`
Canonical artifact MIME type (e.g. `text/markdown`, `application/vnd.ant.react`, `image/svg+xml`), or `other`. Claude Code and Cowork artifacts report as `text/html`.
- `artifacts_created_count: number`
Number of artifacts created in this bucket on the requested day
- `distinct_user_count: number`
Number of distinct users who created artifacts in this bucket on the requested day
- `is_shared: boolean`
Whether the artifacts in this bucket have ever been shared (a Claude Code / Cowork artifact is shared once anyone beyond its creator may open it: named members, the whole organization, or anyone with the link).
- `published_artifacts_created_count: number`
Number of those artifacts that have been published (for Claude Code / Cowork artifacts: open to anyone with the link); never exceeds `artifacts_created_count`
- `product: optional string or null`
Product that produced this row's activity: one of `chat`, `claude_code`, `cowork`, `office_agent`, or `chat_cowork_unified` (Chat and Cowork unified). These are the canonical Cost & Usage product names; an `office_agent` row's per-surface breakdown is in its `office_metrics`. On `/plugins` only `cowork`, `claude_code` and `chat_cowork_unified` occur (the only surfaces with plugin attribution); on `/artifacts` only `chat`, `claude_code`, `cowork` and `chat_cowork_unified` occur (the surfaces that create artifacts); `/apps/chat/projects` does not support the product dimension (a `product` entry in `group_by[]` or `filter[]` there is rejected). Present only when the request grouped by `product`.
- `rbac_group_id: optional string or null`
Tagged RBAC group identifier (`rbac_group_...`), matching the spend-limits API spelling. Present only when the request grouped by `rbac_group_id`.
- `rbac_group_name: optional string or null`
Resolved RBAC group display name, alongside `rbac_group_id` when name resolution is available. Null if the group has been deleted or its name could not be resolved; `rbac_group_id` remains the stable key.
- `user_id: optional string or null`
Tagged user identifier (e.g. `user_...`). Present only when the request grouped by `user_id`.
### Analytics Artifact Group By
- `AnalyticsArtifactGroupBy = "product" or "rbac_group_id" or "user_id"`
A dimension to group artifact activity by.
- `"product"`
- `"rbac_group_id"`
- `"user_id"`
### Analytics Chat Cowork Unified Chat Metrics
- `AnalyticsChatCoworkUnifiedChatMetrics object`
Chat activity recorded while members had Chat and Cowork unified turned
on.
- `connectors_used_count: number`
Same measure as `chat_metrics.connectors_used_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `distinct_artifacts_created_count: number`
Same measure as `chat_metrics.distinct_artifacts_created_count`, for activity recorded while members had Chat and Cowork unified turned on. 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.
- `distinct_connectors_used_count: number or null`
Same measure as `chat_metrics.distinct_connectors_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.
- `distinct_conversation_count: number or null`
Same measure as `chat_metrics.distinct_conversation_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.
- `distinct_files_uploaded_count: number or null`
Same measure as `chat_metrics.distinct_files_uploaded_count`, for activity recorded while members had Chat and Cowork unified turned on. It counts uploaded files as well as files Claude created and images returned by Claude's tools, such as screenshots. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
- `distinct_projects_created_count: number`
Same measure as `chat_metrics.distinct_projects_created_count`, for activity recorded while members had Chat and Cowork unified turned on. 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.
- `distinct_projects_used_count: number or null`
Same measure as `chat_metrics.distinct_projects_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.
- `distinct_shared_artifacts_viewed_count: number or null`
Always null: shared-artifact views are not currently measured.
- `distinct_skills_used_count: number or null`
Same measure as `chat_metrics.distinct_skills_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.
- `message_count: number`
Same measure as `chat_metrics.message_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `shared_conversations_viewed_count: number`
Same measure as `chat_metrics.shared_conversations_viewed_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `thinking_message_count: number`
Same measure as `chat_metrics.thinking_message_count`, for activity recorded while members had Chat and Cowork unified turned on.
### Analytics Chat Cowork Unified Metrics
- `AnalyticsChatCoworkUnifiedMetrics object`
Activity in Chat and Cowork unified for one user on one day: `chat` holds
chat activity and `sessions` holds Cowork session activity.
- `chat: AnalyticsChatCoworkUnifiedChatMetrics`
Chat activity recorded while members had Chat and Cowork unified turned
on.
- `connectors_used_count: number`
Same measure as `chat_metrics.connectors_used_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `distinct_artifacts_created_count: number`
Same measure as `chat_metrics.distinct_artifacts_created_count`, for activity recorded while members had Chat and Cowork unified turned on. 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.
- `distinct_connectors_used_count: number or null`
Same measure as `chat_metrics.distinct_connectors_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.
- `distinct_conversation_count: number or null`
Same measure as `chat_metrics.distinct_conversation_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.
- `distinct_files_uploaded_count: number or null`
Same measure as `chat_metrics.distinct_files_uploaded_count`, for activity recorded while members had Chat and Cowork unified turned on. It counts uploaded files as well as files Claude created and images returned by Claude's tools, such as screenshots. Approximate (HLL, typical error <2%) in date-range mode. Null on aggregated rows where a distinct count cannot be computed.
- `distinct_projects_created_count: number`
Same measure as `chat_metrics.distinct_projects_created_count`, for activity recorded while members had Chat and Cowork unified turned on. 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.
- `distinct_projects_used_count: number or null`
Same measure as `chat_metrics.distinct_projects_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.
- `distinct_shared_artifacts_viewed_count: number or null`
Always null: shared-artifact views are not currently measured.
- `distinct_skills_used_count: number or null`
Same measure as `chat_metrics.distinct_skills_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.
- `message_count: number`
Same measure as `chat_metrics.message_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `shared_conversations_viewed_count: number`
Same measure as `chat_metrics.shared_conversations_viewed_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `thinking_message_count: number`
Same measure as `chat_metrics.thinking_message_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `sessions: AnalyticsChatCoworkUnifiedSessionsMetrics`
Cowork session activity recorded while members had Chat and Cowork
unified turned on.
- `action_count: number`
Same measure as `cowork_metrics.action_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `artifacts_created_count: number`
Same measure as `cowork_metrics.artifacts_created_count`, for activity recorded while members had Chat and Cowork unified turned on. 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.
- `connectors_used_count: number`
Same measure as `cowork_metrics.connectors_used_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `dispatch_turn_count: number`
Same measure as `cowork_metrics.dispatch_turn_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `distinct_connectors_used_count: number or null`
Same measure as `cowork_metrics.distinct_connectors_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.
- `distinct_plugins_used_count: number or null`
Same measure as `cowork_metrics.distinct_plugins_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.
- `distinct_session_count: number or null`
Same measure as `cowork_metrics.distinct_session_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.
- `distinct_skills_used_count: number or null`
Same measure as `cowork_metrics.distinct_skills_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.
- `edit_tool_count: number or null`
Same measure as `cowork_metrics.edit_tool_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `file_edit_count: number or null`
Same measure as `cowork_metrics.file_edit_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `message_count: number`
Same measure as `cowork_metrics.message_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `multi_edit_tool_count: number or null`
Same measure as `cowork_metrics.multi_edit_tool_count`, for activity recorded while members had Chat and Cowork unified turned on. Claude no longer has a multi-edit tool, so expect 0 when not null; each edit is now a separate Edit tool call, counted in `edit_tool_count` and `file_edit_count`.
- `notebook_edit_tool_count: number or null`
Same measure as `cowork_metrics.notebook_edit_tool_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `plugins_used_count: number or null`
Same measure as `cowork_metrics.plugins_used_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `sessions_with_file_edits_count: number or null`
Same measure as `cowork_metrics.sessions_with_file_edits_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.
- `skills_used_count: number`
Same measure as `cowork_metrics.skills_used_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `write_tool_count: number or null`
Same measure as `cowork_metrics.write_tool_count`, for activity recorded while members had Chat and Cowork unified turned on.
### Analytics Chat Cowork Unified Sessions Metrics
- `AnalyticsChatCoworkUnifiedSessionsMetrics object`
Cowork session activity recorded while members had Chat and Cowork
unified turned on.
- `action_count: number`
Same measure as `cowork_metrics.action_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `artifacts_created_count: number`
Same measure as `cowork_metrics.artifacts_created_count`, for activity recorded while members had Chat and Cowork unified turned on. 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.
- `connectors_used_count: number`
Same measure as `cowork_metrics.connectors_used_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `dispatch_turn_count: number`
Same measure as `cowork_metrics.dispatch_turn_count`, for activity recorded while members had Chat and Cowork unified turned on.
- `distinct_connectors_used_count: number or null`
Same measure as `cowork_metrics.distinct_connectors_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.
- `distinct_plugins_used_count: number or null`
Same measure as `cowork_metrics.distinct_plugins_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.
- `distinct_session_count: number or null`
Same measure as `cowork_metrics.distinct_session_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.
- `distinct_skills_used_count: number or null`
Same measure as `cowork_metrics.distinct_skills_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.
- `edit_tool_count: number or null`
Cut at 300 lines. The page has the rest.
No line in this hunk matches that.