postboost 1.0.0 → 1.8.0

data/lib/postboost/api/posts_api.rb

@@ -1,9 +1,9 @@
 =begin
 #PostBoost API
 
-#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 8+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
+#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 12+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Plan access Every workspace-scoped endpoint returns `403` when the workspace's plan does not include API access (capability `api`).  ## Dates and times Post dates and times (`date`, `time`, `accounts_schedule`) are read in the request's `timezone` when one is given, otherwise in the workspace timezone.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
 
-The version of the OpenAPI document: 1.0.0
+The version of the OpenAPI document: 1.8.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -20,10 +20,11 @@ module PostBoost
       @api_client = api_client
     end
     # Add post to queue
-    # Add an existing post to the smart publishing queue.
+    # Add an existing post to the smart publishing queue. Each account of the post gets its own next free queue slot. Returns `422` when the post has no accounts, the posting schedule has no available times, or provider requirements are not met. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
+    # @option opts [AddPostToQueueRequest] :add_post_to_queue_request 
     # @return [ScheduleResult]
     def add_post_to_queue(workspace_uuid, post_uuid, opts = {})
       data, _status_code, _headers = add_post_to_queue_with_http_info(workspace_uuid, post_uuid, opts)
@@ -31,10 +32,11 @@ module PostBoost
     end
 
     # Add post to queue
-    # Add an existing post to the smart publishing queue.
+    # Add an existing post to the smart publishing queue. Each account of the post gets its own next free queue slot. Returns `422` when the post has no accounts, the posting schedule has no available times, or provider requirements are not met. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
+    # @option opts [AddPostToQueueRequest] :add_post_to_queue_request 
     # @return [Array<(ScheduleResult, Integer, Hash)>] ScheduleResult data, response status code and response headers
     def add_post_to_queue_with_http_info(workspace_uuid, post_uuid, opts = {})
       if @api_client.config.debugging
@@ -58,12 +60,17 @@ module PostBoost
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'add_post_to_queue_request'])
 
       # return_type
       return_type = opts[:debug_return_type] || 'ScheduleResult'
@@ -89,10 +96,11 @@ module PostBoost
     end
 
     # Approve post
-    # Approve a post that is pending review.
+    # Approve a post that is pending review. The approver may move the post with `date`/`time` (read in `timezone`) and set per-account times with `accounts_schedule`; without them the post keeps the time it was submitted with. Provider requirements are validated and reported as `422`. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
+    # @option opts [ApprovePostRequest] :approve_post_request 
     # @return [ScheduleResult]
     def approve_post(workspace_uuid, post_uuid, opts = {})
       data, _status_code, _headers = approve_post_with_http_info(workspace_uuid, post_uuid, opts)
@@ -100,10 +108,11 @@ module PostBoost
     end
 
     # Approve post
-    # Approve a post that is pending review.
+    # Approve a post that is pending review. The approver may move the post with &#x60;date&#x60;/&#x60;time&#x60; (read in &#x60;timezone&#x60;) and set per-account times with &#x60;accounts_schedule&#x60;; without them the post keeps the time it was submitted with. Provider requirements are validated and reported as &#x60;422&#x60;. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
+    # @option opts [ApprovePostRequest] :approve_post_request 
     # @return [Array<(ScheduleResult, Integer, Hash)>] ScheduleResult data, response status code and response headers
     def approve_post_with_http_info(workspace_uuid, post_uuid, opts = {})
       if @api_client.config.debugging
@@ -127,12 +136,17 @@ module PostBoost
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'approve_post_request'])
 
       # return_type
       return_type = opts[:debug_return_type] || 'ScheduleResult'
@@ -158,7 +172,7 @@ module PostBoost
     end
 
     # Create post
-    # Create a new post. Use `schedule: true` with `date` and `time` to schedule, `schedule_now: true` to publish immediately, or `queue: true` to add to the smart publishing queue. 
+    # Create a new post. Use `schedule: true` with `date` and `time` to schedule, `schedule_now: true` to publish immediately, or `queue: true` to add to the smart publishing queue (each account gets its own queue slot).  `date`, `time` and `accounts_schedule` are read in `timezone` when given, otherwise in the workspace timezone. Use `accounts_schedule` to give individual accounts their own departure time.  Post bodies may reference mentions with `{{mention:<reference>}}` (see the Mentions endpoints). When the post is scheduled, provider requirements (for example a network that requires media) are validated up front and reported as `422`. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_input [PostInput] 
     # @param [Hash] opts the optional parameters
