late-sdk 0.0.52 → 0.0.53

data/lib/late-sdk.rb

@@ -29,9 +29,12 @@ require 'late-sdk/models/analytics_list_response'
 require 'late-sdk/models/analytics_list_response_posts_inner'
 require 'late-sdk/models/analytics_overview'
 require 'late-sdk/models/analytics_single_post_response'
+require 'late-sdk/models/analytics_single_post_response_media_items_inner'
 require 'late-sdk/models/api_key'
 require 'late-sdk/models/api_key_profile_ids_inner'
 require 'late-sdk/models/bluesky_platform_data'
+require 'late-sdk/models/bookmark_post200_response'
+require 'late-sdk/models/bookmark_post_request'
 require 'late-sdk/models/bulk_delete_whats_app_contacts200_response'
 require 'late-sdk/models/bulk_delete_whats_app_contacts_request'
 require 'late-sdk/models/bulk_update_whats_app_contacts200_response'
@@ -116,6 +119,8 @@ require 'late-sdk/models/edit_inbox_message_request_reply_markup_keyboard_inner_
 require 'late-sdk/models/error_response'
 require 'late-sdk/models/expired'
 require 'late-sdk/models/facebook_platform_data'
+require 'late-sdk/models/follow_user200_response'
+require 'late-sdk/models/follow_user_request'
 require 'late-sdk/models/follower_stats_response'
 require 'late-sdk/models/food_menu'
 require 'late-sdk/models/food_menu_item'
@@ -123,8 +128,10 @@ require 'late-sdk/models/food_menu_item_attributes'
 require 'late-sdk/models/food_menu_item_options_inner'
 require 'late-sdk/models/food_menu_label'
 require 'late-sdk/models/food_menu_section'
+require 'late-sdk/models/gbp_free_form_service_item_label'
 require 'late-sdk/models/gbp_special_hour_period'
 require 'late-sdk/models/gbp_special_hour_period_start_date'
+require 'late-sdk/models/gbp_update_free_form_service_item_label'
 require 'late-sdk/models/get_account_health200_response'
 require 'late-sdk/models/get_account_health200_response_permissions'
 require 'late-sdk/models/get_account_health200_response_permissions_posting_inner'
@@ -157,10 +164,17 @@ require 'late-sdk/models/get_google_business_attributes200_response_attributes_i
 require 'late-sdk/models/get_google_business_attributes200_response_attributes_inner_repeated_enum_value'
 require 'late-sdk/models/get_google_business_food_menus200_response'
 require 'late-sdk/models/get_google_business_location_details200_response'
+require 'late-sdk/models/get_google_business_location_details200_response_categories'
+require 'late-sdk/models/get_google_business_location_details200_response_categories_additional_categories_inner'
+require 'late-sdk/models/get_google_business_location_details200_response_categories_primary_category'
 require 'late-sdk/models/get_google_business_location_details200_response_phone_numbers'
 require 'late-sdk/models/get_google_business_location_details200_response_profile'
 require 'late-sdk/models/get_google_business_location_details200_response_regular_hours'
 require 'late-sdk/models/get_google_business_location_details200_response_regular_hours_periods_inner'
+require 'late-sdk/models/get_google_business_location_details200_response_service_items_inner'
+require 'late-sdk/models/get_google_business_location_details200_response_service_items_inner_free_form_service_item'
+require 'late-sdk/models/get_google_business_location_details200_response_service_items_inner_price'
+require 'late-sdk/models/get_google_business_location_details200_response_service_items_inner_structured_service_item'
 require 'late-sdk/models/get_google_business_location_details200_response_special_hours'
 require 'late-sdk/models/get_google_business_reviews200_response'
 require 'late-sdk/models/get_google_business_reviews200_response_reviews_inner'
@@ -373,6 +387,7 @@ require 'late-sdk/models/recycling_state'
 require 'late-sdk/models/reddit_platform_data'
 require 'late-sdk/models/release_whats_app_phone_number200_response'
 require 'late-sdk/models/release_whats_app_phone_number200_response_phone_number'
+require 'late-sdk/models/remove_bookmark200_response'
 require 'late-sdk/models/remove_whats_app_broadcast_recipients200_response'
 require 'late-sdk/models/remove_whats_app_broadcast_recipients_request'
 require 'late-sdk/models/rename_whats_app_group200_response'
