Codex
Antenna automatically tracks AI coding metrics from OpenAI Codex by pulling data from the Codex Enterprise Analytics API. Get insight into adoption, activity, and the impact of Codex on your team’s productivity.
The Codex Analytics API is currently available only for ChatGPT Enterprise customers. ChatGPT Plus users are not supported.
Prerequisites
- A ChatGPT Enterprise subscription with Codex enabled
- Admin or owner access to the OpenAI API Platform Portal
- Your workspace ID from the ChatGPT Admin console
Setup
Create a Codex Analytics API key
- Sign in to the OpenAI API Platform Portal as an owner or admin, and select the correct organization.
- Go to the API keys page.
- Create a new secret key and give it a descriptive name such as
Codex Analytics API. - Select the appropriate project for your organization. If you only have one project, the default project is fine.
- Set the key permissions to Read only.
- Copy the key and store it securely — you can only view it once.
- Email support@openai.com to have the key scoped to
codex.enterprise.analytics.readonly. Wait for OpenAI to confirm your API key has Codex Analytics API access before proceeding.
The API key must be explicitly scoped to codex.enterprise.analytics.read by OpenAI support. The integration will not work until this scope is applied.
Find your workspace ID
Open the ChatGPT Admin console and copy the Workspace ID from the workspace settings page.
Connect in Antenna
- In Antenna, go to Settings > Connected Apps.
- Find Codex and click Connect.
- Paste your API key and workspace ID.
- Click Connect.
Data collected
We pull from the Codex Enterprise Analytics API:
| Purpose | Endpoint |
|---|---|
| Daily usage metrics | GET /v1/analytics/codex/workspaces/{workspace_id}/usage |
This API returns daily Codex adoption and code review metrics for a workspace, including:
- Threads and turns — total conversation threads and individual turns
- Credits — credit consumption per user or workspace
- Per-client usage — breakdowns by client application
- Token usage — text input, cached input, and output token counts
- Code Review metrics — throughput, comment priority, and user engagement with Code Review comments
For full API documentation, see the Codex Enterprise Analytics API reference .