Connect your ChatGPT Enterprise workspace to Capsule Security for complete visibility into your organization's GPTs, conversations, and AI usage.
This integration uses OpenAI's Enterprise Compliance API to sync:
- GPTs — Custom assistants built by your team
- Users — Workspace members with roles and status
- Conversations — Chat history and message logs
- Tools — Code Interpreter, Web Browsing, DALL-E, Memory, Custom Actions, and Canvas
- Knowledge Files — Documents uploaded to GPTs
Before you begin, ensure you have:
- An active ChatGPT Enterprise subscription
- Workspace Admin or Organization Owner access
- Approval from OpenAI for Compliance API access on your specific API key (see Step 2)
Note: Compliance permissions must be requested per API key, not per organization. Even if your organization has prior approval, each new API key requires a separate approval request to OpenAI support.
Create an API key in the OpenAI platform that will be used for the integration.
In the top-left corner, ensure you have selected your ChatGPT Enterprise organization (not a personal account)
Click Create new secret key
Configure the key:
- Name: Enter a descriptive name (e.g., "Capsule Security Integration")
- Permissions: Select All (required for Compliance API access)
- Project: Leave as default or select your workspace
Click Create secret key
Important: Copy and save the API key immediately. It will only be shown once.
Note the last 4 characters of your API key — you'll need this for Step 2.
- Store the API key securely (password manager recommended)
- Never share the full key in emails, chat, or code repositories
- The key provides read access to all workspace conversations and GPT configurations
Next step: This API key requires Compliance API permissions to be enabled by OpenAI support (Step 2). Permissions are granted per API key, so you'll need to request approval for this specific key before it can be used with Capsule.
The Compliance API is not enabled by default. You must request access from OpenAI support to enable compliance permissions on each individual API key.
The Compliance API provides read access to conversation logs, GPT configurations, and user data for audit and compliance purposes. OpenAI requires explicit approval to enable this scope.
Important: Compliance permissions are granted per API key, not per organization or tenant. Even if your organization has previously been approved for Compliance API access, each new API key requires separate approval from OpenAI support.
Before contacting OpenAI, collect the following:
| Information | Where to find it |
|---|---|
| Organization ID | platform.openai.com → Settings → Organization |
| Workspace ID | See Step 3 below |
| API Key Name | The name you entered in Step 1 |
| API Key (last 4 digits) | From the key you created in Step 1 |
Email support@openai.com with the following information:
Subject: Request for Enterprise Compliance API Access
Hello OpenAI Support,
I am requesting access to the Enterprise Compliance API for our organization.
Organization ID: org-XXXXXXXXXXXXXXXXXX
Workspace ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
API Key Name: Capsule Security Integration
API Key (last 4 digits): XXXX
Requested scope: chatgpt.enterprise.compliance_export
Requested permission: read
This access is needed for compliance monitoring and audit purposes.
Thank you,
[Your Name]
[Your Organization]- OpenAI typically responds within 1-3 business days
- You will receive a confirmation email when the scope is enabled
- The compliance permissions are applied only to the specific API key you mentioned in your request
- If you create additional API keys in the future, you must submit new requests for each one
The Workspace ID is a UUID that identifies your ChatGPT Enterprise workspace.
Log in to chatgpt.com with your admin account
Open your browser's Developer Tools:
- Chrome/Edge: Press
F12orCtrl+Shift+I(Windows) /Cmd+Option+I(Mac) - Firefox: Press
F12orCtrl+Shift+I - Safari: Enable Developer menu in Preferences, then press
Cmd+Option+I
- Chrome/Edge: Press
Go to the Network tab
In the filter box, type
workspaceorcomplianceRefresh the page or navigate to a different chat
Look for API requests and find the
workspace_idin:- Request URLs (e.g.,
/compliance/workspaces/{workspace_id}/...) - Request headers
- Response bodies
- Request URLs (e.g.,
The Workspace ID is a UUID in the format:
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Log in to chatgpt.com as an admin
Navigate to the Admin section (if available)
Check the URL in your browser's address bar for a workspace identifier
64994ce2-4920-4a30-983c-2acd08d593b6Once you have your API key (with Compliance permissions enabled by OpenAI for that specific key) and Workspace ID, you can set up the integration.
Log in to the Capsule Security portal
Click Integrations in the left sidebar
- Find the ChatGPT Enterprise card and click Set up Integration
The modal displays a 3-step wizard:
- Links to get your API key (you completed this in Step 1 above)
- Instructions to find your Workspace ID (you completed this in Step 3 above)
- Input fields for your credentials
Enter your credentials:
- API Key: Paste the full API key from Step 1 (starts with
sk-proj-...) - Workspace ID: Paste the UUID from Step 3
- API Key: Paste the full API key from Step 1 (starts with
- Click Save
- Initial sync begins automatically
- First sync may take several minutes depending on data volume
- View synced agents in Integrations → Agents
- View conversations in Observability → Filter Activity Type - Session
For help with this integration:
- Email: support@capsule.security
- Include: Your organization ID, integration status, and any error messages
For OpenAI Compliance API issues:
- Email: support@openai.com
- Include: Your Organization ID and API key name