@@ -169,7 +183,7 @@ module PostBoost
     end
 
     # Create post
-    # Create a new post. Use &#x60;schedule: true&#x60; with &#x60;date&#x60; and &#x60;time&#x60; to schedule, &#x60;schedule_now: true&#x60; to publish immediately, or &#x60;queue: true&#x60; to add to the smart publishing queue. 
+    # Create a new post. Use &#x60;schedule: true&#x60; with &#x60;date&#x60; and &#x60;time&#x60; to schedule, &#x60;schedule_now: true&#x60; to publish immediately, or &#x60;queue: true&#x60; to add to the smart publishing queue (each account gets its own queue slot).  &#x60;date&#x60;, &#x60;time&#x60; and &#x60;accounts_schedule&#x60; are read in &#x60;timezone&#x60; when given, otherwise in the workspace timezone. Use &#x60;accounts_schedule&#x60; to give individual accounts their own departure time.  Post bodies may reference mentions with &#x60;{{mention:&lt;reference&gt;}}&#x60; (see the Mentions endpoints). When the post is scheduled, provider requirements (for example a network that requires media) are validated up front and reported as &#x60;422&#x60;. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_input [PostInput] 
     # @param [Hash] opts the optional parameters
@@ -232,6 +246,7 @@ module PostBoost
     end
 
     # Delete post
+    # Deletes a post. Use `delete_mode` to control whether to also remove the published content from social platforms.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
@@ -243,6 +258,7 @@ module PostBoost
     end
 
     # Delete post
+    # Deletes a post. Use &#x60;delete_mode&#x60; to control whether to also remove the published content from social platforms.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
@@ -380,6 +396,7 @@ module PostBoost
     end
 
     # Get post
+    # Returns a single post with all its versions and associated accounts.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
@@ -390,6 +407,7 @@ module PostBoost
     end
 
     # Get post
