postboost 1.0.0 → 1.14.0

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.  ## Idempotent requests Send an `Idempotency-Key` header (any unique string, for example a UUID) with a `POST`. Repeating the request with the same key within 24 hours returns the stored response with `Idempotent-Replayed: true` and creates nothing new. Reusing a key with a different body returns `422`; a request still in progress with the same key returns `409`. `5xx` and `429` responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns `409` (`code: duplicate_post`, override with `allow_duplicate: true`), scheduling past an account's daily cap returns `429` (`code: account_daily_cap_reached`), and scheduling to an account that must be reconnected returns `422` (`code: account_unauthorized` or `account_token_missing`). Use `POST /{workspaceUuid}/posts/validate` for a dry run and `GET /{workspaceUuid}/activity` to review what API clients did.  ## 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.14.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -34,10 +34,12 @@ 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 [String] :idempotency_key Unique key (for example a UUID) that makes the request safe to retry. A repeat with the same key and body within 24 hours returns the stored response with `Idempotent-Replayed: true` and has no further effect. Keys are scoped to your user, the workspace, the method and the path. 
+  # @option opts [AddPostToQueueRequest] :add_post_to_queue_request 
   # @return [ScheduleResult]
   describe 'add_post_to_queue test' do
     it 'should work' do
@@ -47,10 +49,12 @@ 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 [String] :idempotency_key Unique key (for example a UUID) that makes the request safe to retry. A repeat with the same key and body within 24 hours returns the stored response with `Idempotent-Replayed: true` and has no further effect. Keys are scoped to your user, the workspace, the method and the path. 
+  # @option opts [ApprovePostRequest] :approve_post_request 
   # @return [ScheduleResult]
   describe 'approve_post test' do
     it 'should work' do
