late-sdk 0.0.111 → 0.0.113

data/lib/late-sdk/models/edit_post_request.rb

@@ -0,0 +1,216 @@
+=begin
+#Zernio API
+
+#API reference for Zernio. Authenticate with a Bearer API key. Base URL: https://zernio.com/api 
+
+The version of the OpenAPI document: 1.0.1
+Contact: support@zernio.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Late
+  class EditPostRequest < ApiModelBase
+    # The platform to edit the post on. Currently only twitter is supported.
+    attr_accessor :platform
+
+    # The new tweet text content
+    attr_accessor :content
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'platform' => :'platform',
+        :'content' => :'content'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'platform' => :'String',
+        :'content' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Late::EditPostRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Late::EditPostRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'platform')
+        self.platform = attributes[:'platform']
+      else
+        self.platform = nil
+      end
+
+      if attributes.key?(:'content')
+        self.content = attributes[:'content']
+      else
+        self.content = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @platform.nil?
+        invalid_properties.push('invalid value for "platform", platform cannot be nil.')
+      end
+
+      if @content.nil?
+        invalid_properties.push('invalid value for "content", content cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @platform.nil?
+      platform_validator = EnumAttributeValidator.new('String', ["twitter"])
+      return false unless platform_validator.valid?(@platform)
+      return false if @content.nil?
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] platform Object to be assigned
+    def platform=(platform)
+      validator = EnumAttributeValidator.new('String', ["twitter"])
+      unless validator.valid?(platform)
+        fail ArgumentError, "invalid value for \"platform\", must be one of #{validator.allowable_values}."
+      end
+      @platform = platform
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] content Value to be assigned
+    def content=(content)
+      if content.nil?
+        fail ArgumentError, 'content cannot be nil'
+      end
+
+      @content = content
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          platform == o.platform &&
+          content == o.content
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [platform, content].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/late-sdk/models/facebook_platform_data.rb

@@ -16,13 +16,16 @@ require 'time'
 module Late
   # Feed posts support up to 10 images (no mixed video+image). Stories require single media (24h, no captions). Reels require single vertical video (9:16, 3-60s).
   class FacebookPlatformData < ApiModelBase
+    # When true, creates the post as an unpublished draft visible in Facebook Publishing Tools instead of publishing immediately. Supported for feed posts (text, link, image, video) and reels. Not supported for stories. Drafts expire after ~30 days.
+    attr_accessor :draft
+
     # Set to 'story' for Page Stories (24h ephemeral) or 'reel' for Reels (short vertical video). Defaults to feed post if omitted.
     attr_accessor :content_type
 
     # Reel title (only for contentType=reel). Separate from the caption/content field.
     attr_accessor :title
 
-    # Optional first comment to post immediately after publishing (feed posts only, not stories or reels)
+    # Optional first comment to post immediately after publishing (feed posts and reels, not stories). Skipped when draft is true.
     attr_accessor :first_comment
 
     # Target Facebook Page ID for multi-page posting. If omitted, uses the default page. Use GET /v1/accounts/{id}/facebook-page to list pages.
@@ -53,6 +56,7 @@ module Late
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'draft' => :'draft',
         :'content_type' => :'contentType',
         :'title' => :'title',
         :'first_comment' => :'firstComment',
@@ -73,6 +77,7 @@ module Late
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'draft' => :'Boolean',
         :'content_type' => :'String',
         :'title' => :'String',
         :'first_comment' => :'String',
@@ -102,6 +107,12 @@ module Late
         h[k.to_sym] = v
       }
 
+      if attributes.key?(:'draft')
+        self.draft = attributes[:'draft']
+      else
+        self.draft = false
+      end
+
       if attributes.key?(:'content_type')
         self.content_type = attributes[:'content_type']
       end
@@ -151,6 +162,7 @@ module Late
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          draft == o.draft &&
           content_type == o.content_type &&
           title == o.title &&
           first_comment == o.first_comment &&
@@ -166,7 +178,7 @@ module Late
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [content_type, title, first_comment, page_id].hash
+      [draft, content_type, title, first_comment, page_id].hash
     end
 
     # Builds the object from hash

data/lib/late-sdk/models/twitter_platform_data.rb

@@ -26,6 +26,9 @@ module Late
 
     attr_accessor :poll
 
+    # Enable long video uploads (over 140 seconds) using amplify_video media category. Requires the connected X account to have an active X Premium subscription. When true, videos are uploaded with the amplify_video category which supports longer durations (up to 10 minutes via API). When false or omitted, the standard tweet_video category is used (140 second limit). Note that not all Premium accounts have API long-video access, as X may require separate allowlisting.
+    attr_accessor :long_video
+
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -54,7 +57,8 @@ module Late
         :'reply_to_tweet_id' => :'replyToTweetId',
         :'reply_settings' => :'replySettings',
         :'thread_items' => :'threadItems',