+    # Returns a single post with all its versions and associated accounts.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param [Hash] opts the optional parameters
@@ -446,6 +464,75 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Get post analytics
+    # Engagement metrics for a published post across its accounts (also works for trashed posts), with totals, trends and the best-performing account.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param post_uuid [String] UUID of the post.
+    # @param [Hash] opts the optional parameters
+    # @return [PostAnalytics]
+    def get_post_analytics(workspace_uuid, post_uuid, opts = {})
+      data, _status_code, _headers = get_post_analytics_with_http_info(workspace_uuid, post_uuid, opts)
+      data
+    end
+
+    # Get post analytics
+    # Engagement metrics for a published post across its accounts (also works for trashed posts), with totals, trends and the best-performing account.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param post_uuid [String] UUID of the post.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PostAnalytics, Integer, Hash)>] PostAnalytics data, response status code and response headers
+    def get_post_analytics_with_http_info(workspace_uuid, post_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PostsApi.get_post_analytics ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling PostsApi.get_post_analytics"
+      end
+      # verify the required parameter 'post_uuid' is set
+      if @api_client.config.client_side_validation && post_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'post_uuid' when calling PostsApi.get_post_analytics"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/posts/{postUuid}/analytics'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s)).sub('{' + 'postUuid' + '}', CGI.escape(post_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PostAnalytics'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"PostsApi.get_post_analytics",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PostsApi#get_post_analytics\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List posts
     # Returns a paginated list of posts in the workspace.
     # @param workspace_uuid [String] UUID of the workspace.
@@ -512,8 +599,83 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Retry publishing to one account
+    # Re-publishes a post to a single account whose publishing failed. Returns `422` when the account is not on the post, the post is still publishing, or the account did not fail.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param post_uuid [String] UUID of the post.
+    # @param account_uuid [String] UUID of the social media account.
+    # @param [Hash] opts the optional parameters
+    # @return [RetryPostAccountResult]
+    def retry_post_account(workspace_uuid, post_uuid, account_uuid, opts = {})
+      data, _status_code, _headers = retry_post_account_with_http_info(workspace_uuid, post_uuid, account_uuid, opts)
+      data
+    end
+
+    # Retry publishing to one account
+    # Re-publishes a post to a single account whose publishing failed. Returns &#x60;422&#x60; when the account is not on the post, the post is still publishing, or the account did not fail.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param post_uuid [String] UUID of the post.
+    # @param account_uuid [String] UUID of the social media account.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RetryPostAccountResult, Integer, Hash)>] RetryPostAccountResult data, response status code and response headers
+    def retry_post_account_with_http_info(workspace_uuid, post_uuid, account_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: PostsApi.retry_post_account ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling PostsApi.retry_post_account"
+      end
+      # verify the required parameter 'post_uuid' is set
+      if @api_client.config.client_side_validation && post_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'post_uuid' when calling PostsApi.retry_post_account"
+      end
+      # verify the required parameter 'account_uuid' is set
+      if @api_client.config.client_side_validation && account_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'account_uuid' when calling PostsApi.retry_post_account"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/posts/retry/{postUuid}/{accountUuid}'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s)).sub('{' + 'postUuid' + '}', CGI.escape(post_uuid.to_s)).sub('{' + 'accountUuid' + '}', CGI.escape(account_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RetryPostAccountResult'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"PostsApi.retry_post_account",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: PostsApi#retry_post_account\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Schedule post
-    # Schedule an existing post. Set `postNow: true` to publish immediately.
+    # Schedule an existing post. Optionally move it with `date`/`time` (read in `timezone`) and give accounts their own times with `accounts_schedule`. Set `postNow: true` to publish immediately; publishing starts within the request and any per-account times are dropped. Provider requirements are validated and reported as `422`. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param schedule_post_request [SchedulePostRequest] 
@@ -525,7 +687,7 @@ module PostBoost
     end
 
     # Schedule post
-    # Schedule an existing post. Set &#x60;postNow: true&#x60; to publish immediately.
+    # Schedule an existing post. Optionally move it with &#x60;date&#x60;/&#x60;time&#x60; (read in &#x60;timezone&#x60;) and give accounts their own times with &#x60;accounts_schedule&#x60;. Set &#x60;postNow: true&#x60; to publish immediately; publishing starts within the request and any per-account times are dropped. Provider requirements are validated and reported as &#x60;422&#x60;. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param schedule_post_request [SchedulePostRequest] 
@@ -593,6 +755,7 @@ module PostBoost
     end
 
     # Update post
+    # Replaces a post's versions, accounts, tags, and scheduling options. The post must not be in a published state. `timezone` is honoured: `date`, `time` and `accounts_schedule` are read in it. When the post stays scheduled, provider requirements are validated and reported as `422`. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param post_input [PostInput] 
@@ -604,6 +767,7 @@ module PostBoost
     end
 
     # Update post
+    # Replaces a post&#39;s versions, accounts, tags, and scheduling options. The post must not be in a published state. &#x60;timezone&#x60; is honoured: &#x60;date&#x60;, &#x60;time&#x60; and &#x60;accounts_schedule&#x60; are read in it. When the post stays scheduled, provider requirements are validated and reported as &#x60;422&#x60;. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param post_uuid [String] UUID of the post.
     # @param post_input [PostInput] 

data/lib/postboost/api/receipts_api.rb

@@ -1,9 +1,9 @@
 =begin
 #PostBoost API
 
-#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 8+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
+#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 12+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Plan access Every workspace-scoped endpoint returns `403` when the workspace's plan does not include API access (capability `api`).  ## Dates and times Post dates and times (`date`, `time`, `accounts_schedule`) are read in the request's `timezone` when one is given, otherwise in the workspace timezone.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
 
-The version of the OpenAPI document: 1.0.0
+The version of the OpenAPI document: 1.8.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -20,6 +20,7 @@ module PostBoost
       @api_client = api_client
     end
     # Create receipt
+    # Creates a billing receipt record for a workspace. Admin only.
     # @param receipt_input [ReceiptInput] 
     # @param [Hash] opts the optional parameters
     # @return [Receipt]
@@ -29,6 +30,7 @@ module PostBoost
     end
 
     # Create receipt
+    # Creates a billing receipt record for a workspace. Admin only.
     # @param receipt_input [ReceiptInput] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(Receipt, Integer, Hash)>] Receipt data, response status code and response headers
@@ -86,6 +88,7 @@ module PostBoost
     end
 
     # Delete receipt
+    # Permanently deletes a single receipt. Admin only.
     # @param receipt_uuid [String] UUID of the receipt.
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -95,6 +98,7 @@ module PostBoost
     end
 
     # Delete receipt
+    # Permanently deletes a single receipt. Admin only.
     # @param receipt_uuid [String] UUID of the receipt.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -147,6 +151,7 @@ module PostBoost
     end
 
     # Delete receipts (bulk)
+    # Permanently deletes one or more receipt records. Admin only.
     # @param delete_receipts_bulk_request [DeleteReceiptsBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -156,6 +161,7 @@ module PostBoost
     end
 
     # Delete receipts (bulk)
+    # Permanently deletes one or more receipt records. Admin only.
     # @param delete_receipts_bulk_request [DeleteReceiptsBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -213,6 +219,7 @@ module PostBoost
     end
 
     # Get receipt
+    # Returns a single receipt by UUID. Admin only.
     # @param receipt_uuid [String] UUID of the receipt.
     # @param [Hash] opts the optional parameters
     # @return [Receipt]
@@ -222,6 +229,7 @@ module PostBoost
     end
 
     # Get receipt
+    # Returns a single receipt by UUID. Admin only.
     # @param receipt_uuid [String] UUID of the receipt.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Receipt, Integer, Hash)>] Receipt data, response status code and response headers
@@ -274,9 +282,11 @@ module PostBoost
     end
 
     # List receipts
+    # Returns a paginated list of billing receipts. Filter by workspace UUID or invoice number. Admin only.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :workspace_uuid 
     # @option opts [String] :invoice_number 
+    # @option opts [Integer] :page Page number (15 items per page). (default to 1)
     # @return [ListReceipts200Response]
     def list_receipts(opts = {})
       data, _status_code, _headers = list_receipts_with_http_info(opts)
@@ -284,9 +294,11 @@ module PostBoost
     end
 
     # List receipts
+    # Returns a paginated list of billing receipts. Filter by workspace UUID or invoice number. Admin only.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :workspace_uuid 
     # @option opts [String] :invoice_number 
+    # @option opts [Integer] :page Page number (15 items per page). (default to 1)
     # @return [Array<(ListReceipts200Response, Integer, Hash)>] ListReceipts200Response data, response status code and response headers
     def list_receipts_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -299,6 +311,7 @@ module PostBoost
       query_params = opts[:query_params] || {}
       query_params[:'workspace_uuid'] = opts[:'workspace_uuid'] if !opts[:'workspace_uuid'].nil?
       query_params[:'invoice_number'] = opts[:'invoice_number'] if !opts[:'invoice_number'].nil?
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -335,6 +348,7 @@ module PostBoost
     end
 
     # Update receipt
+    # Updates a receipt's transaction details, amount, or payment date. Admin only.
     # @param receipt_uuid [String] UUID of the receipt.
     # @param receipt_update_input [ReceiptUpdateInput] 
     # @param [Hash] opts the optional parameters
@@ -345,6 +359,7 @@ module PostBoost
     end
 
     # Update receipt
+    # Updates a receipt&#39;s transaction details, amount, or payment date. Admin only.
     # @param receipt_uuid [String] UUID of the receipt.
     # @param receipt_update_input [ReceiptUpdateInput] 
     # @param [Hash] opts the optional parameters

data/lib/postboost/api/subscriptions_api.rb

@@ -1,9 +1,9 @@
 =begin
 #PostBoost API
 
-#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 8+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
+#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 12+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Plan access Every workspace-scoped endpoint returns `403` when the workspace's plan does not include API access (capability `api`).  ## Dates and times Post dates and times (`date`, `time`, `accounts_schedule`) are read in the request's `timezone` when one is given, otherwise in the workspace timezone.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
 
-The version of the OpenAPI document: 1.0.0
+The version of the OpenAPI document: 1.8.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -20,6 +20,7 @@ module PostBoost
       @api_client = api_client
     end
     # Add generic subscription
+    # Assigns a non-Stripe (generic) subscription plan to the workspace, optionally granting a trial period. Used for AppSumo-style lifetime deals. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param add_generic_subscription_request [AddGenericSubscriptionRequest] 
     # @param [Hash] opts the optional parameters
@@ -30,6 +31,7 @@ module PostBoost
     end
 
     # Add generic subscription
+    # Assigns a non-Stripe (generic) subscription plan to the workspace, optionally granting a trial period. Used for AppSumo-style lifetime deals. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param add_generic_subscription_request [AddGenericSubscriptionRequest] 
     # @param [Hash] opts the optional parameters
@@ -92,8 +94,10 @@ module PostBoost
     end
 
     # Cancel subscription
+    # Cancels the workspace's Stripe subscription at the end of the current billing period, or right away with `immediately: true`. Works for active and past-due subscriptions. Admin only. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
+    # @option opts [CancelSubscriptionRequest] :cancel_subscription_request 
     # @return [Object]
     def cancel_subscription(workspace_uuid, opts = {})
       data, _status_code, _headers = cancel_subscription_with_http_info(workspace_uuid, opts)
@@ -101,8 +105,10 @@ module PostBoost
     end
 
     # Cancel subscription
+    # Cancels the workspace's Stripe subscription at the end of the current billing period, or right away with `immediately: true`. Works for active and past-due subscriptions. Admin only. 
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
+    # @option opts [CancelSubscriptionRequest] :cancel_subscription_request 
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
     def cancel_subscription_with_http_info(workspace_uuid, opts = {})
       if @api_client.config.debugging
@@ -122,12 +128,17 @@ module PostBoost
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'cancel_subscription_request'])
 
       # return_type
       return_type = opts[:debug_return_type] || 'Object'
