Tweets

Get bookmark folders

Returns bookmark folders from the connected X account.

get/x/bookmarks/folders

Response

List of bookmark folders

has_next_pageboolean required

Whether another folder page is available

next_cursorstring required

Cursor for the next folder page

Example response

{
  "folders": [
    {
      "id": "1234567890",
      "media": {
        "originalImageUrl": "https://pbs.twimg.com/media/cover.jpg"
      },
      "name": "Read Later"
    }
  ]
}

Changes

Changed in 3 of the 11 revisions of this API.21206

Aug 24, 20265b381ffca02c11See the full diff
- ▲
  the oneOf[subschema #4]/allOf[subschema #2]/ response's property type/format changed from / to object/ for status 402
  response-property-type-changed
- ○
  added 'propertyNames' constraint to the oneOf[subschema #4]/allOf[subschema #2]/ response property for the status 402
  response-property-property-names-added
Aug 19, 202673cd0a1d989c1901See the full diff
- ▲
  the response property folders/items/name became optional for the status 200
  response-property-became-optional
- ●
  added the new closed enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new closed enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new closed enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new closed enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new expired enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new expired enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new expired enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new expired enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402
  response-property-enum-value-added
- ○
  added the optional property folders/items/media to the response with the 200 status
  response-optional-property-added
Aug 12, 2026d5855df0e349304See the full diff
- ●
  added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402 (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402 (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402 (media type: application/json)
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402 (media type: application/json)
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 424
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 502
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 402 (media type: application/json)
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the oneOf[subschema #4]/allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 402 (media type: application/json)
  response-property-enum-value-added
- ○
  response property oneOf[AuthenticatedPaymentRequired]/payment_options/credits/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property oneOf[AuthenticatedPaymentRequired]/payment_options/subscription/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property oneOf[GuestPaymentRequired]/payment_options/credits/create_checkout/provider deprecated (media type: application/json)
  response-property-deprecated
- ○
  response property payment_options/guest_wallet/create_checkout/provider deprecated (media type: application/problem+json)
  response-property-deprecated

Full history