@@ -60,10 +64,11 @@ 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`.  **First comment and threads.** A version's `content` is an ordered array. Item 0 is the post. Add a second item to publish a first comment on Facebook Page, Instagram and LinkedIn, or to continue a thread on X, Threads, Bluesky, Mastodon and Pixelfed:  ```json {   \"accounts\": [12],   \"schedule_now\": true,   \"versions\": [{     \"account_id\": 0,     \"is_original\": true,     \"content\": [       { \"body\": \"Our API 1.8 is live.\", \"media\": [345] },       { \"body\": \"Full changelog: https://postboost.co/docs/changelog/\" }     ]   }] } ```  The comment is posted right after the post goes live. If the comment fails, the post stays published and the account's entry on the post reports the error. 
   # @param workspace_uuid UUID of the workspace.
   # @param post_input 
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Unique key (for example a UUID) that makes the request safe to retry. A repeat with the same key and body within 24 hours returns the stored response with `Idempotent-Replayed: true` and has no further effect. Keys are scoped to your user, the workspace, the method and the path. 
   # @return [Post]
   describe 'create_post test' do
     it 'should work' do
@@ -71,8 +76,35 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for create_recycling_rule
+  # Create a recycling rule
+  # Recycles one post (`post_uuid`) or a tag pool (`type: tag_pool` + `tag_uuid`) every `interval_days`. The first run is `start_at`, or one interval from now. Copies are never published immediately: `placement: queue` (default) takes each account's next free queue slot, `same_time` schedules at the source post's time of day, `draft` leaves a draft.  Copies pass the same guardrails as posts created through the API (duplicate guard, per-account daily caps, disconnected accounts, X monthly allowance). A refused copy is not created; the run is logged with the guard's code (see the runs endpoint). X accounts are left out of copies because X rejects repeated text. Admins and members only. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param recycling_rule_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRecyclingRule201Response]
+  describe 'create_recycling_rule 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 create_rss_feed
+  # Add an RSS feed
+  # Checks the feed every 30 minutes and turns each item published after the feed was added into a post for `account_ids`: a draft (`mode: draft`, default) or a queued post (`mode: queue`). The text comes from `template` with `{title}`, `{link}` and `{summary}` placeholders. Each item becomes at most one post, at most `max_items_per_run` per check and 20 per workspace per day. Posts pass the same guardrails as API-created posts. Only public http(s) URLs are accepted. Admins and members only. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param rss_feed_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRssFeed201Response]
+  describe 'create_rss_feed 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_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
@@ -97,8 +129,35 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for delete_recycling_rule
+  # Delete a recycling rule
+  # Deletes the rule and its run log. Copies it already created stay. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param rule_uuid UUID of the recycling rule.
+  # @param [Hash] opts the optional parameters
+  # @return [Object]
+  describe 'delete_recycling_rule 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_rss_feed
+  # Delete an RSS feed
+  # Stops the feed. Posts it already created stay. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param feed_uuid UUID of the RSS feed.
+  # @param [Hash] opts the optional parameters
+  # @return [Object]
+  describe 'delete_rss_feed 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_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 +168,43 @@ 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 get_recycling_rule
+  # Get a recycling rule
+  # @param workspace_uuid UUID of the workspace.
+  # @param rule_uuid UUID of the recycling rule.
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRecyclingRule201Response]
+  describe 'get_recycling_rule 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_rss_feed
+  # Get an RSS feed
+  # @param workspace_uuid UUID of the workspace.
+  # @param feed_uuid UUID of the RSS feed.
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRssFeed201Response]
+  describe 'get_rss_feed 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,13 +218,93 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for list_recycling_rules
+  # List recycling rules
+  # Evergreen recycling rules of the workspace, newest first. A rule copies a post (or the least recently recycled published post with a tag) every `interval_days` and places the copy in the queue. Copies are ordinary posts: they show in the calendar and the queue. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [ListRecyclingRules200Response]
+  describe 'list_recycling_rules 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_recycling_runs
+  # List a recycling rule's runs
+  # The latest 100 runs of the rule, newest first: the copy each run created, or why it skipped (`source_unavailable`, `no_eligible_post`, `no_accounts`, `queue_full`, `x_skipped_identical_text`, or a guardrail code such as `duplicate_post` or `account_daily_cap_reached`). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param rule_uuid UUID of the recycling rule.
+  # @param [Hash] opts the optional parameters
+  # @return [ListRecyclingRuns200Response]
+  describe 'list_recycling_runs 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_rss_feeds
+  # List RSS feeds
+  # RSS and Atom feeds whose new items become posts, newest first.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [ListRssFeeds200Response]
+  describe 'list_rss_feeds 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 poll_rss_feed
+  # Check an RSS feed now
+  # Reads the feed immediately instead of waiting for the next check. Limited to 6 calls per minute. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param feed_uuid UUID of the RSS feed.
+  # @param [Hash] opts the optional parameters
+  # @return [PollRssFeed200Response]
+  describe 'poll_rss_feed 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 recycle_post
+  # Recycle a post on an interval
+  # Shortcut for creating a `post` recycling rule for this post. Same body as `createRecyclingRule` without `type`, `post_uuid` and `tag_uuid`. Admins and members only. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param post_uuid UUID of the post.
+  # @param recycling_rule_settings 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRecyclingRule201Response]
+  describe 'recycle_post 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 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
+  # @option opts [String] :idempotency_key Unique key (for example a UUID) that makes the request safe to retry. A repeat with the same key and body within 24 hours returns the stored response with `Idempotent-Replayed: true` and has no further effect. Keys are scoped to your user, the workspace, the method and the path. 
+  # @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 
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :idempotency_key Unique key (for example a UUID) that makes the request safe to retry. A repeat with the same key and body within 24 hours returns the stored response with `Idempotent-Replayed: true` and has no further effect. Keys are scoped to your user, the workspace, the method and the path. 
   # @return [ScheduleResult]
   describe 'schedule_post test' do
     it 'should work' do
@@ -138,6 +314,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 
@@ -149,4 +326,45 @@ describe 'PostsApi' do
     end
   end
 
