• 2.173latest479671Docs2026-11-03 19:18

  Change detail

  1,150 changes across 256 operations and 4 models

  AllBreakingWarningInfo

  • GET/2/sources
    • breaking

      added DmBadAttachmentProblem DmBadCtaProblem DmBadCustomProfileProblem DmBadMediaProblem DmBadQuickReplyProblem DmBadUrlProblem DmConversationNameTooLongProblem DmConversationNotFoundProblem DmDuplicateProblem DmInactiveDeviceProblem DmNotDeliveredProblem DmNotFoundProblem DmNotOwnerProblem DmParticipantNotAddedProblem DmParticipantNotFoundProblem DmParticipantRestrictedProblem DmParticipantUnavailableProblem DmRateLimitedProblem DmRecipientBlocksSenderProblem DmRecipientCannotReceiveProblem DmRecipientEncryptedUnavailableProblem DmRecipientNotAcceptingProblem DmRecipientNotFoundProblem DmRecipientRestrictsGroupsProblem DmRecipientUnavailableProblem DmRequestInProgressProblem DmSafetyLimitedProblem DmSafetyRejectedProblem DmSenderBlocksRecipientProblem DmSenderDeclinedDmsProblem DmSenderDmsClosedProblem DmSenderEncryptedUnavailableProblem DmSenderNotInConversationProblem DmSenderNotPermittedProblem DmSenderNotVerifiedProblem DmSenderPhoneRequiredProblem DmSenderReadOnlyProblem DmSenderUnavailableProblem DmTextEmptyProblem DmTextTooLongProblem DmTooFewParticipantsProblem DmTooManyParticipantsProblem DmUnsupportedMessageProblem to the response body oneOf list for the response status default

    • breaking

      added DmBadAttachmentProblem DmBadCtaProblem DmBadCustomProfileProblem DmBadMediaProblem DmBadQuickReplyProblem DmBadUrlProblem DmConversationNameTooLongProblem DmConversationNotFoundProblem DmDuplicateProblem DmInactiveDeviceProblem DmNotDeliveredProblem DmNotFoundProblem DmNotOwnerProblem DmParticipantNotAddedProblem DmParticipantNotFoundProblem DmParticipantRestrictedProblem DmParticipantUnavailableProblem DmRateLimitedProblem DmRecipientBlocksSenderProblem DmRecipientCannotReceiveProblem DmRecipientEncryptedUnavailableProblem DmRecipientNotAcceptingProblem DmRecipientNotFoundProblem DmRecipientRestrictsGroupsProblem DmRecipientUnavailableProblem DmRequestInProgressProblem DmSafetyLimitedProblem DmSafetyRejectedProblem DmSenderBlocksRecipientProblem DmSenderDeclinedDmsProblem DmSenderDmsClosedProblem DmSenderEncryptedUnavailableProblem DmSenderNotInConversationProblem DmSenderNotPermittedProblem DmSenderNotVerifiedProblem DmSenderPhoneRequiredProblem DmSenderReadOnlyProblem DmSenderUnavailableProblem DmTextEmptyProblem DmTextTooLongProblem DmTooFewParticipantsProblem DmTooManyParticipantsProblem DmUnsupportedMessageProblem to the errors/items response property oneOf list for the response status 200

    • breaking

      the data response's property type changed from object to array for status 200

    • breaking

      removed the required property data/sources from the response with the 200 status

    • info

      added https://api.x.com/2/problems/dm-bad-attachment https://api.x.com/2/problems/dm-bad-cta https://api.x.com/2/problems/dm-bad-custom-profile https://api.x.com/2/problems/dm-bad-media https://api.x.com/2/problems/dm-bad-quick-reply https://api.x.com/2/problems/dm-bad-url https://api.x.com/2/problems/dm-conversation-name-too-long https://api.x.com/2/problems/dm-conversation-not-found https://api.x.com/2/problems/dm-duplicate https://api.x.com/2/problems/dm-inactive-device https://api.x.com/2/problems/dm-not-delivered https://api.x.com/2/problems/dm-not-found https://api.x.com/2/problems/dm-not-owner https://api.x.com/2/problems/dm-participant-not-added https://api.x.com/2/problems/dm-participant-not-found https://api.x.com/2/problems/dm-participant-restricted https://api.x.com/2/problems/dm-participant-unavailable https://api.x.com/2/problems/dm-rate-limited https://api.x.com/2/problems/dm-recipient-blocks-sender https://api.x.com/2/problems/dm-recipient-cannot-receive https://api.x.com/2/problems/dm-recipient-encrypted-unavailable https://api.x.com/2/problems/dm-recipient-not-accepting https://api.x.com/2/problems/dm-recipient-not-found https://api.x.com/2/problems/dm-recipient-restricts-groups https://api.x.com/2/problems/dm-recipient-unavailable https://api.x.com/2/problems/dm-request-in-progress https://api.x.com/2/problems/dm-safety-limited https://api.x.com/2/problems/dm-safety-rejected https://api.x.com/2/problems/dm-sender-blocks-recipient https://api.x.com/2/problems/dm-sender-declined-dms https://api.x.com/2/problems/dm-sender-dms-closed https://api.x.com/2/problems/dm-sender-encrypted-unavailable https://api.x.com/2/problems/dm-sender-not-in-conversation https://api.x.com/2/problems/dm-sender-not-permitted https://api.x.com/2/problems/dm-sender-not-verified https://api.x.com/2/problems/dm-sender-phone-required https://api.x.com/2/problems/dm-sender-read-only https://api.x.com/2/problems/dm-sender-unavailable https://api.x.com/2/problems/dm-text-empty https://api.x.com/2/problems/dm-text-too-long https://api.x.com/2/problems/dm-too-few-participants https://api.x.com/2/problems/dm-too-many-participants https://api.x.com/2/problems/dm-unsupported-message mapping keys to the response discriminator for the response status default

    • info

      added the optional property meta to the response with the 200 status

    • info

      added https://api.x.com/2/problems/dm-bad-attachment https://api.x.com/2/problems/dm-bad-cta https://api.x.com/2/problems/dm-bad-custom-profile https://api.x.com/2/problems/dm-bad-media https://api.x.com/2/problems/dm-bad-quick-reply https://api.x.com/2/problems/dm-bad-url https://api.x.com/2/problems/dm-conversation-name-too-long https://api.x.com/2/problems/dm-conversation-not-found https://api.x.com/2/problems/dm-duplicate https://api.x.com/2/problems/dm-inactive-device https://api.x.com/2/problems/dm-not-delivered https://api.x.com/2/problems/dm-not-found https://api.x.com/2/problems/dm-not-owner https://api.x.com/2/problems/dm-participant-not-added https://api.x.com/2/problems/dm-participant-not-found https://api.x.com/2/problems/dm-participant-restricted https://api.x.com/2/problems/dm-participant-unavailable https://api.x.com/2/problems/dm-rate-limited https://api.x.com/2/problems/dm-recipient-blocks-sender https://api.x.com/2/problems/dm-recipient-cannot-receive https://api.x.com/2/problems/dm-recipient-encrypted-unavailable https://api.x.com/2/problems/dm-recipient-not-accepting https://api.x.com/2/problems/dm-recipient-not-found https://api.x.com/2/problems/dm-recipient-restricts-groups https://api.x.com/2/problems/dm-recipient-unavailable https://api.x.com/2/problems/dm-request-in-progress https://api.x.com/2/problems/dm-safety-limited https://api.x.com/2/problems/dm-safety-rejected https://api.x.com/2/problems/dm-sender-blocks-recipient https://api.x.com/2/problems/dm-sender-declined-dms https://api.x.com/2/problems/dm-sender-dms-closed https://api.x.com/2/problems/dm-sender-encrypted-unavailable https://api.x.com/2/problems/dm-sender-not-in-conversation https://api.x.com/2/problems/dm-sender-not-permitted https://api.x.com/2/problems/dm-sender-not-verified https://api.x.com/2/problems/dm-sender-phone-required https://api.x.com/2/problems/dm-sender-read-only https://api.x.com/2/problems/dm-sender-unavailable https://api.x.com/2/problems/dm-text-empty https://api.x.com/2/problems/dm-text-too-long https://api.x.com/2/problems/dm-too-few-participants https://api.x.com/2/problems/dm-too-many-participants https://api.x.com/2/problems/dm-unsupported-message discriminator mapping keys to the errors/items response property for the response status 200

  View all changes (1,150)