-        :'poll' => :'poll'
+        :'poll' => :'poll',
+        :'long_video' => :'longVideo'
       }
     end
 
@@ -74,7 +78,8 @@ module Late
         :'reply_to_tweet_id' => :'String',
         :'reply_settings' => :'String',
         :'thread_items' => :'Array<TwitterPlatformDataThreadItemsInner>',
-        :'poll' => :'TwitterPlatformDataPoll'
+        :'poll' => :'TwitterPlatformDataPoll',
+        :'long_video' => :'Boolean'
       }
     end
 
@@ -117,6 +122,12 @@ module Late
       if attributes.key?(:'poll')
         self.poll = attributes[:'poll']
       end
+
+      if attributes.key?(:'long_video')
+        self.long_video = attributes[:'long_video']
+      else
+        self.long_video = false
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -154,7 +165,8 @@ module Late
           reply_to_tweet_id == o.reply_to_tweet_id &&
           reply_settings == o.reply_settings &&
           thread_items == o.thread_items &&
-          poll == o.poll
+          poll == o.poll &&
+          long_video == o.long_video
     end
 
     # @see the `==` method
@@ -166,7 +178,7 @@ module Late
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [reply_to_tweet_id, reply_settings, thread_items, poll].hash
+      [reply_to_tweet_id, reply_settings, thread_items, poll, long_video].hash
     end
 
     # Builds the object from hash

data/lib/late-sdk/models/update_post_request.rb

@@ -22,6 +22,9 @@ module Late
     # Root-level TikTok settings applied to all TikTok platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
     attr_accessor :tiktok_settings
 
+    # Root-level Facebook settings applied to all Facebook platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
+    attr_accessor :facebook_settings
+
     attr_accessor :recycling
 
     # Attribute mapping from ruby-style variable name to JSON key.
@@ -30,6 +33,7 @@ module Late
         :'content' => :'content',
         :'scheduled_for' => :'scheduledFor',
         :'tiktok_settings' => :'tiktokSettings',
+        :'facebook_settings' => :'facebookSettings',
         :'recycling' => :'recycling'
       }
     end
@@ -50,6 +54,7 @@ module Late
         :'content' => :'String',
         :'scheduled_for' => :'Time',
         :'tiktok_settings' => :'TikTokPlatformData',
+        :'facebook_settings' => :'FacebookPlatformData',
         :'recycling' => :'RecyclingConfig'
       }
     end
@@ -88,6 +93,10 @@ module Late
         self.tiktok_settings = attributes[:'tiktok_settings']
       end
 
+      if attributes.key?(:'facebook_settings')
+        self.facebook_settings = attributes[:'facebook_settings']
+      end
+
       if attributes.key?(:'recycling')
         self.recycling = attributes[:'recycling']
       end
@@ -116,6 +125,7 @@ module Late
           content == o.content &&
           scheduled_for == o.scheduled_for &&
           tiktok_settings == o.tiktok_settings &&
+          facebook_settings == o.facebook_settings &&
           recycling == o.recycling
     end
 
@@ -128,7 +138,7 @@ module Late
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [content, scheduled_for, tiktok_settings, recycling].hash
+      [content, scheduled_for, tiktok_settings, facebook_settings, recycling].hash
     end
 
     # Builds the object from hash

data/lib/late-sdk/version.rb

@@ -11,5 +11,5 @@ Generator version: 7.19.0
 =end
 
 module Late
-  VERSION = '0.0.111'
+  VERSION = '0.0.113'
 end

data/lib/late-sdk.rb

@@ -111,6 +111,11 @@ require 'late-sdk/models/create_google_business_media200_response'
 require 'late-sdk/models/create_google_business_media_request'
 require 'late-sdk/models/create_google_business_place_action200_response'
 require 'late-sdk/models/create_google_business_place_action_request'
+require 'late-sdk/models/create_inbox_conversation201_response'
+require 'late-sdk/models/create_inbox_conversation201_response_data'
+require 'late-sdk/models/create_inbox_conversation400_response'
+require 'late-sdk/models/create_inbox_conversation422_response'
+require 'late-sdk/models/create_inbox_conversation_request'
 require 'late-sdk/models/create_invite_token201_response'
 require 'late-sdk/models/create_invite_token_request'
 require 'late-sdk/models/create_post409_response'