@@ -383,6 +398,8 @@ require 'late-sdk/models/reply_to_inbox_post_request'
 require 'late-sdk/models/reply_to_inbox_review200_response'
 require 'late-sdk/models/reply_to_inbox_review200_response_reply'
 require 'late-sdk/models/reply_to_inbox_review_request'
+require 'late-sdk/models/retweet_post200_response'
+require 'late-sdk/models/retweet_post_request'
 require 'late-sdk/models/schedule_whats_app_broadcast200_response'
 require 'late-sdk/models/schedule_whats_app_broadcast200_response_broadcast'
 require 'late-sdk/models/schedule_whats_app_broadcast_request'
@@ -443,6 +460,8 @@ require 'late-sdk/models/transcript_response'
 require 'late-sdk/models/transcript_segment'
 require 'late-sdk/models/twitter_platform_data'
 require 'late-sdk/models/twitter_platform_data_thread_items_inner'
+require 'late-sdk/models/undo_retweet200_response'
+require 'late-sdk/models/unfollow_user200_response'
 require 'late-sdk/models/unlike_inbox_comment200_response'
 require 'late-sdk/models/unpublish_post200_response'
 require 'late-sdk/models/unpublish_post_request'
@@ -462,9 +481,16 @@ require 'late-sdk/models/update_google_business_food_menus200_response'
 require 'late-sdk/models/update_google_business_food_menus_request'
 require 'late-sdk/models/update_google_business_location_details200_response'
 require 'late-sdk/models/update_google_business_location_details_request'
+require 'late-sdk/models/update_google_business_location_details_request_categories'
+require 'late-sdk/models/update_google_business_location_details_request_categories_additional_categories_inner'
+require 'late-sdk/models/update_google_business_location_details_request_categories_primary_category'
 require 'late-sdk/models/update_google_business_location_details_request_profile'
 require 'late-sdk/models/update_google_business_location_details_request_regular_hours'
 require 'late-sdk/models/update_google_business_location_details_request_regular_hours_periods_inner'
+require 'late-sdk/models/update_google_business_location_details_request_service_items_inner'
+require 'late-sdk/models/update_google_business_location_details_request_service_items_inner_free_form_service_item'
+require 'late-sdk/models/update_google_business_location_details_request_service_items_inner_price'
+require 'late-sdk/models/update_google_business_location_details_request_service_items_inner_structured_service_item'
 require 'late-sdk/models/update_inbox_conversation200_response'
 require 'late-sdk/models/update_inbox_conversation200_response_data'
 require 'late-sdk/models/update_inbox_conversation_request'
@@ -572,6 +598,7 @@ require 'late-sdk/api/queue_api'
 require 'late-sdk/api/reddit_search_api'
 require 'late-sdk/api/reviews_api'
 require 'late-sdk/api/tools_api'
+require 'late-sdk/api/twitter_engagement_api'
 require 'late-sdk/api/usage_api'
 require 'late-sdk/api/users_api'
 require 'late-sdk/api/validate_api'

data/openapi.yaml

@@ -144,7 +144,7 @@ x-documentation:
 
     ## SDKs
 