• 2.17236015794Docs2026-10-26 03:39

  Change detail

  1,169 changes across 240 operations and 1 model

  AllBreakingWarningInfo

  • POST/2/media/subtitles
    • breaking

      the request property id became required

    • breaking

      the request property media_category became required

    • breaking

      the request property subtitles became required

    • breaking

      added RecipientNotMessageableProblem DuplicateRuleProblem InvalidRuleProblem to the response body oneOf list for the response status default

    • breaking

      added RecipientNotMessageableProblem DuplicateRuleProblem InvalidRuleProblem to the errors/items response property oneOf list for the response status 200

    • info

      added https://api.twitter.com/2/problems/duplicate-rules https://api.twitter.com/2/problems/invalid-rules https://api.x.com/2/problems/recipient-not-messageable mapping keys to the response discriminator for the response status default

    • info

      added https://api.twitter.com/2/problems/duplicate-rules https://api.twitter.com/2/problems/invalid-rules https://api.x.com/2/problems/recipient-not-messageable discriminator mapping keys to the errors/items response property for the response status 200

  View all changes (1,169)
• 2.1676,8791,5028,589Docs2026-08-15 02:14

  Change detail

  16,970 changes across 180 operations and 365 models

  AllBreakingWarningInfo

  • GET/2/users/{id}/bookmarks
    • breaking

      added the pattern ^[0-9]{1,19}$ to the path request parameter id

    • breaking

      removed the enum value affiliation from the property items/ of the query request parameter user.fields

    • breaking

      removed the enum value edit_history_tweet_ids from the property items/ of the query request parameter expansions

    • breaking

      removed the enum value entities.note.mentions.username from the property items/ of the query request parameter expansions

    • breaking

      removed the enum value most_recent_tweet_id from the property items/ of the query request parameter user.fields

    • breaking

      removed the enum value pinned_tweet_id from the property items/ of the query request parameter user.fields

    • breaking

      removed the enum value referenced_tweets.id from the property items/ of the query request parameter expansions

  View all changes (16,970)
