X API v2 — Media
Chunked upload quickstart (/x-api/media/quickstart/media-upload-chunked)
Reworked the guide around the v2 chunked upload paths:
POST /2/media/upload/initializePOST /2/media/upload/{id}/appendPOST /2/media/upload/{id}/finalizeGET /2/media/upload(status)
Notes that the older command-style command=INIT|APPEND|FINALIZE flow on POST /2/media/upload is not used for this workflow. INIT examples now send JSON (not multipart form fields), and samples use categories such as tweet_video. Media category table expanded (including DM and subtitles) with typical size/duration caps. Added guidance that a successful upload can still fail when attaching media to a Post, plus a sample 403 duration error. Removed the link to the old large-video Python sample repo.
Media introduction (/x-api/media/introduction)
Replaced “Media types & size restrictions” with Size and duration limits. Documents that upload and Post-create limits are enforced separately, and that caps follow the authenticated user’s X Premium / verified status and media_category (not the developer API plan). Adds tables for images/GIFs and video (default vs Premium), posting rules for POST /2/tweets, and the 403 duration error. Links fixed to the current create-post docs.
Best practices (/x-api/media/quickstart/best-practices)
Expanded with size/duration limits for default and X Premium / verified accounts, posting-error guidance, amplify_video in the category list, and clearer codec/duration pointers to the chunked upload flow.
Upload media reference (/x-api/media/upload-media)
Title simplified to “Upload media”; endpoint description retained and clarified in the page body.
X API v2 — Posts
Create Post (/x-api/posts/create-post)
New Media attachments section: upload via chunked endpoints, then pass media.media_ids; up to 4 photos, 1 GIF, or 1 video; default vs Premium video caps (20 min / 8 GB vs 125 min / 16 GB); sample 403 when duration exceeds the posting user’s cap.
Manage Posts introduction (/x-api/posts/manage-tweets/introduction)
Media note updated to the v2 initialize/append/finalize paths, with the same attachment limits, Premium-aware caps, and 403 guidance.
Integrate (/x-api/posts/manage-tweets/integrate)
New Media attachments subsection covering chunked upload, attachment limits, and Post-create duration checks.
Create or edit Post (/x-api/posts/create-or-edit-post)
Added Enterprise quote-post warning and note that video on media.media_ids is re-checked at create time (possible 403 duration rejection).
X API v2 — Bookmarks
Create Bookmark
Titles and short descriptions aligned on:
Docs now describe tweet_id or tweet_ids (max 25), optional folder_id, and that billing/rate limits still apply per request.
X API v2 — Fundamentals / streaming
Consuming streaming data (/x-api/fundamentals/consuming-streaming-data)
Documented P99 latency updated from ~6–7 seconds to ~4–5 seconds.
Changelog
Changelog (/changelog)
Added Sep 1, 2026 entry for X API v2 covering documented media upload and Post-create size/duration limits, Premium vs default caps, DM video caps, the 403 duration error, and the chunked upload quickstart’s move to the v2 initialize/append/finalize paths.