-    Official SDKs available for: [Node.js](https://www.npmjs.com/package/late), [Python](https://pypi.org/project/late), Go, Ruby, Java, PHP, .NET, and Rust.
+    Official SDKs available for: [Node.js](https://www.npmjs.com/package/@getlatedev/node), [Python](https://pypi.org/project/late-sdk), Go, Ruby, Java, PHP, .NET, and Rust.
 
 servers:
   - url: https://getlate.dev/api
@@ -195,6 +195,11 @@ tags:
       Unified inbox API for managing reviews on Facebook Pages and Google Business accounts.
       All endpoints aggregate data from multiple social accounts in a single API call.
       Requires Inbox addon.
+  - name: Twitter Engagement
+    description: |
+      X/Twitter-specific engagement endpoints for retweeting, bookmarking, and following.
+      All endpoints require an X API Basic tier ($200/mo) or higher. Users must reconnect their X account after upgrading to grant the required OAuth scopes.
+      Rate limits: 50 requests per 15-min window per user. Retweets share the 300/3hr creation limit with tweet creation.
   - name: Tools
     description: |
       Media download and utility tools. Available to paid plans only.
@@ -1784,6 +1789,17 @@ components:
         platform: { type: string }
         platformPostUrl: { type: string, format: uri }
         isExternal: { type: boolean }
+        thumbnailUrl: { type: string, format: uri, nullable: true }
+        mediaType: { type: string, enum: [image, video, carousel, text], nullable: true }
+        mediaItems:
+          type: array
+          description: All media items for this post. Carousel posts contain one entry per slide.
+          items:
+            type: object
+            properties:
+              type: { type: string, enum: [image, video] }
+              url: { type: string, format: uri, description: Direct URL to the media }
+              thumbnail: { type: string, format: uri, description: Thumbnail URL (same as url for images) }
     AnalyticsListResponse:
       type: object
       properties:
@@ -1809,11 +1825,16 @@ components:
               platformPostUrl: { type: string, format: uri }
               isExternal: { type: boolean }
               thumbnailUrl: { type: string, format: uri }
-              mediaType: { type: string, enum: [image, video, gif, document] }
+              mediaType: { type: string, enum: [image, video, gif, document, carousel, text] }
               mediaItems:
                 type: array
+                description: All media items for this post. Carousel posts contain one entry per slide.
                 items:
-                  $ref: '#/components/schemas/MediaItem'
+                  type: object
+                  properties:
+                    type: { type: string, enum: [image, video] }
+                    url: { type: string, format: uri, description: Direct URL to the media }
+                    thumbnail: { type: string, format: uri, description: Thumbnail URL (same as url for images) }
         pagination:
           $ref: '#/components/schemas/Pagination'
         accounts:
@@ -2982,6 +3003,12 @@ paths:
                     platform: "twitter"
                     platformPostUrl: "https://twitter.com/acmecorp/status/123456789"
                     isExternal: false
+                    thumbnailUrl: "https://storage.example.com/image.jpg"
+                    mediaType: "image"
+                    mediaItems:
+                      - type: "image"
+                        url: "https://storage.example.com/image.jpg"
+                        thumbnail: "https://storage.example.com/image.jpg"
                 postList:
                   summary: Paginated analytics list
                   description: |
@@ -3018,7 +3045,14 @@ paths:
                         platformPostUrl: "https://www.instagram.com/reel/ABC123xyz/"
                         isExternal: true
                         thumbnailUrl: "https://storage.example.com/thumb.jpg"
-                        mediaType: "video"
+                        mediaType: "carousel"
+                        mediaItems:
+                          - type: "image"
+                            url: "https://storage.example.com/slide1.jpg"
+                            thumbnail: "https://storage.example.com/slide1.jpg"
+                          - type: "image"
+                            url: "https://storage.example.com/slide2.jpg"
+                            thumbnail: "https://storage.example.com/slide2.jpg"
                     pagination:
                       page: 1
                       limit: 50
@@ -6363,7 +6397,7 @@ paths:
       operationId: getGoogleBusinessLocationDetails
       tags: [GMB Location Details]
       summary: Get location details
-      description: Returns detailed GBP location info (hours, description, phone, website, categories). Use readMask to request specific fields.
+      description: Returns detailed GBP location info (hours, description, phone, website, categories, services). Use readMask to request specific fields.
       parameters:
         - name: accountId
           in: path
@@ -6378,7 +6412,7 @@ paths:
           in: query
           required: false
           schema: { type: string }
-          description: "Comma-separated fields to return. Available: name, title, phoneNumbers, categories, storefrontAddress, websiteUri, regularHours, specialHours, serviceArea, profile, openInfo, metadata, moreHours."
+          description: "Comma-separated fields to return. Available: name, title, phoneNumbers, categories, storefrontAddress, websiteUri, regularHours, specialHours, serviceArea, serviceItems, profile, openInfo, metadata, moreHours."
       security:
         - bearerAuth: []
       responses:
@@ -6428,6 +6462,48 @@ paths:
                     properties:
                       primaryPhone: { type: string }
                       additionalPhones: { type: array, items: { type: string } }
+                  categories:
+                    type: object
+                    description: "Business categories (returned when readMask includes 'categories')"
+                    properties:
+                      primaryCategory:
+                        type: object
+                        properties:
+                          name: { type: string, description: "Category resource name" }
+                          displayName: { type: string, description: "Human-readable category name" }
+                      additionalCategories:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            name: { type: string }
+                            displayName: { type: string }
+                  serviceItems:
+                    type: array
+                    description: "Services offered (returned when readMask includes 'serviceItems')"
+                    items:
+                      type: object
+                      properties:
+                        structuredServiceItem:
+                          type: object
+                          properties:
+                            serviceTypeId: { type: string }
+                            description: { type: string }
+                        freeFormServiceItem:
+                          type: object
+                          properties:
+                            category: { type: string }
+                            label:
+                              type: object
+                              properties:
+                                displayName: { type: string }
+                                languageCode: { type: string }
+                        price:
+                          type: object
+                          properties:
+                            currencyCode: { type: string }
+                            units: { type: string }
+                            nanos: { type: integer }
               example:
                 success: true
                 accountId: "64e1f0a9e2b5af0012ab34cd"
@@ -6450,6 +6526,13 @@ paths:
                 profile:
                   description: "Authentic New York style pizza since 1985"
                 websiteUri: "https://joespizza.com"
+                categories:
+                  primaryCategory:
+                    name: "categories/gcid:pizza_restaurant"
+                    displayName: "Pizza restaurant"
+                  additionalCategories:
+                    - name: "categories/gcid:italian_restaurant"
+                      displayName: "Italian restaurant"
         '400':
           description: Invalid request
           content:
@@ -6465,7 +6548,10 @@ paths:
       operationId: updateGoogleBusinessLocationDetails
       tags: [GMB Location Details]
       summary: Update location details
-      description: Updates GBP location details (hours, description, phone, website). The updateMask field is required and specifies which fields to update.
+      description: |
+        Updates GBP location details. The updateMask field is required and specifies which fields to update.
+        This endpoint proxies Google's Business Information API locations.patch, so any valid updateMask field is supported.
+        Common fields: regularHours, specialHours, profile.description, websiteUri, phoneNumbers, categories, serviceItems.
       parameters:
         - name: accountId
           in: path
@@ -6488,7 +6574,7 @@ paths:
               properties:
                 updateMask:
                   type: string
-                  description: "Required. Comma-separated fields to update (e.g. 'regularHours', 'specialHours', 'profile.description')"
+                  description: "Required. Comma-separated fields to update (e.g. 'regularHours', 'specialHours', 'profile.description', 'categories', 'serviceItems'). Any valid Google Business Information API updateMask field is supported."
                 regularHours:
                   type: object
                   properties:
@@ -6524,25 +6610,111 @@ paths:
                   properties:
                     primaryPhone: { type: string }
                     additionalPhones: { type: array, items: { type: string } }
-            example:
-              updateMask: "regularHours,specialHours"
-              regularHours:
-                periods:
-                  - openDay: "MONDAY"
-                    openTime: "09:00"
-                    closeDay: "MONDAY"
-                    closeTime: "17:00"
-                  - openDay: "SATURDAY"
-                    openTime: "10:00"
-                    closeDay: "SATURDAY"
-                    closeTime: "14:00"
-              specialHours:
-                specialHourPeriods:
-                  - startDate: { year: 2026, month: 12, day: 25 }
-                    closed: true
-                  - startDate: { year: 2026, month: 12, day: 31 }
-                    openTime: "09:00"
-                    closeTime: "15:00"
+                categories:
+                  type: object
+                  description: "Primary and additional business categories. Use updateMask='categories' to update."
+                  properties:
+                    primaryCategory:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                          description: "Category resource name (e.g. 'categories/gcid:laundromat'). Use Google's Categories API to look up valid IDs."
+                    additionalCategories:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          name:
+                            type: string
+                            description: "Category resource name (e.g. 'categories/gcid:dry_cleaner')"
+                serviceItems:
+                  type: array
+                  description: "Services offered by the business. Use updateMask='serviceItems' to update."
+                  items:
+                    type: object
+                    properties:
+                      structuredServiceItem:
+                        type: object
+                        description: "A predefined service from Google's service type catalog"
+                        properties:
+                          serviceTypeId:
+                            type: string
+                            description: "Service type ID from Google's catalog (e.g. 'job_type_id:plumbing_drain_repair')"
+                          description:
+                            type: string
+                            description: "Optional description of the service"
+                      freeFormServiceItem:
+                        type: object
+                        description: "A custom service not in Google's catalog"
+                        properties:
+                          category:
+                            type: string
+                            description: "Category resource name this service belongs to (e.g. 'categories/gcid:laundromat')"
+                          label:
+                            type: object
+                            properties:
+                              displayName:
+                                type: string
+                                description: "Service name as displayed to users"
+                              languageCode:
+                                type: string
+                                description: "Language code (e.g. 'en')"
+                      price:
+                        type: object
+                        description: "Optional price for the service"
+                        properties:
+                          currencyCode: { type: string, description: "ISO 4217 currency code (e.g. 'USD')" }
+                          units: { type: string, description: "Whole units of the amount" }
+                          nanos: { type: integer, description: "Nano units (10^-9) of the amount" }
+            examples:
+              updateHours:
+                summary: Update business hours
+                value:
+                  updateMask: "regularHours,specialHours"
+                  regularHours:
+                    periods:
+                      - openDay: "MONDAY"
+                        openTime: "09:00"
+                        closeDay: "MONDAY"
+                        closeTime: "17:00"
+                      - openDay: "SATURDAY"
+                        openTime: "10:00"
+                        closeDay: "SATURDAY"
+                        closeTime: "14:00"
+                  specialHours:
+                    specialHourPeriods:
+                      - startDate: { year: 2026, month: 12, day: 25 }
+                        closed: true
+                      - startDate: { year: 2026, month: 12, day: 31 }
+                        openTime: "09:00"
+                        closeTime: "15:00"
+              updateCategories:
+                summary: Update business categories
+                value:
+                  updateMask: "categories"
+                  categories:
+                    primaryCategory:
+                      name: "categories/gcid:laundromat"
+                    additionalCategories:
+                      - name: "categories/gcid:dry_cleaner"
+                      - name: "categories/gcid:laundry_service"
+              updateServices:
+                summary: Update service items
+                value:
+                  updateMask: "serviceItems"
+                  serviceItems:
+                    - structuredServiceItem:
+                        serviceTypeId: "job_type_id:plumbing_drain_repair"
+                        description: "Full drain cleaning and repair service"
+                    - freeFormServiceItem:
+                        category: "categories/gcid:laundromat"
+                        label:
+                          displayName: "Wash & Fold Service"
+                          languageCode: "en"
+                      price:
+                        currencyCode: "USD"
+                        units: "25"
       responses:
         '200':
           description: Location updated successfully
@@ -10983,8 +11155,9 @@ paths:
       operationId: hideInboxComment
       summary: Hide comment
       description: |
-        Hide a comment on a post. Supported by Facebook, Instagram, and Threads.
+        Hide a comment on a post. Supported by Facebook, Instagram, Threads, and X/Twitter.
         Hidden comments are only visible to the commenter and page admin.
+        For X/Twitter, the reply must belong to a conversation started by the authenticated user. Requires the tweet.moderate.write scope and X API Basic tier or higher.
       tags: [Comments]
       security: [{ bearerAuth: [] }]
       parameters:
@@ -11026,7 +11199,7 @@ paths:
       operationId: unhideInboxComment
       summary: Unhide comment
       description: |
-        Unhide a previously hidden comment. Supported by Facebook, Instagram, and Threads.
+        Unhide a previously hidden comment. Supported by Facebook, Instagram, Threads, and X/Twitter.
       tags: [Comments]
       security: [{ bearerAuth: [] }]
       parameters:
@@ -11241,6 +11414,210 @@ paths:
         '404':
           description: Account not found
 
+  /v1/twitter/retweet:
+    post:
+      operationId: retweetPost
+      summary: Retweet a post
+      description: |
+        Retweet (repost) a tweet by ID. Requires X API Basic tier ($200/mo) or higher.
+        Rate limit: 50 requests per 15-min window. Shares the 300/3hr creation limit with tweet creation.
+      tags: [Twitter Engagement]
+      security: [{ bearerAuth: [] }]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, tweetId]
+              properties:
+                accountId: { type: string, description: The social account ID }
+                tweetId: { type: string, description: The ID of the tweet to retweet }
+      responses:
+        '200':
+          description: Tweet retweeted
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  tweetId: { type: string }
+                  retweeted: { type: boolean }
+                  platform: { type: string, example: twitter }
+        '400': { description: Bad request or platform limitation }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Account not found }
+    delete:
+      operationId: undoRetweet
+      summary: Undo retweet
+      description: |
+        Undo a retweet (un-repost a tweet).
+      tags: [Twitter Engagement]
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - name: accountId
+          in: query
+          required: true
+          schema: { type: string }
+        - name: tweetId
+          in: query
+          required: true
+          schema: { type: string }
+          description: The ID of the original tweet to un-retweet
+      responses:
+        '200':
+          description: Retweet undone
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  tweetId: { type: string }
+                  retweeted: { type: boolean, example: false }
+                  platform: { type: string, example: twitter }
+        '400': { description: Bad request }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Account not found }
+
+  /v1/twitter/bookmark:
+    post:
+      operationId: bookmarkPost
+      summary: Bookmark a tweet
+      description: |
+        Bookmark a tweet by ID. Requires X API Basic tier ($200/mo) or higher.
+        Requires the bookmark.write OAuth scope.
+        Rate limit: 50 requests per 15-min window.
+      tags: [Twitter Engagement]
+      security: [{ bearerAuth: [] }]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, tweetId]
+              properties:
+                accountId: { type: string, description: The social account ID }
+                tweetId: { type: string, description: The ID of the tweet to bookmark }
+      responses:
+        '200':
+          description: Tweet bookmarked
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  tweetId: { type: string }
+                  bookmarked: { type: boolean }
+                  platform: { type: string, example: twitter }
+        '400': { description: Bad request or platform limitation }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Account not found }
+    delete:
+      operationId: removeBookmark
+      summary: Remove bookmark
+      description: |
+        Remove a bookmark from a tweet.
+      tags: [Twitter Engagement]
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - name: accountId
+          in: query
+          required: true
+          schema: { type: string }
+        - name: tweetId
+          in: query
+          required: true
+          schema: { type: string }
+          description: The ID of the tweet to unbookmark
+      responses:
+        '200':
+          description: Bookmark removed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  tweetId: { type: string }
+                  bookmarked: { type: boolean, example: false }
+                  platform: { type: string, example: twitter }
+        '400': { description: Bad request }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Account not found }
+
+  /v1/twitter/follow:
+    post:
+      operationId: followUser
+      summary: Follow a user
+      description: |
+        Follow a user on X/Twitter. Requires X API Basic tier ($200/mo) or higher.
+        Requires the follows.write OAuth scope.
+        For protected accounts, a follow request is sent instead (pending_follow will be true).
+      tags: [Twitter Engagement]
+      security: [{ bearerAuth: [] }]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId, targetUserId]
+              properties:
+                accountId: { type: string, description: The social account ID }
+                targetUserId: { type: string, description: The Twitter ID of the user to follow }
+      responses:
+        '200':
+          description: User followed or follow request sent
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  targetUserId: { type: string }
+                  following: { type: boolean }
+                  pending_follow: { type: boolean, description: True if the target account is protected and a follow request was sent }
+                  platform: { type: string, example: twitter }
+        '400': { description: Bad request or platform limitation }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Account not found }
+    delete:
+      operationId: unfollowUser
+      summary: Unfollow a user
+      description: |
+        Unfollow a user on X/Twitter.
+      tags: [Twitter Engagement]
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - name: accountId
+          in: query
+          required: true
+          schema: { type: string }
+        - name: targetUserId
+          in: query
+          required: true
+          schema: { type: string }
+          description: The Twitter ID of the user to unfollow
+      responses:
+        '200':
+          description: User unfollowed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status: { type: string, example: success }
+                  targetUserId: { type: string }
+                  following: { type: boolean, example: false }
+                  platform: { type: string, example: twitter }
+        '400': { description: Bad request }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '404': { description: Account not found }
+
   /v1/inbox/reviews:
     get:
       operationId: listInboxReviews

data/spec/api/comments_api_spec.rb

@@ -65,7 +65,7 @@ describe 'CommentsApi' do
 
   # unit tests for hide_inbox_comment
   # Hide comment
-  # Hide a comment on a post. Supported by Facebook, Instagram, and Threads. Hidden comments are only visible to the commenter and page admin. 
+  # Hide a comment on a post. Supported by Facebook, Instagram, Threads, and X/Twitter. Hidden comments are only visible to the commenter and page admin. For X/Twitter, the reply must belong to a conversation started by the authenticated user. Requires the tweet.moderate.write scope and X API Basic tier or higher. 
   # @param post_id 
   # @param comment_id 
   # @param hide_inbox_comment_request 
@@ -140,7 +140,7 @@ describe 'CommentsApi' do
 
   # unit tests for unhide_inbox_comment
   # Unhide comment
-  # Unhide a previously hidden comment. Supported by Facebook, Instagram, and Threads. 
+  # Unhide a previously hidden comment. Supported by Facebook, Instagram, Threads, and X/Twitter. 
   # @param post_id 
   # @param comment_id 
   # @param account_id