• 2.162128194Docs2026-05-12 10:44

  Change detail

  214 changes across 77 operations and 3 models

  AllBreakingWarningInfo

  • POST/2/activity/subscriptions
    • breaking

      removed the enum value FollowFollow of the request property event_type

    • breaking

      removed the enum value FollowUnfollow of the request property event_type

    • breaking

      removed the enum value NewsNew of the request property event_type

    • breaking

      removed the enum value ProfileBannerPictureUpdate of the request property event_type

    • breaking

      removed the enum value ProfileBioUpdate of the request property event_type

    • breaking

      removed the enum value ProfileGeoUpdate of the request property event_type

    • breaking

      removed the enum value ProfilePictureUpdate of the request property event_type

  View all changes (214)
• 2.159249Docs2026-03-12 00:29

  Change detail

  15 changes across 10 operations

  AllBreakingWarningInfo

  • GET/2/users/{id}/public_keys
    • breaking

      the data response's property type changed from object to array for status 200

    • warning

      removed the optional property data/public_key from the response with the 200 status

    • warning

      removed the optional property data/signing_public_key from the response with the 200 status

    • warning

      removed the optional property data/token_map from the response with the 200 status

    • warning

      removed the optional property data/version from the response with the 200 status

  • GET/2/marketplace/handles/{handle}/availability
    • breaking

      api path removed without deprecation

  • POST/2/activity/subscriptions
    • info

      added the new chat.conversation_join enum value to the request property event_type

  View all changes (15)
• 2.15810241Docs2026-02-08 15:23
• 2.1562214547Docs2025-12-21 15:24
• 2.13812239Docs2025-05-16 06:44
• 2.13667412Docs2025-04-29 19:42
• 2.114121Docs2024-11-12 16:37
• 2.111631266Docs2024-09-30 11:38
• 2.1052194374Docs2024-08-01 17:43
• 2.934206Docs2024-02-29 21:17
• 2.8612Docs2023-12-21 02:55
• 2.8443Docs2023-12-20 20:17
• 2.821Docs2023-12-07 23:19
• 2.812340540Docs2023-12-07 17:43
• 2.62no API changesDocs2023-05-07 18:40
• 2.61114Docs2023-02-12 09:03
• 2.59Docs2022-12-23 03:23

Revisions go back to the API's first capture.