release: 0.5.0

[stainless-app]

Automated Release PR

0.5.0 (2026-07-22)

Full Changelog: v0.4.1...v0.5.0

Features

• api: api update (4445a25)
• api: api update (30c1879)
• api: api update (5e2cc73)
• api: api update (6022295)
• api: api update (d4c753a)
• api: api update (785b4f7)
• api: api update (a261d36)
• api: propagate production write-action contract (d2c5ea0)
• stlc: configurable CI runner and private-production-repo support in workflow templates (6b33a54)

Bug Fixes

• escape ampersand in OpenAPI summaries for C# XML docs (fb78c9a)
• reconcile generated SDK with release hardening (f611b3e)
• remove unused async lock helper (bf2e7a9)

Chores

• add Context7 refresh workflow (ce2a6d7)
• add FUNDING.yml pointing to xquik.com (b8a37d9)
• merge main into release branch (cb52b50)
• quiet Gradle cache cleanup warnings (6b77330)
• sync OpenAPI spec (c225ad8)
• sync repo (9a241d5)
• update Gradle actions for Node 24 (9c8a3a0)
• wire production_repo for all targets (1a3de89)

Documentation

• add Contributor Covenant 2.1 Code of Conduct (#2192) (afb97b0)
• add DeepWiki badge (3b366af)
• mark Maven publication pending (2aad6f6)

---

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

Note

Release v0.5.0 with new endpoints, idempotency keys, and breaking API changes

• Adds removeFollower (POST) and retrieveReplies (GET) endpoints to UserService; adds resume to WebhookService; adds redirectTopupCheckout and retrieveTopupStatus to CreditService; adds keywords() subservice to MonitorService; replaces apiKeys() with guestWallets() on both client interfaces.
• Replaces file/binary upload inputs with URL strings across MediaUploadParams, ProfileUpdateAvatarParams, and ProfileUpdateBannerParams; removes reply_to_message_id from DmSendParams.
• Adds required idempotencyKey fields to many write-operation params (TweetCreateParams, TweetDeleteParams, LikeCreateParams, LikeDeleteParams, RetweetCreateParams, RetweetDeleteParams, FollowCreateParams, FollowDeleteAllParams, DmSendParams, MediaUploadParams, ProfileUpdateAvatarParams, ProfileUpdateBannerParams, CommunityCreateParams, CommunityDeleteParams, and join/community params); builders enforce presence and inject Idempotency-Key headers.
• Extends params models for tweets, users, and communities with broad search filter fields (anyWords, cashtags, mediaType, sinceDate, untilDate, etc.) and renames pagination parameter from after to cursor across extraction, draw, and event list params.
• Adds ProxyAuthenticator support to OkHttp client builders; wraps the HTTP client with LoggingHttpClient controlled by logLevel; moves security headers (x-api-key, Authorization) to per-request SecurityOptions instead of construction time.
• Risk: retrieveBatch on UserService now returns UserRetrieveBatchResponse instead of PaginatedUsers; balance, lifetimePurchased, and lifetimeUsed on credit balance models now return String instead of Long; CreditTopupBalanceParams replaces amount with dollars; ticket and join community endpoints now send multipart/form-data instead of JSON bodies.

^{Macroscope summarized 890c92d.}

[greptile-apps]

Too many files changed for review. (531 files found, 200 file limit)

[stainless-app]

🧪 Testing

To try out this version of the SDK:

Add the following URL as a Maven source: 'https://pkg.stainless.com/s/x-twitter-scraper-java/d2c5ea0b30154b5e24d3f287a3d447f3ea33516f/mvn'

Expires at: Thu, 20 Aug 2026 07:19:39 GMT
Updated at: Tue, 21 Jul 2026 07:19:39 GMT

[stainless-app]

🤖 Release is at https://github.com/Xquik-dev/x-twitter-scraper-java/releases/tag/v0.5.0 🌻