@@ -153,6 +164,7 @@ module PostBoost
     end
 
     # Change subscription plan
+    # Switches the workspace to a different Stripe plan. Optionally prorates the change and bills immediately. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param change_subscription_plan_request [ChangeSubscriptionPlanRequest] 
     # @param [Hash] opts the optional parameters
@@ -163,6 +175,7 @@ module PostBoost
     end
 
     # Change subscription plan
+    # Switches the workspace to a different Stripe plan. Optionally prorates the change and bills immediately. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param change_subscription_plan_request [ChangeSubscriptionPlanRequest] 
     # @param [Hash] opts the optional parameters
@@ -299,6 +312,7 @@ module PostBoost
     end
 
     # Create subscription
+    # Manually creates a subscription record for the workspace (for external billing integrations). Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param subscription_input [SubscriptionInput] 
     # @param [Hash] opts the optional parameters
@@ -309,6 +323,7 @@ module PostBoost
     end
 
     # Create subscription
+    # Manually creates a subscription record for the workspace (for external billing integrations). Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param subscription_input [SubscriptionInput] 
     # @param [Hash] opts the optional parameters
@@ -371,6 +386,7 @@ module PostBoost
     end
 
     # Delete subscription
+    # Removes the subscription record from the workspace. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -380,6 +396,7 @@ module PostBoost
     end
 
     # Delete subscription
