feat(api): Add saved extensions API and enhance transformation options

Added complete CRUD API endpoints for saved extensions, allowing users to save complex extension configurations and reuse them across multiple assets

Fixed metadata endpoint path: /v1/files/metadata → /v1/metadata

Added and improved transformation options e.g. color replace, layer modes, distort effect, gradient background etc.

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 43
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-9d184cb502ab32a85db2889c796cdfebe812f2a55a604df79c85dd4b5e7e2add.yml
-openapi_spec_hash: a9aa620376fce66532c84f9364209b0b
-config_hash: 71cab8223bb5610c6c7ca6e9c4cc1f89
+configured_endpoints: 48
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/imagekit-inc%2Fimagekit-7a3257eb171467b637c8d72877f201c2e6038c71ed447a9453230b7309ce7416.yml
+openapi_spec_hash: 87b000a9989ad5c9526f28d91b8a1749
+config_hash: aeb6eb949d73382270bbd8bbf2e4cf2a

aliases.go

@@ -1,13 +1,15 @@
 # Shared Params Types
 
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#BaseOverlayParam">BaseOverlayParam</a>
+- <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#ExtensionConfigUnionParam">ExtensionConfigUnionParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#ExtensionsParam">ExtensionsParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#GetImageAttributesOptionsParam">GetImageAttributesOptionsParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#ImageOverlayParam">ImageOverlayParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#OverlayUnionParam">OverlayUnionParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#OverlayPositionParam">OverlayPositionParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#OverlayTimingParam">OverlayTimingParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#ResponsiveImageAttributesParam">ResponsiveImageAttributesParam</a>
+- <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SavedExtensionParam">SavedExtensionParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SolidColorOverlayParam">SolidColorOverlayParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SolidColorOverlayTransformationParam">SolidColorOverlayTransformationParam</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SrcOptionsParam">SrcOptionsParam</a>
@@ -20,6 +22,11 @@
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#TransformationPosition">TransformationPosition</a>
 - <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#VideoOverlayParam">VideoOverlayParam</a>
 
+# Shared Response Types
+
+- <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#ExtensionConfigUnion">ExtensionConfigUnion</a>
+- <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SavedExtension">SavedExtension</a>
+
 # Dummy
 
 Methods:
@@ -101,7 +108,17 @@ Methods:
 Methods:
 
 - <code title="get /v1/files/{fileId}/metadata">client.Files.Metadata.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#FileMetadataService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, fileID <a href="https://pkg.go.dev/builtin#string">string</a>) (<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#Metadata">Metadata</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