+  # unit tests for update_recycling_rule
+  # Update, pause or resume a recycling rule
+  # Changes the interval, limit, placement or accounts, or pauses (`active: false`) and resumes the rule. Fields you leave out keep their value. A rule that reached `max_runs` resumes only with a higher `max_runs`. Admins and members only. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param rule_uuid UUID of the recycling rule.
+  # @param recycling_rule_update 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRecyclingRule201Response]
+  describe 'update_recycling_rule 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_rss_feed
+  # Update, pause or resume an RSS feed
+  # Fields you leave out keep their value. Resuming (`active: true`) clears the error backoff. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param feed_uuid UUID of the RSS feed.
+  # @param rss_feed_update 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateRssFeed201Response]
+  describe 'update_rss_feed 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 validate_post
+  # Validate post (dry run)
+  # Runs everything create-post checks without creating anything: request validation, network requirements (text length, media count and type, links) for every given account, whether or not the post is scheduled, and the guardrails (duplicate content, daily caps, account health). Always answers `200`; read `valid`. Any workspace member, including viewers, may call it. Recommended agent loop: account health, validate, then create. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param post_input 
+  # @param [Hash] opts the optional parameters
+  # @return [PreflightResult]
+  describe 'validate_post 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/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.  ## Idempotent requests Send an `Idempotency-Key` header (any unique string, for example a UUID) with a `POST`. Repeating the request with the same key within 24 hours returns the stored response with `Idempotent-Replayed: true` and creates nothing new. Reusing a key with a different body returns `422`; a request still in progress with the same key returns `409`. `5xx` and `429` responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns `409` (`code: duplicate_post`, override with `allow_duplicate: true`), scheduling past an account's daily cap returns `429` (`code: account_daily_cap_reached`), and scheduling to an account that must be reconnected returns `422` (`code: account_unauthorized` or `account_token_missing`). Use `POST /{workspaceUuid}/posts/validate` for a dry run and `GET /{workspaceUuid}/activity` to review what API clients did.  ## 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.14.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.  ## Idempotent requests Send an `Idempotency-Key` header (any unique string, for example a UUID) with a `POST`. Repeating the request with the same key within 24 hours returns the stored response with `Idempotent-Replayed: true` and creates nothing new. Reusing a key with a different body returns `422`; a request still in progress with the same key returns `409`. `5xx` and `429` responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns `409` (`code: duplicate_post`, override with `allow_duplicate: true`), scheduling past an account's daily cap returns `429` (`code: account_daily_cap_reached`), and scheduling to an account that must be reconnected returns `422` (`code: account_unauthorized` or `account_token_missing`). Use `POST /{workspaceUuid}/posts/validate` for a dry run and `GET /{workspaceUuid}/activity` to review what API clients did.  ## 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.14.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.  ## Idempotent requests Send an `Idempotency-Key` header (any unique string, for example a UUID) with a `POST`. Repeating the request with the same key within 24 hours returns the stored response with `Idempotent-Replayed: true` and creates nothing new. Reusing a key with a different body returns `422`; a request still in progress with the same key returns `409`. `5xx` and `429` responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns `409` (`code: duplicate_post`, override with `allow_duplicate: true`), scheduling past an account's daily cap returns `429` (`code: account_daily_cap_reached`), and scheduling to an account that must be reconnected returns `422` (`code: account_unauthorized` or `account_token_missing`). Use `POST /{workspaceUuid}/posts/validate` for a dry run and `GET /{workspaceUuid}/activity` to review what API clients did.  ## 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.14.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -34,9 +34,11 @@ 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
+  # @option opts [String] :idempotency_key Unique key (for example a UUID) that makes the request safe to retry. A repeat with the same key and body within 24 hours returns the stored response with `Idempotent-Replayed: true` and has no further effect. Keys are scoped to your user, the workspace, the method and the path. 
   # @return [Tag]
   describe 'create_tag test' do
     it 'should work' do
@@ -46,6 +48,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 +61,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 +74,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 +86,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/templates_api_spec.rb

@@ -0,0 +1,102 @@
+=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.  ## Idempotent requests Send an `Idempotency-Key` header (any unique string, for example a UUID) with a `POST`. Repeating the request with the same key within 24 hours returns the stored response with `Idempotent-Replayed: true` and creates nothing new. Reusing a key with a different body returns `422`; a request still in progress with the same key returns `409`. `5xx` and `429` responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns `409` (`code: duplicate_post`, override with `allow_duplicate: true`), scheduling past an account's daily cap returns `429` (`code: account_daily_cap_reached`), and scheduling to an account that must be reconnected returns `422` (`code: account_unauthorized` or `account_token_missing`). Use `POST /{workspaceUuid}/posts/validate` for a dry run and `GET /{workspaceUuid}/activity` to review what API clients did.  ## 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.14.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::TemplatesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'TemplatesApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::TemplatesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of TemplatesApi' do
+    it 'should create an instance of TemplatesApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::TemplatesApi)
+    end
+  end
+
+  # unit tests for create_template
+  # Create a template
+  # Creates a post template: a name and one or more content items (body plus media ids from the media library). Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param template_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateTemplate201Response]
+  describe 'create_template 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_template
+  # Delete a template
+  # Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param template_id The template `id`.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_template 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_template
+  # Get a template
+  # One template. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param template_id The template `id`.
+  # @param [Hash] opts the optional parameters
+  # @return [CreateTemplate201Response]
+  describe 'get_template 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_templates
+  # List templates
+  # Post templates of the workspace, newest first. The same templates as the Templates page in the app. Paginated with `page` and `per_page` (default 100). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :page Page number (1-based).
+  # @option opts [Integer] :per_page Items per page, 1-100.
+  # @return [ListTemplates200Response]
+  describe 'list_templates 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_template
+  # Update a template
+  # Replaces the name and content of a template. Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param template_id The template `id`.
+  # @param template_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateTemplate201Response]
+  describe 'update_template test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end