feat(api): add GCP external storage support (openai#3943)

## Summary

Add typed GCP provider support for organization external storage. Expose
retry headers on video creation errors when available.

## Changes

- Export the new GcpExternalStorageProvider response model with bucket,
region, audience, workload identity, and provider type fields.
- Allow GCP providers in external storage creation parameters,
configurations, and audit log registration events.
- Add optional headers to VideoCreateError as a string mapping for
Retry-After and Retry-After-Ms values.

Co-authored-by: jbeckwith-oai <269036200+jbeckwith-oai@users.noreply.github.com>

Author: jbeckwith-oai

.castiron.stats.yml

@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: c8c6bf6c-8bff-434a-b978-585a27465fa8
-openapi_spec_hash: 6a2e60e178aa24527fca9f135ac4496d
-openapi_transformed_spec_hash: effb859cf813a2e353712f1ecfc81c08
-config_hash: 18f602826c88bad76c6fdf08ab67247a
-codegen_sha: 14a34feb242913af4804472ab683ca8782bf39d7
-codegen_hash: e4941790e2be3ec721829183f7ae6daf6b05fedcdb00b37971d988ac4b671e4c
-public_codegen_sha: 19f5aa746f2bc5d9f5affdae7a05d8c92e0c4ab1
+generation_id: 85ad4660-a311-4438-9c8d-cdca0ec0f76a
+openapi_spec_hash: 6ffdf0b6c2bafb456b14fda3f7231658
+openapi_transformed_spec_hash: d6d1e240c0615a9349169c2f2d04c388
+config_hash: 84cdcc959ee7140cc9a65e9b642c097b
+codegen_sha: 2284ccaf093c393669ee50253d011bb2a12c9f69
+codegen_hash: 70eb364ca64eb34fc66bed39b8f693f90c75dcd0c307489373cf360dcf3a2269
+public_codegen_sha: 75504785271618f32f21c7948959b7a390faf4f5

api.md

@@ -1510,6 +1510,7 @@ from openai.types.admin.organization import (
     AzureExternalStorageProvider,
     ExternalStorageConfiguration,
     ExternalStorageDeleted,
+    GcpExternalStorageProvider,
 )
 ```
 

api_reference/openapi.transformed.yml

@@ -70944,12 +70944,42 @@ components:
       - account_name
       - container
       - region
+    GcpExternalStorageProviderResponse:
+      properties:
+        type:
+          type: string
+          enum:
+          - gcp
+          default: gcp
+          x-stainless-const: true
+        bucket:
+          type: string
+        workload_identity_project_number:
+          type: string
+        workload_identity_pool_id:
+          type: string
+        workload_identity_provider_id:
+          type: string
+        region:
+          type: string
+        audience:
+          type: string
+      type: object
+      required:
+      - type
+      - bucket
+      - workload_identity_project_number
+      - workload_identity_pool_id
+      - workload_identity_provider_id
+      - region
+      - audience
     provider:
       discriminator:
         propertyName: type
       anyOf:
       - $ref: '#/components/schemas/AwsExternalStorageProviderResponse'
       - $ref: '#/components/schemas/AzureExternalStorageProviderResponse'
+      - $ref: '#/components/schemas/GcpExternalStorageProviderResponse'
     PublicProjectResidency:
       type: string
       enum:
@@ -71571,6 +71601,7 @@ components:
           anyOf:
           - $ref: '#/components/schemas/AwsExternalStorageProviderResponse'
           - $ref: '#/components/schemas/AzureExternalStorageProviderResponse'
+          - $ref: '#/components/schemas/GcpExternalStorageProviderResponse'
         geography:
           type: string
         status:
@@ -71659,6 +71690,29 @@ components:
       - resource_group
       - account_name
       - container
+    GcpExternalStorageProviderParams:
+      properties:
+        type:
+          type: string
+          enum:
+          - gcp
+          default: gcp
+          x-stainless-const: true
+        bucket:
+          type: string
+        workload_identity_project_number:
+          type: string
+        workload_identity_pool_id:
+          type: string
+        workload_identity_provider_id:
+          type: string
+      type: object
+      required:
+      - type
+      - bucket
+      - workload_identity_project_number
+      - workload_identity_pool_id
+      - workload_identity_provider_id
     CreateExternalStorageBody:
       properties:
         project_id:
@@ -71670,6 +71724,7 @@ components:
           anyOf:
           - $ref: '#/components/schemas/AwsExternalStorageProviderParams'
           - $ref: '#/components/schemas/AzureExternalStorageProviderParams'
+          - $ref: '#/components/schemas/GcpExternalStorageProviderParams'
       type: object
       required:
       - project_id
@@ -72066,6 +72121,13 @@ components:
         message:
           type: string
           description: A human-readable description of the error that was returned.
+        headers:
+          additionalProperties:
+            type: string
+            description: The retry header value.
+          type: object
+          description: The Retry-After and Retry-After-Ms headers returned with the original error, if any.
+          x-oaiTypeLabel: map
         misalignment:
           $ref: '#/components/schemas/MisalignmentErrorDetailsResource'
       type: object
@@ -73947,42 +74009,7 @@ components:
       - ''
       - ''
       description: The public lifecycle status of an execution environment.
-    HostedEnvironmentFileResourceFileId:
-      type: object
-      properties:
-        type:
-          type: string
-          enum:
-          - file_id
-          default: file_id
-          x-stainless-const: true
-          description: The type of the object. Always `file_id`.
-        id:
-          type: string
-          minLength: 0
-          description: The session-scoped ID of the file in the execution environment.
-        file_id:
-          type: string
-          minLength: 0
-          description: The ID of the uploaded file.
-        path:
-          type: string
-          minLength: 0
-          description: The file's absolute path inside the environment.
-        size_bytes:
-          type: integer
-          format: int64
-          minimum: 0
-          description: The decoded file size in bytes.
-      required:
-      - type
-      - id
-      - file_id
-      - path
-      - size_bytes
-      additionalProperties: false
-      description: A file copied from the OpenAI Files API.
-    HostedEnvironmentFileResourceInline:
+    HostedPluginResourceInline:
       type: object
       properties:
         type:
@@ -73992,39 +74019,30 @@ components:
           default: inline
           x-stainless-const: true
           description: The type of the object. Always `inline`.
-        id:
+        name:
           type: string
           minLength: 0
-          description: The session-scoped ID of the file in the execution environment.
-        path:
+          description: The installed plugin name.
+        description:
           type: string
           minLength: 0
-          description: The file's absolute path inside the environment.
-        size_bytes:
-          type: integer
-          format: int64
-          minimum: 0
-          description: The decoded file size in bytes.
+          description: The installed plugin description.
       required:
       - type
-      - id
-      - path
-      - size_bytes
+      - name
+      - description
       additionalProperties: false
-      description: A file supplied inline when the session was created.
-    HostedEnvironmentFileResource:
-      description: Metadata for a file materialized in an OpenAI-hosted execution environment.
+      description: A plugin installed from an inline ZIP archive.
+    HostedPluginResource:
+      description: A plugin installed in an OpenAI-hosted environment.
       discriminator:
         propertyName: type
         mapping:
-          file_id: '#/components/schemas/HostedEnvironmentFileResourceFileId'
-          inline: '#/components/schemas/HostedEnvironmentFileResourceInline'
+          inline: '#/components/schemas/HostedPluginResourceInline'
       x-oai-discriminator-values:
-      - file_id
       - inline
       anyOf:
-      - $ref: '#/components/schemas/HostedEnvironmentFileResourceFileId'
-      - $ref: '#/components/schemas/HostedEnvironmentFileResourceInline'
+      - $ref: '#/components/schemas/HostedPluginResourceInline'
     HostedSkillResourceSkillReference:
       type: object
       properties:
@@ -74096,7 +74114,42 @@ components:
       anyOf:
       - $ref: '#/components/schemas/HostedSkillResourceSkillReference'
       - $ref: '#/components/schemas/HostedSkillResourceInline'
-    HostedPluginResourceInline:
+    HostedEnvironmentFileResourceFileId:
+      type: object
+      properties:
+        type:
+          type: string
+          enum:
+          - file_id
+          default: file_id
+          x-stainless-const: true
+          description: The type of the object. Always `file_id`.
+        id:
+          type: string
+          minLength: 0
+          description: The session-scoped ID of the file in the execution environment.
+        file_id:
+          type: string
+          minLength: 0
+          description: The ID of the uploaded file.
+        path:
+          type: string
+          minLength: 0
+          description: The file's absolute path inside the environment.
+        size_bytes:
+          type: integer
+          format: int64
+          minimum: 0
+          description: The decoded file size in bytes.
+      required:
+      - type
+      - id
+      - file_id
+      - path
+      - size_bytes
+      additionalProperties: false
+      description: A file copied from the OpenAI Files API.
+    HostedEnvironmentFileResourceInline:
       type: object
       properties:
         type:
@@ -74106,30 +74159,39 @@ components:
           default: inline
           x-stainless-const: true
           description: The type of the object. Always `inline`.
-        name:
+        id:
           type: string
           minLength: 0
-          description: The installed plugin name.
-        description:
+          description: The session-scoped ID of the file in the execution environment.
+        path:
           type: string
           minLength: 0
-          description: The installed plugin description.
+          description: The file's absolute path inside the environment.
+        size_bytes:
+          type: integer
+          format: int64
+          minimum: 0
+          description: The decoded file size in bytes.
       required:
       - type
-      - name
-      - description
+      - id
+      - path
+      - size_bytes
       additionalProperties: false
-      description: A plugin installed from an inline ZIP archive.
-    HostedPluginResource:
-      description: A plugin installed in an OpenAI-hosted environment.
+      description: A file supplied inline when the session was created.
+    HostedEnvironmentFileResource:
+      description: Metadata for a file materialized in an OpenAI-hosted execution environment.
       discriminator:
         propertyName: type
         mapping:
-          inline: '#/components/schemas/HostedPluginResourceInline'
+          file_id: '#/components/schemas/HostedEnvironmentFileResourceFileId'
+          inline: '#/components/schemas/HostedEnvironmentFileResourceInline'
       x-oai-discriminator-values:
+      - file_id
       - inline
       anyOf:
-      - $ref: '#/components/schemas/HostedPluginResourceInline'
+      - $ref: '#/components/schemas/HostedEnvironmentFileResourceFileId'
+      - $ref: '#/components/schemas/HostedEnvironmentFileResourceInline'
     PublicEnvironmentResource:
       type: object
       properties:
@@ -74150,27 +74212,27 @@ components:
         status:
           $ref: '#/components/schemas/EnvironmentStatusResource'
           description: The current environment connection status.
-        files:
+        plugins:
           type: array
           items:
-            $ref: '#/components/schemas/HostedEnvironmentFileResource'
+            $ref: '#/components/schemas/HostedPluginResource'
           minItems: 0
           maxItems: 2000
-          description: Files installed in the environment, without their contents.
+          description: Plugins installed in the environment, without their archive contents.
         skills:
           type: array
           items:
             $ref: '#/components/schemas/HostedSkillResource'
           minItems: 0
           maxItems: 2000
           description: Skills installed in the environment, without their archive contents.
-        plugins:
+        files:
           type: array
           items:
-            $ref: '#/components/schemas/HostedPluginResource'
+            $ref: '#/components/schemas/HostedEnvironmentFileResource'
           minItems: 0
           maxItems: 2000
-          description: Plugins installed in the environment, without their archive contents.
+          description: Files installed in the environment, without their contents.
       required:
       - id
       - object

src/openai/types/admin/organization/__init__.py

@@ -68,6 +68,7 @@
 from .aws_external_storage_provider import AwsExternalStorageProvider as AwsExternalStorageProvider
 from .certificate_activate_response import CertificateActivateResponse as CertificateActivateResponse
 from .certificate_deactivate_params import CertificateDeactivateParams as CertificateDeactivateParams
+from .gcp_external_storage_provider import GcpExternalStorageProvider as GcpExternalStorageProvider
 from .usage_audio_speeches_response import UsageAudioSpeechesResponse as UsageAudioSpeechesResponse
 from .usage_web_search_calls_params import UsageWebSearchCallsParams as UsageWebSearchCallsParams
 from .external_storage_configuration import ExternalStorageConfiguration as ExternalStorageConfiguration

src/openai/types/admin/organization/audit_log_list_response.py

@@ -8,6 +8,7 @@
 from ...._utils import PropertyInfo
 from ...._models import BaseModel
 from .aws_external_storage_provider import AwsExternalStorageProvider
+from .gcp_external_storage_provider import GcpExternalStorageProvider
 from .azure_external_storage_provider import AzureExternalStorageProvider
 
 __all__ = [
@@ -313,7 +314,8 @@ class ExternalKeyRemoved(BaseModel):
 
 
 ExternalStorageRegisteredDataProvider: TypeAlias = Annotated[
-    Union[AwsExternalStorageProvider, AzureExternalStorageProvider], PropertyInfo(discriminator="type")
+    Union[AwsExternalStorageProvider, AzureExternalStorageProvider, GcpExternalStorageProvider],
+    PropertyInfo(discriminator="type"),
 ]
 
 

src/openai/types/admin/organization/external_storage_configuration.py

@@ -6,12 +6,14 @@
 from ...._utils import PropertyInfo
 from ...._models import BaseModel
 from .aws_external_storage_provider import AwsExternalStorageProvider
+from .gcp_external_storage_provider import GcpExternalStorageProvider
 from .azure_external_storage_provider import AzureExternalStorageProvider
 
 __all__ = ["ExternalStorageConfiguration", "Provider"]
 
 Provider: TypeAlias = Annotated[
-    Union[AwsExternalStorageProvider, AzureExternalStorageProvider], PropertyInfo(discriminator="type")
+    Union[AwsExternalStorageProvider, AzureExternalStorageProvider, GcpExternalStorageProvider],
+    PropertyInfo(discriminator="type"),
 ]