-- <code title="get /v1/files/metadata">client.Files.Metadata.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#FileMetadataService.GetFromURL">GetFromURL</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, query <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#FileMetadataGetFromURLParams">FileMetadataGetFromURLParams</a>) (<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#Metadata">Metadata</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="get /v1/metadata">client.Files.Metadata.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#FileMetadataService.GetFromURL">GetFromURL</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, query <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#FileMetadataGetFromURLParams">FileMetadataGetFromURLParams</a>) (<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#Metadata">Metadata</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+
+# SavedExtensions
+
+Methods:
+
+- <code title="post /v1/saved-extensions">client.SavedExtensions.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionService.New">New</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionNewParams">SavedExtensionNewParams</a>) (<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SavedExtension">SavedExtension</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="patch /v1/saved-extensions/{id}">client.SavedExtensions.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionService.Update">Update</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>, body <a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2">imagekit</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionUpdateParams">SavedExtensionUpdateParams</a>) (<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SavedExtension">SavedExtension</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="get /v1/saved-extensions">client.SavedExtensions.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>) ([]<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SavedExtension">SavedExtension</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="delete /v1/saved-extensions/{id}">client.SavedExtensions.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionService.Delete">Delete</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>) <a href="https://pkg.go.dev/builtin#error">error</a></code>
+- <code title="get /v1/saved-extensions/{id}">client.SavedExtensions.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2#SavedExtensionService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, id <a href="https://pkg.go.dev/builtin#string">string</a>) (<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared">shared</a>.<a href="https://pkg.go.dev/github.com/imagekit-developer/imagekit-go/v2/shared#SavedExtension">SavedExtension</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
 # Assets
 

api.md

@@ -58,6 +58,64 @@ func TestBetaV2FileUploadWithOptionalParams(t *testing.T) {
 			},
 		}, shared.ExtensionUnionParam{
 			OfAIAutoDescription: &shared.ExtensionAIAutoDescriptionParam{},
+		}, shared.ExtensionUnionParam{
+			OfAITasks: &shared.ExtensionAITasksParam{
+				Tasks: []shared.ExtensionAITasksTaskUnionParam{{
+					OfSelectTags: &shared.ExtensionAITasksTaskSelectTagsParam{
+						Instruction:   "What types of clothing items are visible in this image?",
+						Vocabulary:    []string{"shirt", "tshirt", "dress", "trousers", "jacket"},
+						MaxSelections: imagekit.Int(1),
+						MinSelections: imagekit.Int(0),
+					},
+				}, {
+					OfYesNo: &shared.ExtensionAITasksTaskYesNoParam{
+						Instruction: "Is this a luxury or high-end fashion item?",
+						OnNo: shared.ExtensionAITasksTaskYesNoOnNoParam{
+							AddTags:    []string{"luxury", "premium"},
+							RemoveTags: []string{"budget", "affordable"},
+							SetMetadata: []shared.ExtensionAITasksTaskYesNoOnNoSetMetadataParam{{
+								Field: "price_range",
+								Value: shared.ExtensionAITasksTaskYesNoOnNoSetMetadataValueUnionParam{
+									OfString: imagekit.String("premium"),
+								},
+							}},
+							UnsetMetadata: []shared.ExtensionAITasksTaskYesNoOnNoUnsetMetadataParam{{
+								Field: "price_range",
+							}},
+						},
+						OnUnknown: shared.ExtensionAITasksTaskYesNoOnUnknownParam{
+							AddTags:    []string{"luxury", "premium"},
+							RemoveTags: []string{"budget", "affordable"},
+							SetMetadata: []shared.ExtensionAITasksTaskYesNoOnUnknownSetMetadataParam{{
+								Field: "price_range",
+								Value: shared.ExtensionAITasksTaskYesNoOnUnknownSetMetadataValueUnionParam{
+									OfString: imagekit.String("premium"),
+								},
+							}},
+							UnsetMetadata: []shared.ExtensionAITasksTaskYesNoOnUnknownUnsetMetadataParam{{
+								Field: "price_range",
+							}},
+						},
+						OnYes: shared.ExtensionAITasksTaskYesNoOnYesParam{
+							AddTags:    []string{"luxury", "premium"},
+							RemoveTags: []string{"budget", "affordable"},
+							SetMetadata: []shared.ExtensionAITasksTaskYesNoOnYesSetMetadataParam{{
+								Field: "price_range",
+								Value: shared.ExtensionAITasksTaskYesNoOnYesSetMetadataValueUnionParam{
+									OfString: imagekit.String("premium"),
+								},
+							}},
+							UnsetMetadata: []shared.ExtensionAITasksTaskYesNoOnYesUnsetMetadataParam{{
+								Field: "price_range",
+							}},
+						},
+					},
+				}},
+			},
+		}, shared.ExtensionUnionParam{
+			OfSavedExtension: &shared.ExtensionSavedExtensionParam{
+				ID: "ext_abc123",
+			},
 		}},
 		Folder:                  imagekit.String("folder"),
 		IsPrivateFile:           imagekit.Bool(true),

betav2file_test.go

@@ -21,6 +21,7 @@ type Client struct {
 	Dummy                DummyService
 	CustomMetadataFields CustomMetadataFieldService
 	Files                FileService
+	SavedExtensions      SavedExtensionService
 	Assets               AssetService
 	Cache                CacheService
 	Folders              FolderService
@@ -64,6 +65,7 @@ func NewClient(opts ...option.RequestOption) (r Client) {
 	r.Dummy = NewDummyService(opts...)
 	r.CustomMetadataFields = NewCustomMetadataFieldService(opts...)
 	r.Files = NewFileService(opts...)
+	r.SavedExtensions = NewSavedExtensionService(opts...)
 	r.Assets = NewAssetService(opts...)
 	r.Cache = NewCacheService(opts...)
 	r.Folders = NewFolderService(opts...)

client.go

@@ -46,6 +46,9 @@ func (r *DummyService) New(ctx context.Context, body DummyNewParams, opts ...opt
 
 type DummyNewParams struct {
 	BaseOverlay shared.BaseOverlayParam `json:"baseOverlay,omitzero"`
+	// Configuration object for an extension (base extensions only, not saved extension
+	// references).
+	ExtensionConfig shared.ExtensionConfigUnionParam `json:"extensionConfig,omitzero"`
 	// Array of extensions to be applied to the asset. Each extension can be configured
 	// with specific parameters based on the extension type.
 	Extensions shared.ExtensionsParam `json:"extensions,omitzero"`
@@ -63,7 +66,9 @@ type DummyNewParams struct {
 	OverlayTiming   shared.OverlayTimingParam   `json:"overlayTiming,omitzero"`
 	// Resulting set of attributes suitable for an HTML `<img>` element. Useful for
 	// enabling responsive image loading with `srcSet` and `sizes`.
-	ResponsiveImageAttributes       shared.ResponsiveImageAttributesParam       `json:"responsiveImageAttributes,omitzero"`
+	ResponsiveImageAttributes shared.ResponsiveImageAttributesParam `json:"responsiveImageAttributes,omitzero"`
+	// Saved extension object containing extension configuration.
+	SavedExtensions                 shared.SavedExtensionParam                  `json:"savedExtensions,omitzero"`
 	SolidColorOverlay               shared.SolidColorOverlayParam               `json:"solidColorOverlay,omitzero"`
 	SolidColorOverlayTransformation shared.SolidColorOverlayTransformationParam `json:"solidColorOverlayTransformation,omitzero"`
 	// Options for generating ImageKit URLs with transformations. See the