postboost 1.0.0 → 1.8.0

data/spec/api/media_api_spec.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
@@ -47,10 +47,11 @@ describe 'MediaApi' do
 
   # unit tests for complete_chunked_upload
   # Complete chunked upload
-  # Signal that all chunks have been uploaded. Returns the final media object.
+  # Signal that all chunks have been uploaded. Returns the final media object. A video may come back with `is_processing` set to `true` while its conversion runs.
   # @param workspace_uuid UUID of the workspace.
   # @param upload_uuid 
   # @param [Hash] opts the optional parameters
+  # @option opts [CompleteChunkedUploadRequest] :complete_chunked_upload_request 
   # @return [Media]
   describe 'complete_chunked_upload test' do
     it 'should work' do
@@ -58,9 +59,22 @@ describe 'MediaApi' do
     end
   end
 
+  # unit tests for create_media_folder
+  # Create media folder
+  # Creates a folder at the top level or under `parent`. The name must be unique among its siblings.
+  # @param workspace_uuid UUID of the workspace.
+  # @param create_media_folder_request 
+  # @param [Hash] opts the optional parameters
+  # @return [MediaFolder]
+  describe 'create_media_folder test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for delete_media_bulk
   # Delete media (bulk)
-  # Delete one or more media items by their IDs.
+  # Delete one or more media items by their numeric IDs or UUIDs (both may be mixed, up to 500 per request).
   # @param workspace_uuid UUID of the workspace.
   # @param delete_media_bulk_request 
   # @param [Hash] opts the optional parameters
@@ -71,6 +85,20 @@ describe 'MediaApi' do
     end
   end
 
+  # unit tests for delete_media_folder
+  # Delete media folder
+  # Deletes a folder. By default its media and sub-folders move up to the folder's parent; with `delete_media` set to true every media item below the folder is deleted as well.
+  # @param workspace_uuid UUID of the workspace.
+  # @param folder_uuid UUID of the media folder.
+  # @param [Hash] opts the optional parameters
+  # @option opts [DeleteMediaFolderRequest] :delete_media_folder_request 
+  # @return [Object]
+  describe 'delete_media_folder test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for get_media
   # Get media
   # Returns a single media asset.
@@ -103,7 +131,7 @@ describe 'MediaApi' do
   # @param workspace_uuid UUID of the workspace.
   # @param initiate_chunked_upload_request 
   # @param [Hash] opts the optional parameters
-  # @return [InitiateChunkedUpload200Response]
+  # @return [InitiateChunkedUpload201Response]
   describe 'initiate_chunked_upload test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -116,7 +144,7 @@ describe 'MediaApi' do
   # @param workspace_uuid UUID of the workspace.
   # @param initiate_remote_upload_request 
   # @param [Hash] opts the optional parameters
-  # @return [InitiateRemoteUpload200Response]
+  # @return [InitiateRemoteUpload201Response]
   describe 'initiate_remote_upload test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -125,10 +153,18 @@ describe 'MediaApi' do
 
   # unit tests for list_media
   # List media
-  # Returns a paginated list of media assets in the workspace library.
+  # Returns a paginated list of media assets in the workspace library. Without `folder` every item is listed, whatever folder it is filed in. A `keyword` search always looks at the whole library and ignores `folder` and `favorite`. 
   # @param workspace_uuid UUID of the workspace.
   # @param [Hash] opts the optional parameters
-  # @option opts [Integer] :page Page number (20 items per page).
+  # @option opts [Integer] :page Page number.
+  # @option opts [Integer] :limit Items per page. Values below 1 fall back to 50; values above 100 are capped at 100.
+  # @option opts [String] :folder Media folder UUID, or `root` for items not filed in any folder.
+  # @option opts [Array<String>] :mime_types Only these MIME types (for example &#x60;image/png&#x60;).
+  # @option opts [String] :type Only this media type.
+  # @option opts [String] :keyword Search media by name.
+  # @option opts [String] :usage Filter by how the media is used in posts.
+  # @option opts [Boolean] :favorite When &#x60;true&#x60;, only media the caller marked as favorite.
+  # @option opts [String] :sort 
   # @return [ListMedia200Response]
   describe 'list_media test' do
     it 'should work' do
@@ -136,9 +172,21 @@ describe 'MediaApi' do
     end
   end
 
+  # unit tests for list_media_folders
+  # List media folders
+  # Returns the whole folder tree of the media library in one response (not paginated). Rebuild the tree from each folder&#39;s &#x60;parent&#x60;.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [ListMediaFolders200Response]
+  describe 'list_media_folders test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for update_media
   # Update media