@@ -163,6 +168,8 @@ require 'late-sdk/models/edit_inbox_message200_response_data'
 require 'late-sdk/models/edit_inbox_message_request'
 require 'late-sdk/models/edit_inbox_message_request_reply_markup'
 require 'late-sdk/models/edit_inbox_message_request_reply_markup_keyboard_inner_inner'
+require 'late-sdk/models/edit_post200_response'
+require 'late-sdk/models/edit_post_request'
 require 'late-sdk/models/enroll_contacts200_response'
 require 'late-sdk/models/enroll_contacts_request'
 require 'late-sdk/models/error_response'

data/openapi.yaml

@@ -1633,6 +1633,10 @@ components:
           required:
             - options
             - duration_minutes
+        longVideo:
+          type: boolean
+          default: false
+          description: Enable long video uploads (over 140 seconds) using amplify_video media category. Requires the connected X account to have an active X Premium subscription. When true, videos are uploaded with the amplify_video category which supports longer durations (up to 10 minutes via API). When false or omitted, the standard tweet_video category is used (140 second limit). Note that not all Premium accounts have API long-video access, as X may require separate allowlisting.
 
     ThreadsPlatformData:
       type: object
@@ -1657,6 +1661,10 @@ components:
     FacebookPlatformData:
       type: object
       properties:
+        draft:
+          type: boolean
+          description: When true, creates the post as an unpublished draft visible in Facebook Publishing Tools instead of publishing immediately. Supported for feed posts (text, link, image, video) and reels. Not supported for stories. Drafts expire after ~30 days.
+          default: false
         contentType:
           type: string
           enum: [story, reel]
@@ -1666,7 +1674,7 @@ components:
           description: Reel title (only for contentType=reel). Separate from the caption/content field.
         firstComment:
           type: string
-          description: Optional first comment to post immediately after publishing (feed posts only, not stories or reels)
+          description: Optional first comment to post immediately after publishing (feed posts and reels, not stories). Skipped when draft is true.
         pageId:
           type: string
           description: Target Facebook Page ID for multi-page posting. If omitted, uses the default page. Use GET /v1/accounts/{id}/facebook-page to list pages.
@@ -5164,6 +5172,9 @@ paths:
                 tiktokSettings:
                   $ref: '#/components/schemas/TikTokPlatformData'
                   description: Root-level TikTok settings applied to all TikTok platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
+                facebookSettings:
+                  $ref: '#/components/schemas/FacebookPlatformData'
+                  description: Root-level Facebook settings applied to all Facebook platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
                 recycling:
                   $ref: '#/components/schemas/RecyclingConfig'
                 queuedFromProfile:
@@ -5176,6 +5187,16 @@ paths:
                     Only used when queuedFromProfile is also provided.
                     If omitted, uses the profile's default queue.
             examples:
+              facebookDraft:
+                summary: Facebook draft post (visible in Publishing Tools)
+                value:
+                  content: "Draft post for review before publishing"
+                  platforms:
+                    - platform: facebook
+                      accountId: "64e1f0a9e2b5af0012ab34cd"
+                  publishNow: true
+                  facebookSettings:
+                    draft: true
               recyclingPost:
                 summary: Post with weekly recycling and content variations
                 value:
@@ -5521,6 +5542,9 @@ paths:
                 tiktokSettings:
                   $ref: '#/components/schemas/TikTokPlatformData'
                   description: Root-level TikTok settings applied to all TikTok platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
+                facebookSettings:
+                  $ref: '#/components/schemas/FacebookPlatformData'
+                  description: Root-level Facebook settings applied to all Facebook platforms. Merged into each platform's platformSpecificData, with platform-specific settings taking precedence.
                 recycling:
                   $ref: '#/components/schemas/RecyclingConfig'
               additionalProperties: true
@@ -5762,6 +5786,69 @@ paths:
         '404': { $ref: '#/components/responses/NotFound' }
         '500':
           description: Platform API deletion failed
+  /v1/posts/{postId}/edit:
+    post:
+      operationId: editPost
+      tags: [Posts]
+      summary: Edit published post
+      description: |
+        Edit a published post on a social media platform. Currently only supported for X (Twitter).
+
+        **Requirements:**
+        - Connected X account must have an active X Premium subscription
+        - Must be within 1 hour of original publish time
+        - Maximum 5 edits per tweet (enforced by X)
+        - Text-only edits (media changes are not supported)
+
+        The post record in Zernio is updated with the new content and edit history.
+      parameters:
+        - name: postId
+          in: path
+          required: true
+          schema: { type: string }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [platform, content]
+              properties:
+                platform:
+                  type: string
+                  description: The platform to edit the post on. Currently only twitter is supported.
+                  enum: [twitter]
+                content:
+                  type: string
+                  description: The new tweet text content
+            example:
+              platform: "twitter"
+              content: "Updated tweet text with corrected information"
+      responses:
+        '200':
+          description: Post edited successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean }
+                  id: { type: string, description: New tweet ID assigned by X after edit }
+                  url: { type: string, format: uri, description: URL of the edited tweet }
+                  message: { type: string }
+              example:
+                success: true
+                id: "1234567890123456790"
+                url: "https://twitter.com/i/web/status/1234567890123456790"
+                message: "Tweet edited successfully"
+        '400':
+          description: "Invalid request: platform not supported, post not published, edit window expired, not Premium, or missing content."
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: Forbidden
+        '404': { $ref: '#/components/responses/NotFound' }
+        '500':
+          description: Platform API edit failed
   /v1/posts/{postId}/update-metadata:
     post:
       operationId: updatePostMetadata
