15## Analytics Dashboard15## Analytics Dashboard
16 16
17<div class="max-w-1xl mx-auto">17<div class="max-w-1xl mx-auto">
18 <img src="https://developers.openai.com/images/codex/enterprise/analytics.png"18 <img src="https://developers.openai.com/images/codex/enterprise/analytics-dashboard.png"
19 alt="Codex analytics dashboard"19 alt="Codex analytics dashboard"
20 class="block w-full mx-auto rounded-lg"20 class="block w-full mx-auto rounded-lg !border-0"
21 />21 />
22</div>22</div>
23 23
24### Dashboards24### Dashboard views
25 25
26The [analytics dashboard](https://chatgpt.com/codex/settings/analytics) allows ChatGPT workspace administrators to track feature adoption.26The [analytics dashboard](https://chatgpt.com/codex/cloud/settings/analytics#usage) allows ChatGPT workspace administrators and analytics viewers to track Codex adoption, usage, and Code Review feedback. Usage data can lag by up to 12 hours.
27 27
28Codex provides the following dashboards:28Codex provides date-range controls for daily and weekly views. Key charts include:
29 29
30- Daily users by product (CLI, IDE, cloud, Code Review)30- Active users by product surface, including CLI, IDE extension, cloud, desktop, and Code Review
31- Daily code review users31- Workspace and personal usage breakdowns, including credit and token usage by product surface
32- Daily code reviews32- Product activity for threads and turns by client
33- Code reviews by priority level33- User ranking table, with filters for client and sort options such as credits, threads, turns, text tokens, and current streak
34- Daily code reviews by feedback sentiment34- Code Review activity, including PRs reviewed, issues by priority, comments, replies, reactions, and feedback sentiment
35- Daily cloud tasks35- Skill invocations and agent identity usage when your workspace has those features
36- Daily cloud users
37- Daily VS Code extension users
38- Daily CLI users
39 36
40### Data export37### Data export
41 38
42Administrators can also export Codex analytics data in CSV or JSON format. Codex provides the following export options:39Administrators can also export Codex analytics data in CSV or JSON format. Codex provides the following export options:
43 40
44- Code review users and reviews (Daily unique users and total reviews completed in Code Review)41- Workspace usage, including daily active users, threads, turns, and credits by surface
45- Code review findings and feedback (Daily counts of comments, reactions, replies, and priority-level findings)42- Usage per user, including daily threads, turns, and credits across surfaces, with optional email addresses when allowed
46- cloud users and tasks (daily unique cloud users and tasks completed)43- Code Review details, including daily comments, reactions, replies, and priority-level findings
47- CLI and VS Code users (Daily unique users for the Codex CLI and VS Code extension)
48- Sessions and messages per user (Daily session starts and user message counts for each Codex user across surfaces)
49 44
50## Analytics API45## Analytics API
51 46
52Use the [Analytics API](https://chatgpt.com/codex/settings/apireference) when you want to automate reporting, build internal dashboards, or join Codex metrics with your existing engineering data.47Use the [Analytics API](https://chatgpt.com/codex/cloud/settings/apireference) when you want to automate reporting, build internal dashboards, or join Codex metrics with your existing engineering data.
53 48
54### What it measures49### What it measures
55 50
56The Analytics API provides daily, time-series metrics for a workspace, with optional per-user breakdowns and per-client usage.51The enterprise Analytics API returns daily or weekly UTC buckets for a workspace. It supports workspace-level and per-user usage, per-client breakdowns, Code Review throughput, Code Review comment priority, and user engagement with Code Review comments.
57 52
58### Endpoints53### Endpoints
59 54
60#### Daily usage and adoption55The base URL is `https://api.chatgpt.com/v1/analytics/codex`. All endpoints return paginated `page` objects with `has_more` and `next_page`.
61 56
62- Daily totals for threads, turns, and credits57Use `start_time` for the inclusive Unix timestamp at the beginning of the reporting window, `end_time` for the exclusive Unix timestamp at the end of the reporting window, `group_by` for `day` or `week` buckets, `limit` for page size, and `page` to continue from a previous response. Requests can look back up to 90 days.
63- Breakdown by client surface58
64- Optional per-user reporting for adoption and power-user analysis59#### Usage
60
61`GET /workspaces/{workspace_id}/usage`
62
63- Returns totals for threads, turns, credits, and per-client usage in daily or weekly buckets.
64- Omit `group` to return per-user rows.
65- Set `group=workspace` to return workspace-wide rows.
66- Includes text input, cached input, and output token fields.
65 67
66#### Code review activity68#### Code review activity
67 69
68- Pull request reviews completed by Codex70`GET /workspaces/{workspace_id}/code_reviews`
69- Total comments generated by Codex71
70- Severity breakdown of comments72- Returns pull request reviews completed by Codex.
73- Returns total comments generated by Codex.
74- Breaks comments down by P0, P1, and P2 priority.
71 75
72#### User engagement with code review76#### User engagement with code review
73 77
74- Replies to Codex comments78`GET /workspaces/{workspace_id}/code_review_responses`
75- Reactions, including upvotes and downvotes79
76- Engagement breakdowns for how teams respond to Codex feedback80- Returns replies and reactions to Codex comments.
81- Breaks reactions down into positive, negative, and other reactions.
82- Counts comments that received reactions, replies, or either form of engagement.
77 83
78### How it works84### How it works
79 85
80Analytics is daily and time-windowed. Results are time-ordered and returned in pages with cursor-based pagination. You can query by workspace and optionally group by user or aggregate at the workspace level.86Analytics uses time windows and supports day or week grouping. Results are time-ordered and returned in pages with cursor-based pagination. Use an API key scoped to `codex.enterprise.analytics.read`.
81 87
82### Common use cases88### Common use cases
83 89
