Connect OpenAI Admin
OpenAI Admin lets your AI assistant read the administration side of your OpenAI API organization: who is in it, which projects, service accounts and API keys exist, what it uses and spends, and what…
Written By Christopher Scaminaci
Last updated 21 days ago
OpenAI Admin lets your AI assistant read the administration side of your OpenAI API organization: who is in it, which projects, service accounts and API keys exist, what it uses and spends, and what its administrators did. StackJack's tools only read. AI Governance can make changes in this account when you turn that on for the connection. You turn it on under AI Governance, then AI tools, then Vendor changes, with Turn changes on. Making changes in your AI vendor accounts lists what can be changed and the permission each key needs. StackJack connects to the OpenAI organization administration API at one fixed address, so there is no address to enter.
Connecting OpenAI Admin to StackJack gives your AI assistant a family of openai_admin_ MCP tools. MCP (Model Context Protocol)
tools are the standardized commands an AI assistant can call through StackJack. With them, your AI can:
- Review people and access - the users and invites of the organization, its projects and their members, its service accounts, and its groups and roles
- Check the API key inventory - which organization and project keys exist, by hint and id. A key value is never shown
- Read rate limits - the limits set on each project
- Read usage and cost (on Pro plans) - usage and cost reports and spend limits
- Read the audit log (on Pro plans) - who did what in the organization, once audit logging is on
Every tool only reads. Nothing in your OpenAI organization is created, changed or deleted by these tools, so no tool is marked destructive. No tool returns chat or conversation text.
Which key to create
OpenAI has two kinds of key that never stand in for each other.
- An API Platform organization (platform.openai.com) uses an organization Admin key. It starts with
sk-admin, and only an organization owner can create it. Every OpenAI Admin tool reads through this key. - A ChatGPT Enterprise, Edu or Healthcare workspace uses a workspace Admin key (also called the Compliance API key). No OpenAI Admin tool reads through it. AI Governance reads through it, see below.
An organization with both products adds one connection for each, because one connection holds one key.
Create an API Platform organization Admin key
- Sign in to the API Platform as an organization owner.
- Go to Settings, then Organization, then Admin keys.
- Create a key with read access to Usage, Audit Logs and Organization Administration. Add read access to Groups and Roles if you want your AI to read groups and roles.
- Copy the key. OpenAI shows it once.
Turn on audit logging
To read the organization audit log, enable audit logging first.
- In the API Platform, go to Settings, then Organization, then Data controls, then Data retention.
- Enable audit logging.
Audit logging cannot be turned off again once it is on. Only OpenAI Support can turn it off. Turn it on only if you want the organization audit log that StackJack reads. Skip this step if you only use ChatGPT.
Create a ChatGPT workspace Admin key
- In the ChatGPT Admin Console, go to Credentials, then Admin keys, and create a new admin key.
- The workspace owner creates the key for the conversation categories. A workspace owner or admin can create one for the activity categories.
- Copy the key and the workspace id or the organization id (it starts with
org-).
Skip this step if you only use the API Platform.
Connect it in StackJack
- Open Connectors, then OpenAI Admin.
- Choose the key type: API Platform organization Admin key or ChatGPT workspace key.
- Paste the key. For a ChatGPT key, also enter the workspace id or the organization id.
- Click Test connection.
There is nothing else to enter. When you edit the connection later, the key box starts empty: leaving it empty keeps the stored key.
What is worth knowing before you start
What Test connection checks
For an API Platform key, StackJack tries the user list, a usage report and the audit log in turn, because an Admin key carries only the permissions its owner chose and any one of the three may be the one it has. For a ChatGPT key it tries the sign-in log of the workspace or organization you entered.
If the key is valid but carries none of the permissions StackJack reads, the test says so and does not count it against the connection. A key that OpenAI rejects does count against the connection: after three failed checks in a row it is switched off until you fix the key.
AI Governance uses the same connection
AI Governance reads OpenAI through this same connection, so there is no second key to paste. In AI Governance, add a source of the kind you want and choose this connection:
- OpenAI usage and cost, and the OpenAI audit log, need an API Platform organization Admin key
- ChatGPT Enterprise activity logs and ChatGPT Enterprise conversations need a ChatGPT workspace key
The ChatGPT logs reach StackJack only through AI Governance, behind its notice gate and the capture level you choose. They never come
back through an openai_admin_ tool. The ChatGPT logs include the messages of locked chats, and an account PIN does not keep them
out. They are scanned only when your organization turns that capture level on. The member lists of the API Platform connection
also help AI Governance match people by email address.
Included with an AI Governance plan
If your organization has a paid AI Governance plan (Pro, Business or Enterprise) or is in the AI Governance beta, OpenAI Admin is included at
no extra charge. It runs at the Business level: the same openai_admin_ tools, with the Business monthly call quota, and no OpenAI Admin
subscription to buy. On the Connectors page the connector shows Included with AI Governance in place of the upgrade buttons,
and the Billing page offers no upgrade for it.
Your connection and your key stay as they are. The plan decides only the tool level and the call quota. Nothing is written to your OpenAI Admin subscription, so when the AI Governance plan ends the connector returns to whatever your own subscription says, with nothing to clean up.
If you already pay for OpenAI Admin when a paid plan starts, StackJack emails the account owner once. Under AI Governance, then Billing, Admin connectors included lists each connector you still pay for, with Stop paying for it. That button opens the normal removal on the Billing page, which shows what changes before anything is removed, including any change to the discount on your other connectors. StackJack never removes a subscription for you.
Keys expire
An Admin key can expire. A ChatGPT workspace key also stops working if it is revoked or its creator loses the workspace access it needed. Test connection then reports the key as rejected: create a new key and paste it in.
Rate limits
OpenAI publishes no rate limit for the organization administration API, so StackJack paces its calls itself and backs off when OpenAI asks it to.
Paging through results
Lists page with after and limit cursors, and a tool answers one page at a time with the cursor for the next.
Plans and limits
Reads of users, projects, service accounts, keys and rate limits are available on the Free tier. Reads of usage, costs, spend limits and the audit log are Pro. Business reaches the same tools as Pro and differs by monthly call quota.
See the generated OpenAI Admin tool reference for the current inventory, plan assignment, input schemas, and destructive-action labels.
OpenAI Admin tools
openai_admin_ · 42 tools · Free 26 · Pro 16
Organization
Usage and costs
Audit logs
Was this helpful?
More in Connector guides
Connect 3CXConnect AbleSignConnect Acronis Cyber Protect CloudConnect Action1Still need help? Ask the team