-  # Update the alt text of a media asset.
+  # Update the name, alt text, or folder of a media asset. Only the keys present in the body are written. Sending &#x60;folder: null&#x60; moves the item to the library root; omitting &#x60;folder&#x60; leaves it where it is. 
   # @param workspace_uuid UUID of the workspace.
   # @param media_uuid UUID of the media asset.
   # @param update_media_request 
@@ -150,6 +198,20 @@ describe 'MediaApi' do
     end
   end
 
+  # unit tests for update_media_folder
+  # Update media folder
+  # Renames a folder and/or moves it. Sending &#x60;parent&#x60; moves the folder (null &#x3D; top level); omitting it keeps the current parent. A folder cannot be moved into itself or one of its descendants.
+  # @param workspace_uuid UUID of the workspace.
+  # @param folder_uuid UUID of the media folder.
+  # @param media_folder_input 
+  # @param [Hash] opts the optional parameters
+  # @return [MediaFolder]
+  describe 'update_media_folder test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for upload_chunk
   # Upload a chunk
   # Upload a single chunk of a chunked upload session.
@@ -158,7 +220,7 @@ describe 'MediaApi' do
   # @param chunk 
   # @param chunk_index Zero-based index of this chunk.
   # @param [Hash] opts the optional parameters
-  # @return [UploadChunk200Response]
+  # @return [UploadChunk201Response]
   describe 'upload_chunk test' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
@@ -172,6 +234,7 @@ describe 'MediaApi' do
   # @param file The file to upload.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :alt_text Alternative text for accessibility.
+  # @option opts [String] :folder UUID of the media folder to file the upload in. Omit or null for the library root.
   # @return [Media]
   describe 'upload_media test' do
     it 'should work' do

data/spec/api/mentions_api_spec.rb

@@ -0,0 +1,103 @@
+=begin
+#PostBoost API
+
+#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.8.0
+Contact: hi@postboost.co
+Generated by: https://openapi-generator.tech
+Generator version: 7.9.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+
+# Unit tests for PostBoost::MentionsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'MentionsApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::MentionsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of MentionsApi' do
+    it 'should create an instance of MentionsApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::MentionsApi)
+    end
+  end
+
+  # unit tests for create_mention
+  # Create mention
+  # Adds a person or page to the mention book. When one of the submitted identities already belongs to a stored mention, that mention is reused and the identities are added to it (status `200` instead of `201`). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param mention_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateMention201Response]
+  describe 'create_mention test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for delete_mention
+  # Delete mention
+  # Removes a mention from the mention book. `success` is false when nothing was deleted.
+  # @param workspace_uuid UUID of the workspace.
+  # @param mention_id The mention's `id` (a UUID).
+  # @param [Hash] opts the optional parameters
+  # @return [Object]
+  describe 'delete_mention test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for get_mention
+  # Get mention
+  # Returns a single mention with its identities.
+  # @param workspace_uuid UUID of the workspace.
+  # @param mention_id The mention's `id` (a UUID).
+  # @param [Hash] opts the optional parameters
+  # @return [CreateMention201Response]
+  describe 'get_mention test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for list_mentions
+  # List mentions
+  # Returns a paginated list of the workspace's mention book, ranked, with each entry's network identities.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :q Search keyword.
+  # @option opts [Integer] :per_page 
+  # @option opts [Integer] :page 
+  # @return [ListMentions200Response]
+  describe 'list_mentions test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  # unit tests for update_mention
+  # Update mention
+  # Replaces the mention's name, avatar and identities. Identities for providers not in the payload are removed. An identity already held by another mention returns `422`.
+  # @param workspace_uuid UUID of the workspace.
+  # @param mention_id The mention's `id` (a UUID).
+  # @param mention_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateMention201Response]
+  describe 'update_mention test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/spec/api/posts_api_spec.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
@@ -34,10 +34,11 @@ describe 'PostsApi' do
 
   # unit tests for add_post_to_queue
   # 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 UUID of the workspace.
   # @param post_uuid UUID of the post.
   # @param [Hash] opts the optional parameters
+  # @option opts [AddPostToQueueRequest] :add_post_to_queue_request 
   # @return [ScheduleResult]
   describe 'add_post_to_queue test' do
     it 'should work' do
@@ -47,10 +48,11 @@ describe 'PostsApi' do
 
   # unit tests for approve_post
   # 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 UUID of the workspace.
   # @param post_uuid UUID of the post.
   # @param [Hash] opts the optional parameters
+  # @option opts [ApprovePostRequest] :approve_post_request 
   # @return [ScheduleResult]
   describe 'approve_post test' do
     it 'should work' do