@@ -11492,6 +11579,125 @@ paths:
         '401': { $ref: '#/components/responses/Unauthorized' }
         '403':
           description: Inbox addon required
+    post:
+      operationId: createInboxConversation
+      summary: Create conversation
+      description: |
+        Initiate a new direct message conversation with a specified user. If a conversation already exists with the recipient, the message is added to the existing thread.
+
+        **Currently supported platforms:** Twitter/X only. Other platforms will return `PLATFORM_NOT_SUPPORTED`.
+
+        **DM eligibility:** Before sending, the endpoint checks if the recipient accepts DMs from your account (via the `receives_your_dm` field). If not, a 422 error with code `DM_NOT_ALLOWED` is returned. You can skip this check with `skipDmCheck: true` if you have already verified eligibility.
+
+        **X API tier requirement:** DM write endpoints require X API Pro tier ($5,000/month) or Enterprise access. This applies to BYOK (Bring Your Own Key) users who provide their own X API credentials.
+
+        **Rate limits:** 200 requests per 15 minutes, 1,000 per 24 hours per user, 15,000 per 24 hours per app (shared across all DM endpoints).
+      tags: [Messages]
+      security: [{ bearerAuth: [] }]
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [accountId]
+              properties:
+                accountId:
+                  type: string
+                  description: The social account ID to send from
+                participantId:
+                  type: string
+                  description: Twitter numeric user ID of the recipient. Provide either this or `participantUsername`.
+                participantUsername:
+                  type: string
+                  description: Twitter username (with or without @) of the recipient. Resolved to a user ID via lookup. Provide either this or `participantId`.
+                message:
+                  type: string
+                  description: Text content of the message. At least one of `message` or attachment is required.
+                skipDmCheck:
+                  type: boolean
+                  default: false
+                  description: Skip the `receives_your_dm` eligibility check before sending. Use if you have already verified the recipient accepts DMs.
+          multipart/form-data:
+            schema:
+              type: object
+              required: [accountId]
+              properties:
+                accountId:
+                  type: string
+                  description: The social account ID to send from
+                participantId:
+                  type: string
+                  description: Twitter numeric user ID of the recipient
+                participantUsername:
+                  type: string
+                  description: Twitter username (with or without @) of the recipient
+                message:
+                  type: string
+                  description: Text content of the message
+                attachment:
+                  type: string
+                  format: binary
+                  description: Media attachment (image or video). One attachment per message.
+                skipDmCheck:
+                  type: string
+                  enum: ['true', 'false']
+                  default: 'false'
+                  description: Skip the DM eligibility check
+      responses:
+        '201':
+          description: Conversation created successfully
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success: { type: boolean, example: true }
+                  data:
+                    type: object
+                    properties:
+                      messageId:
+                        type: string
+                        description: Platform message ID (dm_event_id)
+                      conversationId:
+                        type: string
+                        description: Platform conversation ID (dm_conversation_id)
+                      participantId:
+                        type: string
+                        description: Twitter numeric user ID of the recipient
+                      participantName:
+                        type: string
+                        nullable: true
+                        description: Display name of the recipient
+                      participantUsername:
+                        type: string
+                        nullable: true
+                        description: Twitter username of the recipient
+        '400':
+          description: Validation error or platform not supported
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error: { type: string }
+                  code: { type: string, enum: [PLATFORM_NOT_SUPPORTED] }
+        '401': { $ref: '#/components/responses/Unauthorized' }
+        '403':
+          description: Inbox addon required or profile limit reached
+        '404':
+          description: Account or recipient user not found
+        '422':
+          description: Recipient does not accept DMs from this account
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  error: { type: string }
+                  code: { type: string, enum: [DM_NOT_ALLOWED] }
+        '429':
+          description: X API rate limit exceeded
   /v1/inbox/conversations/{conversationId}:
     get:
       operationId: getInboxConversation