release: 0.5.0

[stainless-app]

Automated Release PR

0.5.0 (2026-07-22)

Full Changelog: v0.4.5...v0.5.0

Features

• api: propagate durable write actions (b959adc)
• api: propagate production write-action contract (b433f8d)
• stlc: configurable CI runner and private-production-repo support in workflow templates (9ad8d7c)

Bug Fixes

• client: elide content type header on requests without body (b0186db)

Chores

• deps: support connection_pool 3 (ad578c2)

---

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 idempotency key support and expanded write-action response models

• Adds a required idempotency_key parameter to all write operations (tweets, likes, retweets, follows, DMs, media uploads, profile updates, community actions, support tickets), sent as the idempotency-key HTTP header rather than in the request body.
• Expands all write-action response models (e.g. TweetCreateResponse, LikeCreateResponse, DmSendResponse, MediaUploadResponse, etc.) from a minimal { success: true } shape to a full lifecycle record including id, account, action, billing, next_action, request, result, target, status_url, poll_after_ms, and many optional timestamp/metadata fields.
• Adds rich nested models and enums (Account, Action, Billing, NextAction, Request, Result, Target, Status) with Sorbet RBI and RBS signatures to all write-action response types.
• Expands WriteActionRetrieveResponse with new nested Account, Billing, NextAction, Request, Result, and Target models, replacing the previous Media-based structure.
• Adds attachments (with public_id and Status enum) to TicketCreateResponse, TicketReplyResponse, and TicketRetrieveResponse::Message.
• Extends Error model with optional message, reason, retry_after, and retry_after_ms fields and many new error code enum constants.
• Removes followers and verified from TweetAuthor, and replaces attachment_url with idempotency_key in TweetCreateParams.
• Risk: success is no longer a constant true on write-action responses — it is now a Boolean, so callers that assumed success must now check the field explicitly. Many response models also require new fields that were previously absent, which will cause validation failures if the API returns the old shape.

^{Macroscope summarized 1e3b374.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

bundle remove x-twitter-scraper && bundle add x-twitter-scraper --source 'https://pkg.stainless.com/s/x-twitter-scraper-ruby/dc274e5023fe1c122d5a61a0669c05d1f461f823'

Expires at: Fri, 21 Aug 2026 16:14:29 GMT
Updated at: Wed, 22 Jul 2026 16:14:29 GMT

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	x-twitter-scraper@​0.4.5 ⏵ 0.5.0	N/A	N/A	N/A	N/A	N/A

View full report

[stainless-app]

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