@@ -60,7 +62,7 @@ describe 'PostsApi' do
 
   # unit tests for create_post
   # 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 UUID of the workspace.
   # @param post_input 
   # @param [Hash] opts the optional parameters
@@ -73,6 +75,7 @@ describe 'PostsApi' do
 
   # unit tests for delete_post
   # Delete post
+  # Deletes a post. Use `delete_mode` to control whether to also remove the published content from social platforms.
   # @param workspace_uuid UUID of the workspace.
   # @param post_uuid UUID of the post.
   # @param [Hash] opts the optional parameters
@@ -99,6 +102,7 @@ describe 'PostsApi' do
 
   # unit tests for get_post
   # Get post
+  # Returns a single post with all its versions and associated accounts.
   # @param workspace_uuid UUID of the workspace.
   # @param post_uuid UUID of the post.
   # @param [Hash] opts the optional parameters
@@ -109,6 +113,19 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for get_post_analytics
+  # 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 UUID of the workspace.
+  # @param post_uuid UUID of the post.
+  # @param [Hash] opts the optional parameters
+  # @return [PostAnalytics]
+  describe 'get_post_analytics test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for list_posts
   # List posts
   # Returns a paginated list of posts in the workspace.
@@ -122,9 +139,23 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for retry_post_account
+  # 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 UUID of the workspace.
+  # @param post_uuid UUID of the post.
+  # @param account_uuid UUID of the social media account.
+  # @param [Hash] opts the optional parameters
+  # @return [RetryPostAccountResult]
+  describe 'retry_post_account test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for schedule_post
   # 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 UUID of the workspace.
   # @param post_uuid UUID of the post.
   # @param schedule_post_request 
@@ -138,6 +169,7 @@ describe 'PostsApi' do
 
   # unit tests for update_post
   # 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 UUID of the workspace.
   # @param post_uuid UUID of the post.
   # @param post_input 

data/spec/api/receipts_api_spec.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
@@ -34,6 +34,7 @@ describe 'ReceiptsApi' do
 
   # unit tests for create_receipt
   # Create receipt
+  # Creates a billing receipt record for a workspace. Admin only.
   # @param receipt_input 
   # @param [Hash] opts the optional parameters
   # @return [Receipt]
@@ -45,6 +46,7 @@ describe 'ReceiptsApi' do
 
   # unit tests for delete_receipt
   # Delete receipt
+  # Permanently deletes a single receipt. Admin only.
   # @param receipt_uuid UUID of the receipt.
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -56,6 +58,7 @@ describe 'ReceiptsApi' do
 
   # unit tests for delete_receipts_bulk
   # Delete receipts (bulk)
+  # Permanently deletes one or more receipt records. Admin only.
   # @param delete_receipts_bulk_request 
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -67,6 +70,7 @@ describe 'ReceiptsApi' do
 
   # unit tests for get_receipt
   # Get receipt
+  # Returns a single receipt by UUID. Admin only.
   # @param receipt_uuid UUID of the receipt.
   # @param [Hash] opts the optional parameters
   # @return [Receipt]
@@ -78,9 +82,11 @@ describe 'ReceiptsApi' do
 
   # unit tests for list_receipts
   # 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).
   # @return [ListReceipts200Response]
   describe 'list_receipts test' do
     it 'should work' do
@@ -90,6 +96,7 @@ describe 'ReceiptsApi' do
 
   # unit tests for update_receipt
   # Update receipt
+  # Updates a receipt's transaction details, amount, or payment date. Admin only.
   # @param receipt_uuid UUID of the receipt.
   # @param receipt_update_input 
   # @param [Hash] opts the optional parameters

data/spec/api/subscriptions_api_spec.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
@@ -34,6 +34,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for add_generic_subscription
   # 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 UUID of the workspace.
   # @param add_generic_subscription_request 
   # @param [Hash] opts the optional parameters
@@ -46,8 +47,10 @@ describe 'SubscriptionsApi' do
 
   # unit tests for cancel_subscription
   # 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 UUID of the workspace.
   # @param [Hash] opts the optional parameters
+  # @option opts [CancelSubscriptionRequest] :cancel_subscription_request 
   # @return [Object]
   describe 'cancel_subscription test' do
     it 'should work' do
@@ -57,6 +60,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for change_subscription_plan
   # Change subscription plan
+  # Switches the workspace to a different Stripe plan. Optionally prorates the change and bills immediately. Admin only.
   # @param workspace_uuid UUID of the workspace.
   # @param change_subscription_plan_request 
   # @param [Hash] opts the optional parameters
@@ -82,6 +86,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for create_subscription
   # Create subscription
