Skip to main content
Codex’s analytics API requires a ChatGPT Enterprise or Codex plan. You must be on one of these plans to connect this integration.

​
Benefits of connecting Codex to Windmill

Connecting Codex to Windmill brings AI coding agent usage directly into stats, performance reviews, and 1:1s — giving managers and engineers visibility into how Codex is being adopted across the team.
  • Tracks how engineers are using Codex for autonomous coding tasks across different client surfaces
  • Surfaces adoption patterns including thread volume, turn depth, and token consumption without self-reporting
  • Helps managers understand AI tool usage and coach their teams on effective workflows
  • Provides concrete data for performance conversations about productivity and tool adoption
  • Syncs automatically — no manual tracking or surveys required
Windmill turns Codex’s enterprise analytics into actionable stats that flow into your existing performance workflow.

​
How to connect Codex

1

Get your API key from OpenAI

Go to the Codex API reference and follow the Authentication instructions to obtain an API key with the proper scopes.
2

Get your Workspace ID

Go to the ChatGPT Admin console and copy your Workspace ID. This identifies which ChatGPT workspace Windmill should pull analytics from.
3

Open the Codex integration in Windmill

In Windmill, navigate to Settings > Integrations, find Codex, and click Connect.
4

Enter your credentials and connect

Paste your API key and Workspace ID into the input fields and click Connect. Windmill will validate the credentials and begin syncing analytics within the hour.
Codex is an account-level integration — an admin connects it once and it covers your entire ChatGPT workspace. Individual users don’t need to connect separately.

​
Connected data

When connected, Windmill syncs per-user analytics from Codex’s Enterprise Analytics API. This is usage data — Windmill does not access any code, prompts, conversations, or file content. All stats are broken down by client surface (e.g., Codex in ChatGPT, Codex in an IDE, or other clients) so you can see where your team is using Codex. All stats are tracked per employee, per day, per client surface.

​
Visibility and access

Codex stats in Windmill follow the manager hierarchy visibility model:
  • Employees can see their own Codex stats
  • Managers can see Codex stats for their direct reports and anyone in their reporting chain
  • Admins can see Codex stats for everyone in the organization
  • Peers cannot see each other’s Codex stats
This means Codex analytics are treated like other sensitive performance data in Windmill — visible to the people who need it for coaching and evaluation, but not exposed broadly.

​
Permissions

Windmill requests read-only access to Codex’s Enterprise Analytics API.

​
User matching

Windmill matches Codex users to employees using their email address. If a Codex user’s email matches an employee’s email in Windmill, their stats are automatically attributed to that employee. If you notice stats that aren’t being attributed correctly, check that the email addresses in your ChatGPT workspace match the employee emails in Windmill.

​
FAQs

Yes. Codex’s analytics API is only available on the ChatGPT Enterprise or Codex plan. The integration won’t work with ChatGPT’s free, Plus, or Team plans.
No. Windmill only reads usage analytics from Codex’s API — thread counts, turn counts, credit consumption, and token usage. Windmill never accesses code, files, prompts, or conversation content.
Windmill syncs with Codex once per hour. New usage data will appear within an hour of the activity happening in Codex.
Yes. Every employee can see their own Codex stats in Windmill.
No. Codex stats follow the manager hierarchy — only your manager (and their managers) can see your stats. Peers cannot see each other’s Codex usage data.
No. Codex is an account-level integration. An admin connects it once using an API key and Workspace ID, and it covers your entire ChatGPT workspace.
Codex stats are broken down by the client surface where the activity happened — for example, Codex in ChatGPT versus Codex in an IDE integration. This helps you understand where your team is using Codex most.
Their historical Codex stats remain for context, but Windmill stops attributing new activity once they are an Archived user.
This usually happens when your email in your ChatGPT workspace doesn’t match your email in Windmill. Make sure the email addresses match, or ask an admin to check the user mapping.