release: 3.0.0

[stainless-app]

Automated Release PR

3.0.0 (2026-04-21)

Full Changelog: v0.0.1...v3.0.0

Features

• add helper utilities and lib module with tests (92fb768)
• api: add BaseWebhookEvent (4ab06b0)
• api: add customMetadata property to folder schema (0413e64)
• api: add GetImageAttributesOptions and ResponsiveImageAttributes schemas; update resource references in main.yaml; remove dummy endpoint (70d2551)
• api: add path policy related non-breaking changes (6e2eac3)
• api: Add saved extensions API and enhance transformation options (1bca614)
• api: add selectedFieldsSchema in upload and list API response (34289ae)
• api: add webhook signature verification (ff73a7a)
• api: dam related webhook events (8352cba)
• api: dpr type update (6a528ff)
• api: extract UpdateFileDetailsRequest to model (c75a767)
• api: fix spec indentation (26eba98)
• api: fix upload API request params (7abe230)
• api: indentation fix (0caeef8)
• api: Introduce lxc, lyc, lap parameters in overlays. (e3b34fb)
• api: manual updates (afb90e6)
• api: manual updates (b586d51)
• api: manual updates (75ff27c)
• api: manual updates (646022d)
• api: manual updates (f5206be)
• api: manual updates (e474ef2)
• api: manual updates (09a68d6)
• api: manual updates (e01a75a)
• api: manual updates (2d41187)
• api: manual updates (2ef93ad)
• api: manual updates (c6e61f8)
• api: manual updates (1c76234)
• api: manual updates (cd2b64e)
• api: manual updates (1341b62)
• api: manual updates (83ce070)
• api: manual updates (d57885b)
• api: manual updates (74027ef)
• api: manual updates (76c5b5e)
• api: manual updates (b462410)
• api: manual updates (cbbd424)
• api: merge with main to bring back missing parameters (fb7f512)
• api: remove Stainless attribution from readme (065125f)
• api: revert dpr breaking change (997ab63)
• api: update api docs link (0b273a9)
• api: Update env var name (1b520d1)
• api: update webhook event names and remove DAM prefix (0cbbc63)
• client: add HttpRequest#url() method (fa1b9b7)
• client: add connection pooling option (c7a7295)
• client: add more convenience service method overloads (f462bff)
• client: allow configuring dispatcher executor service (a7be5ce)
• client: send X-Stainless-Kotlin-Version header (2224a12)

Bug Fixes

• add ai-tasks property to response schemas with enum values (b0bfdf6)
• add one more method in multipartbuilder to build from json (9dc2f89)
• api: add missing embeddedMetadata and video properties to FileDetails (ceb43dd)
• api: extract shared schemas to prevent Go webhook union breaking changes (f5fdf8f)
• api: rename DamFile events to File for consistency (f18e22b)
• ci: use java-version 21 for publish step (181fbe5)
• client: allow updating header/query affecting fields in toBuilder() (91e327e)
• client: cancel okhttp call when future cancelled (d4b8c84)
• client: deserialization of empty objects (8ccff9b)
• client: disallow coercion from float to int (a6dc3e2)
• client: fully respect max retries (87d2ad3)
• client: incorrect getPackageVersion impl (078eab8)
• client: incorrect Retry-After parsing (15b04f7)
• client: multi-value header serialization (ccb0ffb)
• client: preserve time zone in lenient date-time parsing (3c1ce69)
• client: send retry count header for max retries 0 (87d2ad3)
• date time deserialization leniency (7f3e0d6)
• deserialization order (a7d3f1e)
• docs: fix mcp installation instructions for remote servers (2a727d4)
• fix request delays for retrying to be more respectful of high requested delays (eb80ae5)
• vocab field is required (ea9bfc3)

Chores

• ci: skip lint on metadata-only changes (f43fd3a)
• ci: skip uploading artifacts on stainless-internal branches (19e8f78)
• ci: upgrade actions/github-script (940ebfc)
• ci: upgrade actions/setup-java (e60fd58)
• configure new SDK language (4c0fdb3)
• drop apache dependency (48e02f7)
• improve formatter performance (daaa7f3)
• internal: allow passing args to ./scripts/test (1d14a59)
• internal: bump palantir-java-format (87b5f18)
• internal: change some comment formatting (86ca3d7)
• internal: clean up maven repo artifact script and add html documentation to repo root (8e34e08)
• internal: codegen related update (e970882)
• internal: codegen related update (da02221)
• internal: codegen related update (814caf9)
• internal: codegen related update (cd82f98)
• internal: codegen related update (da788af)
• internal: codegen related update (f25c3c4)
• internal: correct cache invalidation for SKIP_MOCK_TESTS (1f6f1dc)
• internal: depend on packages directly in example (87d2ad3)
• internal: expand imports (f10c1b0)
• internal: improve examples (998d126)
• internal: improve maven repo docs (b92f5f0)
• internal: make OkHttp constructor internal (534feb3)
• internal: remove mock server code (3f1d1c6)
• internal: remove redundant deserializer symbols (2d52469)
• internal: remove unnecessary base URL (98d50fa)
• internal: support uploading Maven repo artifacts to stainless package server (83de2bf)
• internal: tweak CI branches (3e76397)
• internal: update actions/checkout version (7115c38)
• internal: update TestServerExtension comment (89b8598)
• internal: update gitignore (4c944e0)
• internal: update maven repo doc to include authentication (7156f6f)
• internal: update multipart form array serialization (11184c7)
• internal: update retry delay tests (51a3135)
• internal: upgrade AssertJ (99a48d6)
• make Properties more resilient to null (34b930a)
• remove custom code (ec944a0)
• sync repo (05af7d5)
• test on Jackson 2.14.0 to avoid encountering FasterXML/jackson-databind#3240 in tests (7f3e0d6)
• tests: bump steady to v0.19.4 (3b0fc2e)
• tests: update webhook tests (2f221f7)
• update mock server docs (6fb3f0c)
• update placeholder string (6b3d9f5)
• update SDK settings (b39e9dc)
• update SDK settings (00f7055)

Documentation

• correct typo in default value description for custom metadata field (fc00907)
• improve examples (f9a78b0)
• prominently feature MCP server setup in root SDK readmes (41bf700)
• remove $ for better copy-pasteabality (2273b04)

Refactors

• AITags to singular AITag schema with array items pattern (e71dfe1)

Build System

• updating CI (a14b7cc)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

[stainless-app]

🧪 Testing

To try out this version of the SDK:

Add the following URL as a Maven source: 'https://pkg.stainless.com/s/imagekit-java/92fb768157a6630a3770f5ad99596b6c3ed184f3/mvn'

Expires at: Thu, 21 May 2026 08:06:34 GMT
Updated at: Tue, 21 Apr 2026 08:06:34 GMT

[stainless-app]

Release version edited manually

The Pull Request version has been manually set to 3.0.0 and will be used for the release.

If you instead want to use the version number 0.1.0 generated from conventional commits, just remove the label autorelease: custom version from this Pull Request.

[stainless-app]

🤖 Release is at https://github.com/imagekit-developer/imagekit-java/releases/tag/v3.0.0 🌻