+  # Manually creates a subscription record for the workspace (for external billing integrations). Admin only.
   # @param workspace_uuid UUID of the workspace.
   # @param subscription_input 
   # @param [Hash] opts the optional parameters
@@ -94,6 +99,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for delete_subscription
   # Delete subscription
+  # Removes the subscription record from the workspace. Admin only.
   # @param workspace_uuid UUID of the workspace.
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -105,6 +111,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for get_subscription
   # Get subscription
+  # Returns the active subscription for the workspace, or `null` if none exists. Admin only.
   # @param workspace_uuid UUID of the workspace.
   # @param [Hash] opts the optional parameters
   # @return [Subscription]
@@ -116,6 +123,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for remove_generic_subscription
   # 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 UUID of the workspace.
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -127,6 +135,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for resume_subscription
   # Resume subscription
+  # Resumes a previously canceled subscription before it expires. Admin only.
   # @param workspace_uuid UUID of the workspace.
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -138,6 +147,7 @@ describe 'SubscriptionsApi' do
 
   # unit tests for update_subscription
   # Update subscription
+  # Updates the plan ID, status, or trial/pause dates of an existing subscription. Admin only.
   # @param workspace_uuid UUID of the workspace.
   # @param subscription_update_input 
   # @param [Hash] opts the optional parameters

data/spec/api/tags_api_spec.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
@@ -34,6 +34,7 @@ describe 'TagsApi' do
 
   # unit tests for create_tag
   # Create tag
+  # Creates a new color-coded tag in the workspace for organizing posts.
   # @param workspace_uuid UUID of the workspace.
   # @param tag_input 
   # @param [Hash] opts the optional parameters
@@ -46,6 +47,7 @@ describe 'TagsApi' do
 
   # unit tests for delete_tag
   # Delete tag
+  # Permanently deletes a tag. Posts that had this tag attached are unaffected.
   # @param workspace_uuid UUID of the workspace.
   # @param tag_uuid UUID of the tag.
   # @param [Hash] opts the optional parameters
@@ -58,6 +60,7 @@ describe 'TagsApi' do
 
   # unit tests for get_tag
   # Get tag
+  # Returns a single tag by UUID.
   # @param workspace_uuid UUID of the workspace.
   # @param tag_uuid UUID of the tag.
   # @param [Hash] opts the optional parameters
@@ -70,6 +73,7 @@ describe 'TagsApi' do
 
   # unit tests for list_tags
   # List tags
+  # Returns all tags defined in the workspace.
   # @param workspace_uuid UUID of the workspace.
   # @param [Hash] opts the optional parameters
   # @return [ListTags200Response]
@@ -81,6 +85,7 @@ describe 'TagsApi' do
 
   # unit tests for update_tag
   # Update tag
+  # Updates a tag's name or color.
   # @param workspace_uuid UUID of the workspace.
   # @param tag_uuid UUID of the tag.
   # @param tag_input 

data/spec/api/users_api_spec.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
@@ -34,6 +34,7 @@ describe 'UsersApi' do
 
   # unit tests for create_user
   # Create user
+  # Creates a new user account on the platform. Admin only.
   # @param user_input 
   # @param [Hash] opts the optional parameters
   # @return [User]
@@ -45,6 +46,7 @@ describe 'UsersApi' do
 
   # unit tests for delete_user
   # Delete user
+  # Permanently deletes a user account. Returns 400 if you attempt to delete your own account. Admin only.
   # @param user_id ID of the user.
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -56,6 +58,7 @@ describe 'UsersApi' do
 
   # unit tests for delete_users_bulk
   # Delete users (bulk)
+  # Permanently deletes one or more user accounts. You cannot delete your own account. Admin only.
   # @param delete_users_bulk_request 
   # @param [Hash] opts the optional parameters
   # @return [Object]
@@ -67,6 +70,7 @@ describe 'UsersApi' do
 
   # unit tests for get_user
   # Get user
+  # Returns a single user account by ID. Admin only.
   # @param user_id ID of the user.
   # @param [Hash] opts the optional parameters
   # @return [User]
@@ -78,8 +82,10 @@ describe 'UsersApi' do
 
   # unit tests for list_users
   # List users
+  # Returns a paginated list of all users on the platform. Optionally filter by name or email. Admin only.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :keyword Search by name or email.
+  # @option opts [Integer] :page Page number (15 items per page).
   # @return [ListUsers200Response]
   describe 'list_users test' do
     it 'should work' do
@@ -89,6 +95,7 @@ describe 'UsersApi' do
 
   # unit tests for update_user
   # Update user
+  # Updates a user's name, email, admin status, or password. Admin only.
   # @param user_id ID of the user.
   # @param user_update_input 
   # @param [Hash] opts the optional parameters