fix(api): extract shared schemas to prevent Go webhook union breaking changes

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 48
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-d73a37dc3426586109bd153f02c6a605036b6a7396bba5173d013468c5291ce6.yml
-openapi_spec_hash: c193c6e557ff477481ec8d5ac8a0c96e
-config_hash: 32b155378f65c234d3abeb18519fb3cd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-7c4c23556be689ded6bcafd05e1645b82239521c9c841c0f7e76336e2eefcffa.yml
+openapi_spec_hash: eca5b039a0066c6536296248c3a80854
+config_hash: e3c2679d25f6235381dfb11962fbf3d9

src/imagekitio/types/beta/v2/file_upload_response.py

@@ -19,10 +19,9 @@ class AITag(BaseModel):
     """Name of the tag."""
 
     source: Optional[str] = None
-    """Array of `AITags` associated with the image.
+    """Source of the tag.
 
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    Possible values are `google-auto-tagging` and `aws-auto-tagging`.
     """
 
 
@@ -122,7 +121,11 @@ class FileUploadResponse(BaseModel):
     """Object containing details of a successful upload."""
 
     ai_tags: Optional[List[AITag]] = FieldInfo(alias="AITags", default=None)
-    """An array of tags assigned to the uploaded file by auto tagging."""
+    """Array of `AITags` associated with the image.
+
+    If no `AITags` are set, it will be null. These tags can be added using the
+    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video)."""

src/imagekitio/types/file.py

@@ -80,7 +80,7 @@ class SelectedFieldsSchema(BaseModel):
 
 
 class VersionInfo(BaseModel):
-    """An object with details of the file version."""
+    """An object containing the file or file version's `id` (versionId) and `name`."""
 
     id: Optional[str] = None
     """Unique identifier of the file version."""
@@ -93,7 +93,11 @@ class File(BaseModel):
     """Object containing details of a file or file version."""
 
     ai_tags: Optional[List[AITag]] = FieldInfo(alias="AITags", default=None)
-    """An array of tags assigned to the file by auto tagging."""
+    """Array of `AITags` associated with the image.
+
+    If no `AITags` are set, it will be null. These tags can be added using the
+    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video/audio)."""
@@ -111,7 +115,13 @@ class File(BaseModel):
     """An string with custom coordinates of the file."""
 
     custom_metadata: Optional[Dict[str, object]] = FieldInfo(alias="customMetadata", default=None)
-    """An object with custom metadata for the file."""
+    """A key-value data associated with the asset.
+
+    Use `responseField` in API request to get `customMetadata` in the upload API
+    response. Before setting any custom metadata on an asset, you have to create the
+    field using custom metadata fields API. Send `customMetadata` in
+    `responseFields` in API request to get the value of this field.
+    """
 
     description: Optional[str] = None
     """Optional text to describe the contents of the file.
@@ -125,7 +135,9 @@ class File(BaseModel):
     embedded_metadata: Optional[Dict[str, object]] = FieldInfo(alias="embeddedMetadata", default=None)
     """Consolidated embedded metadata associated with the file.
 
-    It includes exif, iptc, and xmp data.
+    It includes exif, iptc, and xmp data. Send `embeddedMetadata` in
+    `responseFields` in API request to get embeddedMetadata in the upload API
+    response.
     """
 
     file_id: Optional[str] = FieldInfo(alias="fileId", default=None)
@@ -201,7 +213,7 @@ class File(BaseModel):
     """URL of the file."""
 
     version_info: Optional[VersionInfo] = FieldInfo(alias="versionInfo", default=None)
-    """An object with details of the file version."""
+    """An object containing the file or file version's `id` (versionId) and `name`."""
 
     video_codec: Optional[str] = FieldInfo(alias="videoCodec", default=None)
     """The video codec used in the video (only for video)."""

src/imagekitio/types/file_upload_response.py

@@ -19,10 +19,9 @@ class AITag(BaseModel):
     """Name of the tag."""
 
     source: Optional[str] = None
-    """Array of `AITags` associated with the image.
+    """Source of the tag.
 
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    Possible values are `google-auto-tagging` and `aws-auto-tagging`.
     """
 
 
@@ -122,7 +121,11 @@ class FileUploadResponse(BaseModel):
     """Object containing details of a successful upload."""
 
     ai_tags: Optional[List[AITag]] = FieldInfo(alias="AITags", default=None)
-    """An array of tags assigned to the uploaded file by auto tagging."""
+    """Array of `AITags` associated with the image.
+
+    If no `AITags` are set, it will be null. These tags can be added using the
+    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video)."""

src/imagekitio/types/upload_pre_transform_success_event.py

@@ -29,10 +29,9 @@ class UploadPreTransformSuccessEventDataAITag(BaseModel):
     """Name of the tag."""
 
     source: Optional[str] = None
-    """Array of `AITags` associated with the image.
+    """Source of the tag.
 
-    If no `AITags` are set, it will be null. These tags can be added using the
-    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    Possible values are `google-auto-tagging` and `aws-auto-tagging`.
     """
 
 
@@ -132,7 +131,11 @@ class UploadPreTransformSuccessEventData(BaseModel):
     """Object containing details of a successful upload."""
 
     ai_tags: Optional[List[UploadPreTransformSuccessEventDataAITag]] = FieldInfo(alias="AITags", default=None)
-    """An array of tags assigned to the uploaded file by auto tagging."""
+    """Array of `AITags` associated with the image.
+
+    If no `AITags` are set, it will be null. These tags can be added using the
+    `google-auto-tagging` or `aws-auto-tagging` extensions.
+    """
 
     audio_codec: Optional[str] = FieldInfo(alias="audioCodec", default=None)
     """The audio codec used in the video (only for video)."""