postboost 1.8.0 → 1.14.0

data/spec/api/agents_api_spec.rb

@@ -0,0 +1,170 @@
+=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::AgentsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'AgentsApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::AgentsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of AgentsApi' do
+    it 'should create an instance of AgentsApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::AgentsApi)
+    end
+  end
+
+  # unit tests for approve_agent_proposal
+  # Approve and apply an agent proposal
+  # Applies the proposal at once: `hold_post` moves the post back to draft, `edit_caption` replaces the caption. When the post was edited, deleted or left the schedule since the proposal was made, nothing changes and the proposal becomes `stale`. Admins and members only. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param proposal_uuid 
+  # @param [Hash] opts the optional parameters
+  # @option opts [AgentProposalDecision] :agent_proposal_decision 
+  # @return [ApproveAgentProposal200Response]
+  describe 'approve_agent_proposal 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_agent
+  # Switch on a background agent
+  # Creates an agent (one per type per workspace). It first runs within five minutes, then on its `schedule`. **Pre-publish checker** looks at posts scheduled in the next `horizon_hours` and proposes holding (back to draft) posts that would fail: disconnected accounts, network requirements, daily caps, the X allowance and links that answer an error. It proposes caption edits that drop `banned_phrases`. With `ai_review: true` it also asks AI to review up to `max_ai_reviews_per_run` posts per run (one AI credit each). Admins and members only. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param workspace_agent_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateAgent201Response]
+  describe 'create_agent 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_agent
+  # Delete a background agent
+  # Removes the agent. Its run history and proposals stay. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param agent_uuid 
+  # @param [Hash] opts the optional parameters
+  # @return [DeleteAgent200Response]
+  describe 'delete_agent 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_agent_run
+  # Get an agent run with its proposals
+  # @param workspace_uuid UUID of the workspace.
+  # @param run_uuid 
+  # @param [Hash] opts the optional parameters
+  # @return [RunAgent202Response]
+  describe 'get_agent_run 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_agent_proposals
+  # List agent proposals (approval queue)
+  # Proposals of all agents in the workspace, newest first. Defaults to `pending`.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :status 
+  # @option opts [Integer] :per_page 
+  # @option opts [Integer] :page 
+  # @return [ListAgentProposals200Response]
+  describe 'list_agent_proposals 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_agent_runs
+  # Run history of an agent
+  # Runs of the agent, newest first, with what each checked and proposed and the AI credits it used.
+  # @param workspace_uuid UUID of the workspace.
+  # @param agent_uuid 
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :per_page 
+  # @option opts [Integer] :page 
+  # @return [ListAgentRuns200Response]
+  describe 'list_agent_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_agents
+  # List background agents
+  # Background agents switched on for the workspace. Agents run on a schedule, record every run and never change a post themselves: each change is a proposal that a workspace admin or member approves. Available type: `pre_publish_checker`. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [ListAgents200Response]
+  describe 'list_agents 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 reject_agent_proposal
+  # Reject an agent proposal
+  # Records the rejection (and optional note); nothing changes on the post. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param proposal_uuid 
+  # @param [Hash] opts the optional parameters
+  # @option opts [AgentProposalDecision] :agent_proposal_decision 
+  # @return [ApproveAgentProposal200Response]
+  describe 'reject_agent_proposal 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 run_agent
+  # Run a background agent now
+  # Queues a run outside the schedule (`trigger: manual`). Six per hour. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param agent_uuid 
+  # @param [Hash] opts the optional parameters
+  # @return [RunAgent202Response]
+  describe 'run_agent 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_agent
+  # Update a background agent
+  # Changes the name, schedule, settings or `enabled`. Settings you leave out keep their value. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param agent_uuid 
+  # @param workspace_agent_update 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateAgent201Response]
+  describe 'update_agent 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/ai_api_spec.rb

@@ -1,9 +1,9 @@
 =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 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.8.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
@@ -45,6 +45,42 @@ describe 'AIApi' do
     end
   end
 
