v7.2.0

7.2.0 (2026-01-16)

Full Changelog: v7.1.1...v7.2.0

⚠ BREAKING CHANGES

• mcp: remove deprecated tool schemes
• mcp: Migration: To migrate, simply modify the command used to invoke the MCP server. Currently, the only supported tool scheme is code mode. Now, starting the server with just node /path/to/mcp/server or npx package-name will invoke code tools: changing your command to one of these is likely all you will need to do.

Features

• api: add GetImageAttributesOptions and ResponsiveImageAttributes schemas; update resource references in main.yaml; remove dummy endpoint (9ea439a)
• api: Add saved extensions API and enhance transformation options (7916069)
• mcp: add detail field to docs search tool (f36d795)
• mcp: add typescript check to code execution tool (63ab735)
• mcp: enable optional code execution tool on http mcp servers (cc68e38)
• mcp: handle code mode calls in the Stainless API (eb22f08)
• mcp: return logs on code tool errors (6118fe4)
• saved-extensions: update example for creating saved extension to use AI tasks for fashion item categorization (79e535b)
• transformation: add colorReplace and distort transformations; update tests for new parameters (e59b5a7)

Bug Fixes

• add ai-tasks property to response schemas with enum values (370cf0f)
• docs: remove extraneous example object fields (a043056)
• mcp: add client instantiation options to code tool (967c8d9)
• mcpb: pin @anthropic-ai/mcpb version (d81e225)
• mcp: correct code tool API endpoint (f4d2b6c)
• mcp: correct code tool api output types (0371082)
• mcp: fix env parsing (b33b4e9)
• mcp: fix options parsing (de44ed6)
• mcp: pass base url to code tool (908fa87)
• mcp: return correct lines on typescript errors (aa7ae07)
• mcp: return tool execution error on api error (1e866f8)
• mcp: return tool execution error on jq failure (d1949db)
• mcp: update cloudflare worker host page (664a668)
• mcp: update code tool prompt (e3a5c5e)

Chores