+    # Removes the subscription record from the workspace. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -432,6 +449,7 @@ module PostBoost
     end
 
     # Get subscription
+    # Returns the active subscription for the workspace, or `null` if none exists. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Subscription]
@@ -441,6 +459,7 @@ module PostBoost
     end
 
     # Get subscription
+    # Returns the active subscription for the workspace, or &#x60;null&#x60; if none exists. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Subscription, Integer, Hash)>] Subscription data, response status code and response headers
@@ -493,6 +512,7 @@ module PostBoost
     end
 
     # Remove generic subscription
+    # Removes the generic (non-Stripe) subscription from the workspace. Returns `422` when the workspace has no generic subscription. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -502,6 +522,7 @@ module PostBoost
     end
 
     # Remove generic subscription
+    # Removes the generic (non-Stripe) subscription from the workspace. Returns &#x60;422&#x60; when the workspace has no generic subscription. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -554,6 +575,7 @@ module PostBoost
     end
 
     # Resume subscription
+    # Resumes a previously canceled subscription before it expires. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -563,6 +585,7 @@ module PostBoost
     end
 
     # Resume subscription
+    # Resumes a previously canceled subscription before it expires. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -615,6 +638,7 @@ module PostBoost
     end
 
     # Update subscription
+    # Updates the plan ID, status, or trial/pause dates of an existing subscription. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param subscription_update_input [SubscriptionUpdateInput] 
     # @param [Hash] opts the optional parameters
@@ -625,6 +649,7 @@ module PostBoost
     end
 
     # Update subscription
+    # Updates the plan ID, status, or trial/pause dates of an existing subscription. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param subscription_update_input [SubscriptionUpdateInput] 
     # @param [Hash] opts the optional parameters