+  # unit tests for delete_brand_voice
+  # Delete the brand voice
+  # Removes the workspace's brand voice. AI endpoints then run without one. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [Object]
+  describe 'delete_brand_voice 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_ai_usage
+  # AI credit usage
+  # The workspace's AI credits: text credits (captions, rewrites, outlines, alt text; counted per billing cycle) and image credits (one per generated, edited or varied image, and one per repurpose carousel; counted per calendar month, UTC). `limit` and `remaining` are `null` when the workspace has no limit. Readable when credits are used up; costs nothing.  When image credits run out, the image endpoints and carousels answer `429` with `code: image_credits_exhausted`; when text credits run out, the AI endpoints answer `429` with `code: ai_credits_exhausted`. Image endpoint responses also carry `image_credits_used` and `image_credits_remaining`; their `credits_used` counts text credits only. If the image pool is switched off (`image.enabled: false`), images cost text credits as before. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [AIUsage]
+  describe 'get_ai_usage 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_brand_voice
+  # Get the brand voice
+  # The workspace's brand voice: identity, audience, tone sliders, style rules and example posts. It is the same profile as the Brand Voice page in the app (one per workspace). `data` is `null` when no voice is set. Any workspace member may read it; reading costs no AI credits.  The AI endpoints apply it automatically: `blog-to-social` adds it to the caption instructions, `image-prompt` and `image-generate` turn it into a short visual tone line, and `image-edit` applies it when you send `use_brand_voice: true`. `image-variations` and `image-alt-text` never use it (alt text must describe the image literally). Send `use_brand_voice: false` to skip it on a call; responses report `meta.brand_voice_applied`. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [GetBrandVoice200Response]
+  describe 'get_brand_voice 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 image_alt_text
   # Generate alt text for a media image using AI
   # Analyzes an existing workspace media item and generates accessible alt text. The alt text is saved back to the media record. Costs 1 AI credit per call. 
@@ -110,4 +146,44 @@ describe 'AIApi' do
     end
   end
 
+  # unit tests for learn_brand_voice
+  # Learn a brand voice from past posts
+  # Reads the workspace's latest published posts (original text) and proposes a brand voice in the same shape as `GET /brand-voice`. Returns a draft and saves nothing unless `apply: true`.  Without `overwrite`, learned values only fill fields that are empty (tone sliders and styles still at their defaults count as empty); with `overwrite: true` they replace them. The first five sampled posts become `example_posts`. Needs at least 3 published posts (`422`, `code: not_enough_posts`). Costs one AI text credit per AI call (one retry when the reply is not usable). Admins and members only. A key limited to some accounts must send `account_ids`; only posts whose accounts are all among them are read. `apply` also needs the `write` ability. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @option opts [LearnBrandVoiceInput] :learn_brand_voice_input 
+  # @return [LearnBrandVoiceResponse]
+  describe 'learn_brand_voice 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 repurpose_content
+  # Repurpose long-form content into a draft post set with a carousel
+  # Turns an article URL, a YouTube video, a PDF or pasted text into one **draft** post with a caption for every target account, plus a carousel of rendered slide images (hook, 1 to 6 idea slides, call to action; 1080×1350 PNG). Nothing is published or scheduled.  **Sources** (`source_type`): - `url`: the article is fetched and its main text extracted. - `youtube`: title, description and chapters come from YouTube; send the transcript in   `transcript` for better results (required when the description is short). - `pdf`: `pdf_url` must be a public PDF of at most 20 MB; the first 30 pages are read. - `text`: send `title` and `text`.  **Carousel per network**: Instagram, Facebook, Threads up to 10 slides; LinkedIn up to 9; X and Bluesky up to 4; other networks get the cover slide; YouTube and TikTok get none (listed in `warnings`). Without a carousel, the source image (article image or video thumbnail) is attached when available.  **AI credits**: one per target account plus one for the carousel outline. Slides are drawn without AI and cost nothing. The workspace brand voice applies unless `use_brand_voice` is `false`. Send an `Idempotency-Key` so a retried call does not create a second draft. Limited to 10 calls per minute. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param repurpose_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 [RepurposeContent200Response]
+  describe 'repurpose_content 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_brand_voice
+  # Create or update the brand voice
+  # Creates the workspace's brand voice or updates it. Fields you leave out keep their current value. Admins and members only (not viewers); the workspace must have AI enabled. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param brand_voice_input 
+  # @param [Hash] opts the optional parameters
+  # @return [GetBrandVoice200Response]
+  describe 'update_brand_voice 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/analytics_api_spec.rb

@@ -1,9 +1,9 @@
 =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 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.8.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
@@ -32,6 +32,32 @@ describe 'AnalyticsApi' do
     end
   end
 
+  # unit tests for create_report_export
+  # Create a report export
+  # Generates a report for a period (default `last_month`) or a custom `date_from`/`date_to` range: a branded PDF (summary, accounts, top 10 posts; the header uses the report branding) or a CSV with one row per published post and account (`dataset: posts`, default) or per account (`dataset: accounts`). CSV files are UTF-8 with a byte order mark. At most 500 posts per report. The file is ready when the call returns; fetch it from `download_url` with the same token. Admins and members only; 20 per minute. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param report_export_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateReportExport201Response]
+  describe 'create_report_export 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 download_report_export
+  # Download a report file
+  # The PDF or CSV file. `410` once it expired (7 days) or if the export failed.
+  # @param workspace_uuid UUID of the workspace.
+  # @param export_uuid UUID of the report export.
+  # @param [Hash] opts the optional parameters
+  # @return [File]
+  describe 'download_report_export 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_account_analytics
   # Get account analytics
   # Analytics for one account. `type` selects one of the tabs the account supports (listed in `tabs` of the response); returns `422` when the account does not support analytics.