• break long lines in snippets into multiline (011013e)
• client: fix logger property type (6269318)
• extract some types in mcp docs (de606ba)
• internal: bump MCP dependencies (7c9719e)
• internal: codegen related update (21edf78)
• internal: codegen related update (b42a623)
• internal: codegen related update (9c3b709)
• internal: codegen related update (1170954)
• internal: codegen related update (4b79947)
• internal: codegen related update (b6b0d1a)
• internal: codegen related update (26acc3a)
• internal: codegen related update (662aa87)
• internal: codegen related update (8c9026a)
• internal: grammar fix (it's -> its) (71e22a3)
• internal: upgrade babel, qs, js-yaml (6896958)
• internal: upgrade eslint (310bf0d)
• internal: use npm pack for build uploads (bdfd369)
• mcp code tool explicit error message when missing a run function (6678ee1)
• mcp: add friendlier MCP code tool errors on incorrect method invocations (636829d)
• mcp: add intent param to execute tool (fb2ca9e)
• mcp: add line numbers to code tool errors (25e4e59)
• mcp: clarify http auth error (00789ac)
• mcp: pass intent param to execute handler (ffd4b9f)
• mcp: remove deprecated tool schemes (b1a0e60)
• mcp: update lockfile (0703827)
• mcp: upgrade dependencies (7fcf371)
• mcp: upgrade jq-web (0750770)
• use latest @modelcontextprotocol/sdk (f7b9b4e)
• use structured error when code execution tool errors (451f306)

Documentation

• add MCP Server Package section to README with details on usage and versioning (5710576)
• mcp: add a README button for one-click add to Cursor (a7575d3)
• mcp: add a README link to add server to VS Code or Claude Code (2a90d28)
• prominently feature MCP server setup in root SDK readmes (80ce57e)
• remove MCP Server section from README ([df32859](df3285946139b100f60c812cf65...

v7.1.1

7.1.1 (2025-10-06)

Full Changelog: v7.1.0...v7.1.1

Features

• api: use scoped package for mcp server (af9b0f4)

Bug Fixes

• add missing 'color' parameter mapping for subtitle overlays transformation. (2c4a6d2)
• lint error (b320d6f)
• linting issues (3794fe5)
• update raw parameter example in README for clarity (e86beab)
• update serverConfig to include valid URLs and improve label descriptions (49d048f)

Chores

• configure new SDK language (33d1237)
• internal: remove .eslintcache (ec12af7)
• jsdoc: fix @link annotations to refer only to parts of the package‘s public interface (4332a7e)

Documentation

• update README to enhance Table of Contents and add raw transformations parameter (892d31c)

Refactors

• streamline transformation string handling in URL construction (6e99777)

v7.1.0

7.1.0 (2025-09-30)

Full Changelog: v7.0.1...v7.1.0

Features

• api: add path policy related non-breaking changes (d50cbcf)
• api: add selectedFieldsSchema in upload and list API response (ec8c8b8)
• api: fix upload API request params (467d77b)
• api: updated docs (962390f)
• mcp: add option for including docs tools (e1a3b52)

Bug Fixes

• mcp: fix cli argument parsing logic (a8da550)
• mcp: resolve a linting issue in server code (e805d24)

Performance Improvements

• faster formatting (7e8cfad)

Chores

• internal: codegen related update (ca24cab)
• internal: codegen related update (2acb106)
• internal: fix incremental formatting in some cases (863e6b7)
• internal: ignore .eslintcache (f991673)
• internal: remove deprecated compilerOptions.baseUrl from tsconfig.json (9e0e5b0)
• mcp: allow pointing docs_search tool at other URLs (bbe84b3)
• update lockfile (dcdc0b7)

Documentation

• correct typo in default value description for custom metadata field (a957209)
• fix link to deploy template in README (ba86045)

v7.0.1

7.0.1 (2025-09-21)

Full Changelog: v7.0.0...v7.0.1

Chores

• update SDK settings (0a6ec00)

v7.0.0

7.0.0 (2025-09-21)

Full Changelog: v0.0.1-alpha.0...v7.0.0

Features

• add examples for URL generation and transformations in README (4bad591)
• add url signing and test cases (b1594d8)
• add webhook verification section to README with example code (b28d7b3)
• allow file parameter in FileUploadParams to accept string type for HTTP URL base base64 case. (738f6d9)
• api: add ai-auto-description field with status options to components schema (96c640d)
• api: add BaseWebhookEvent (dac30e1)
• api: add new webhook events for upload transformations to enhance event tracking (dd98040)
• api: add signed URL options with expiration settings to enhance security features (55d2dd1)
• api: extract UpdateFileDetailsRequest to model (30d976b)
• api: manual updates (608ef99)
• api: manual updates (d0d45ee)
• api: manual updates (78f9507)
• api: manual updates (af5fd2f)
• api: manual updates (2ac7656)
• api: manual updates (d208673)
• api: manual updates (76f3ed7)
• api: manual updates (01bdaa0)
• api: manual updates (9d913fa)
• api: manual updates (dc932e3)
• api: manual updates (50c8520)
• api: manual updates (1d0423a)
• api: manual updates (64fc454)
• api: manual updates (f70d1c2)
• api: manual updates (4efbfee)
• api: manual updates (174eee8)
• api: manual updates (1b740df)
• api: manual updates (636a5a9)
• api: manual updates (c1bc59b)
• api: manual updates (4d7286a)
• api: manual updates (8986981)
• api: manual updates (693e3cf)
• api: manual updates (ace1909)
• api: remove Stainless attribution from readme (454c722)
• api: update api docs link (34d2eb1)
• api: Update env var name (70c98e0)
• docs: add URL generation examples and authentication parameters to README (7a2bc8f)
• docs: improve descriptions for private API key and password fields in client settings (7ab6b37)
• helper: implement getAuthenticationParameters method and test cases (297bb95)
• implement serializeUploadOptions function for upload option serialization and add tests (cfce32f)
• remove password field from ImageKit client initialization in tests and documentation (08a5744)
• tests: add test for transformationPosition as path in signed URL generation (2f37641)
• tests: add tests for transformation handling with absolute URLs and non-default endpoints (188eeee)
• update README to enhance SDK description and usage examples (e1e5abf)
• webhooks: use toBase64 for webhook key in verification (433eb44)
• webhooks: use toBase64 for webhook key in verification (3d0571d)

Bug Fixes

• 24 (5610765)
• add repository details for package (b9e4231)
• added folder object in ListFileResponse (#106) (bfcfbb9)
• coerce nullable values to undefined (66e3b81)
• correct SDK description in package.json (f5d2713)
• docs: add missing commas in URL generation examples for clarity (21caa93)
• package: removed unnecessary types and install-types package (a254d4b)
• update privateAPIKey to privateKey in code and tests (2f93b89)
• updated signed url generations for urls with symbols and unicode characters (#102) (5e264de)
• webhooks: revert toBase64 conversion for webhook key (13c716e)

Chores

• bumped package version to 6.0.0 (85c7ef3)
• ci build action (06a9882)
• do not install brew dependencies in ./scripts/bootstrap by default (69968b1)
• esm: Improved Support for ES Modules (5a4127f)
• lint and format fix ([788885c](788885c3cc5e88341...

Version 6.0.0

What's Changed

• Feature/code enhance: Code enhancement and proper documentation by @vikramparihar in #103
• fix url for ' by @ankur-dwivedi in #102
• fix: added folder object in ListFileResponse by @ahnv in #106
  • This is a breaking change, please refer to ChangeLog for more details

New Contributors

• @vikramparihar made their first contribution in #103

Full Changelog: 5.2.0...6.0.0

Version 5.2.0

What's Changed

• added isPublished and publish object during upload and updateFileDetails respectively by @ankur-dwivedi in #101

Full Changelog: 5.1.0...5.2.0

Version 5.1.0

What's Changed

• added checks paramter by @ankur-dwivedi in #98

Full Changelog: 5.0.1...5.1.0

Version 5.0.1

Fixed a issue related to signed url generation. When the URL contains a diacritic (“é”), invalid signature were being generated resulting in 401. Issue was generated in PHP SDK but is relevant for all backend SDKs.

Version 5.0.0

• Now, you can use the transformation parameter when uploading files to apply both pre and post-transformation.
• We've also introduced two new parameters: effectShadow and effectGradient.
• Fixed two issues: #90 and #88.

Breaking changes

In version 5.0.0, we've removed the old overlay syntax parameters for transformations, such as oi, ot, obg, and more.