OpenAI Compliance API Connector
OpenAI Compliance API Connector
Before You Begin
The OpenAI Compliance connector pulls conversation logs, audit events, and stateful workspace data (users, canvases, custom GPTs, projects) from your ChatGPT Enterprise workspace via OpenAI's Compliance API. This data powers governance, retention, and reporting workflows in Section. Setting it up requires an organization Owner to mint a dedicated API key and request compliance scopes from OpenAI Support.
What you'll need:
- An OpenAI Enterprise or Edu plan with Data Export enabled
- Owner role on the OpenAI organization that administers the workspace
- A support request to OpenAI to activate Compliance scopes on the API key (typically takes a few business days)
Note: Once Compliance scopes are granted, OpenAI automatically revokes all standard API scopes (chat completions, etc.) on that key — it becomes a dedicated, read-only compliance key. Do not reuse an existing production key. OpenAI retains compliance log files for only 30 days, so any extended outage will result in unrecoverable data gaps.
Create a Project API Key
Generate a dedicated API key in your OpenAI organization that will later be upgraded to a compliance-scoped key.
- Sign in to the OpenAI API Keys Portal as an organization Owner.
- Use the organization switcher in the top-left to select the Organization that administers your ChatGPT Enterprise workspace. Do not use your personal organization.
- Click Create new secret key.
- Configure the key with these settings:
- Project:
Default Project - Permissions:
All Permissions
- Project:
- Give the key a clear, identifiable name (for example,
Section HQ Compliance). - Click Create secret key and copy the value immediately — OpenAI will not show it again.
- Record the following details — you will need them in the next step:
- Key Name
- Created By Name (the Owner who created the key)
- Last 4 digits of the key
Important: Store the full key in a secure password manager. You will paste it into Section at the end of Step 3, after OpenAI activates compliance scopes.
Value to copy: The secret key shown once immediately after creation. Store it securely — you'll paste it into the API Key field after Step 3 is complete.
Request Compliance Scopes via Support
OpenAI must manually verify and activate Compliance API scopes on the key you just created. Until this is done, the key cannot read compliance data.
- Compose an email to [email protected] requesting Compliance API scope activation.
- Include the key details you recorded in the previous section:
- The last 4 digits of the API key
- The Key Name
- The Created By Name
- The requested scopes:
read
- Submit the request and wait for confirmation from OpenAI Support that the scopes have been granted — this typically takes a few business days.
Warning: Once Compliance scopes are activated, OpenAI will automatically revoke all standard API scopes on this key. It becomes a dedicated compliance key and cannot be used for chat completions or other product APIs.
Retrieve Workspace ID
Locate the UUID that identifies your ChatGPT Enterprise workspace, then connect Section using both credentials.
- Sign in to the ChatGPT Admin Panel as an organization Owner.
- Locate the Workspace ID — a UUID in the format
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. - Copy the full UUID.
- Return to Section, paste the API Key (from Step 2) and the Workspace ID into their respective fields, then click Save.
Note: The Workspace ID is different from your OpenAI Organization ID (shown on
platform.openai.com). Make sure you're using the Workspace ID fromchatgpt.com/admin— a mismatch will result in403 Forbiddenerrors.
Value to copy: The Workspace UUID from the ChatGPT admin panel. Paste into the Workspace ID field.