@@ -110,4 +136,66 @@ describe 'AnalyticsApi' do
     end
   end
 
+  # unit tests for get_report_branding
+  # Get the report branding
+  # The white-label header of the workspace's PDF reports. Unset fields are `null`; the workspace name is used then.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [GetReportBranding200Response]
+  describe 'get_report_branding 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_report_export
+  # Get a report export
+  # @param workspace_uuid UUID of the workspace.
+  # @param export_uuid UUID of the report export.
+  # @param [Hash] opts the optional parameters
+  # @return [CreateReportExport201Response]
+  describe 'get_report_export 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_report_exports
+  # List report exports
+  # The workspace's latest 50 report exports, newest first. Files can be downloaded for 7 days.
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [ListReportExports200Response]
+  describe 'list_report_exports 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_report_branding
+  # Update the report branding
+  # Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo`. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param report_branding_input 
+  # @param [Hash] opts the optional parameters
+  # @return [GetReportBranding200Response]
+  describe 'update_report_branding 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_report_branding_logo
+  # Upload the report logo
+  # PNG or JPEG, up to 1 MB (SVG is not accepted). Replaces the current logo. Admins and members only.
+  # @param workspace_uuid UUID of the workspace.
+  # @param logo 
+  # @param [Hash] opts the optional parameters
+  # @return [GetReportBranding200Response]
+  describe 'upload_report_branding_logo 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/competitors_api_spec.rb

@@ -0,0 +1,87 @@
+=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::CompetitorsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'CompetitorsApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::CompetitorsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of CompetitorsApi' do
+    it 'should create an instance of CompetitorsApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::CompetitorsApi)
+    end
+  end
+
+  # unit tests for add_competitor
+  # Track a competitor
+  # Starts tracking a public Instagram business or creator account from one of your Instagram accounts (connected through a Facebook Page). Returns `202` at once; followers, snapshots and recent media appear after the background import. `409` if that account already tracks the username. Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param competitor_input 
+  # @param [Hash] opts the optional parameters
+  # @return [AddCompetitor202Response]
+  describe 'add_competitor 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_competitor
+  # Stop tracking a competitor
+  # Deletes the competitor with its snapshots and media. Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param competitor_id The competitor `id`.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_competitor 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_competitor
+  # Get a competitor
+  # The competitor with daily follower snapshots for the last 90 days and its 12 most recent posts. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param competitor_id The competitor `id`.
+  # @param [Hash] opts the optional parameters
+  # @return [GetCompetitor200Response]
+  describe 'get_competitor 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_competitors
+  # List competitors
+  # Instagram business or creator accounts the workspace tracks, by follower count. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @option opts [Integer] :account_id Only competitors tracked from this Instagram account `id`.
+  # @return [ListCompetitors200Response]
+  describe 'list_competitors 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/hashtag_groups_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::HashtagGroupsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'HashtagGroupsApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::HashtagGroupsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of HashtagGroupsApi' do
+    it 'should create an instance of HashtagGroupsApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::HashtagGroupsApi)
+    end
+  end
+
+  # unit tests for create_hashtag_group
+  # Create a hashtag group
+  # Saves a named set of hashtags (up to 3000 characters). Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param hashtag_group_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateHashtagGroup201Response]
+  describe 'create_hashtag_group 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_hashtag_group
+  # Delete a hashtag group
+  # Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param hashtag_group_id The hashtag group `id`.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_hashtag_group 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_hashtag_group
+  # Get a hashtag group
+  # One hashtag group. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param hashtag_group_id The hashtag group `id`.
+  # @param [Hash] opts the optional parameters
+  # @return [CreateHashtagGroup201Response]
+  describe 'get_hashtag_group 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_hashtag_groups
+  # List hashtag groups
+  # Saved hashtag sets of the workspace, newest first. 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 [ListHashtagGroups200Response]
+  describe 'list_hashtag_groups 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_hashtag_group
+  # Update a hashtag group
+  # Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param hashtag_group_id The hashtag group `id`.
+  # @param hashtag_group_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateHashtagGroup201Response]
+  describe 'update_hashtag_group test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end