postboost 1.0.0 → 1.14.0

data/spec/api/account_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::AccountGroupsApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'AccountGroupsApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::AccountGroupsApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of AccountGroupsApi' do
+    it 'should create an instance of AccountGroupsApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::AccountGroupsApi)
+    end
+  end
+
+  # unit tests for create_account_group
+  # Create an account group
+  # Creates a named set of accounts of this workspace. Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param account_group_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateAccountGroup201Response]
+  describe 'create_account_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_account_group
+  # Delete an account group
+  # Deletes the group, not its accounts. Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param account_group_uuid The account group `uuid`.
+  # @param [Hash] opts the optional parameters
+  # @return [nil]
+  describe 'delete_account_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_account_group
+  # Get an account group
+  # One account group. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param account_group_uuid The account group `uuid`.
+  # @param [Hash] opts the optional parameters
+  # @return [CreateAccountGroup201Response]
+  describe 'get_account_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_account_groups
+  # List account groups
+  # Named sets of accounts, sorted by name, with their account ids. Pass `account_ids` as `accounts` when you create a post to publish to the whole group. Paginated with `page` and `per_page` (default 100). A key limited to some accounts only sees groups whose accounts are all among its accounts, and `meta.total` counts only those. 
+  # @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 [ListAccountGroups200Response]
+  describe 'list_account_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_account_group
+  # Update an account group
+  # Replaces the name and the accounts of the group (accounts you leave out are removed). Admins and members only (not viewers). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param account_group_uuid The account group `uuid`.
+  # @param account_group_input 
+  # @param [Hash] opts the optional parameters
+  # @return [CreateAccountGroup201Response]
+  describe 'update_account_group 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/accounts_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
@@ -32,6 +32,33 @@ describe 'AccountsApi' do
     end
   end
 
+  # unit tests for connect_channel
+  # Connect a Telegram, Discord or Slack channel
+  # Connects a channel that uses a bot token or a webhook URL instead of a login. The credentials are checked against the network first, stored encrypted and never returned. Connecting the same channel again updates it (`200`) instead of adding a second account. Workspace admins only; counts toward the plan's social account limit.  - **telegram**: `bot_token` from @BotFather and `chat` (the channel's `@username`, or its   numeric id such as `-1001234567890` for a private channel). The bot must be an administrator   of the channel allowed to post messages. - **discord**: `webhook_url` from Channel settings → Integrations → Webhooks   (`https://discord.com/api/webhooks/…`). - **slack**: `webhook_url` of an incoming webhook (`https://hooks.slack.com/services/…`) and an   optional display `name`. Slack posts cannot be deleted from PostBoost, and images must be   publicly reachable.  Webhook URLs on any other host are refused (`422`) before any request is made. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param provider 
+  # @param connect_channel_input 
+  # @param [Hash] opts the optional parameters
+  # @return [ChannelAccount]
+  describe 'connect_channel 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_reconnect_link
+  # Create a reconnect link
+  # Creates a single-use link (valid 7 days) that lets someone without a PostBoost login, such as an agency's client, re-authorize this one account on its network. The link only refreshes the connection of this account; signing in as a different profile or page changes nothing. Workspace admins only. Available for Facebook Pages, Instagram, Threads, LinkedIn, TikTok, YouTube and Pinterest. Returns `404` while the feature is not enabled on this instance. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param account_uuid UUID of the social media account.
+  # @param [Hash] opts the optional parameters
+  # @return [ReconnectLink]
+  describe 'create_reconnect_link 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
   # Get account
   # Returns a single social media account.
@@ -45,11 +72,27 @@ describe 'AccountsApi' do
     end
   end
 
+  # unit tests for get_account_health
+  # Account health
+  # Pre-flight health of every account in the workspace: whether it is authorized and holds an access token, how much of its daily post cap (per UTC day, scheduled, awaiting approval and published posts) is used today, and its connection health: predicted token expiry, latest publish outcome and where to reconnect it. The `account.token_expiring` and `account.disconnected` webhooks report changes as they happen. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @return [GetAccountHealth200Response]
+  describe 'get_account_health 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_accounts
   # List accounts
-  # Returns all social media accounts connected to the workspace.
+  # Returns all social media accounts connected to the workspace, newest first. Optional filters narrow the list.
   # @param workspace_uuid UUID of the workspace.
   # @param [Hash] opts the optional parameters
+  # @option opts [String] :keyword Match the account name or username.
+  # @option opts [String] :group Only accounts in this account group.
+  # @option opts [Array<String>] :providers Only accounts of these providers (for example &#x60;instagram&#x60;, &#x60;linkedin&#x60;).
+  # @option opts [Boolean] :unauthorized When &#x60;true&#x60;, only accounts that need to be reconnected.
   # @return [ListAccounts200Response]
   describe 'list_accounts test' do
     it 'should work' do

data/spec/api/activity_api_spec.rb

@@ -0,0 +1,51 @@
+=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::ActivityApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ActivityApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::ActivityApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ActivityApi' do
+    it 'should create an instance of ActivityApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::ActivityApi)
+    end
+  end
+
+  # unit tests for list_api_activity
+  # List API activity
+  # Every write request (`POST`, `PUT`, `DELETE`) made through the API in this workspace, newest first, with the client that made it and its outcome. Kept for 90 days. Send an `X-PostBoost-Client` header (for example `my-agent/1.2`) to label your requests; otherwise the `User-Agent` is recorded. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param [Hash] opts the optional parameters
+  # @option opts [ApiActivityOutcome] :outcome 
+  # @option opts [String] :client Client label prefix, for example `mcp`.
+  # @option opts [Time] :since Only entries at or after this time (UTC).
+  # @option opts [Integer] :page 
+  # @return [ListApiActivity200Response]
+  describe 'list_api_activity 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/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

@@ -0,0 +1,189 @@
+=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::AIApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'AIApi' do
+  before do
+    # run before each test
+    @api_instance = PostBoost::AIApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of AIApi' do
+    it 'should create an instance of AIApi' do
+      expect(@api_instance).to be_instance_of(PostBoost::AIApi)
+    end
+  end
+
+  # unit tests for blog_to_social
+  # Generate social media captions from a blog post
+  # Generates platform-specific social media captions from a blog post URL or directly provided title and excerpt. Each platform generates one caption, which consumes one AI credit from the workspace's monthly allowance.  **Input modes** (at least one required): - **URL mode**: provide `url` and the API scrapes the blog content automatically, including detecting the featured image via `og:image`. - **Direct mode**: provide `title` and `excerpt` directly (no scraping).  If both are provided, direct values take priority.  When `create_post` is `true`, a draft post is created in the workspace with per-account caption versions. If an image is available (from `image_url` or the scraped `og:image`), it is imported into the workspace media library and attached to the draft post. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param blog_to_social_input 
+  # @param [Hash] opts the optional parameters
+  # @return [BlogToSocial200Response]
+  describe 'blog_to_social 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_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. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param image_alt_text_input 
+  # @param [Hash] opts the optional parameters
+  # @return [ImageAltText200Response]
+  describe 'image_alt_text 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_edit
+  # Edit an existing media image using AI
+  # Edits an existing workspace media item using the source image and a text prompt. Optionally accepts a mask (transparent areas are replaced). Saves results to the media library. Credits: `count × credit_weight`. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param image_edit_input 
+  # @param [Hash] opts the optional parameters
+  # @return [ImageGenerate200Response]
+  describe 'image_edit 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_generate
+  # Generate social media images from a caption
+  # Generates one or more images and saves them immediately to the workspace media library.  **Standard mode** (recommended): provide `caption` + `platform`. PostBoost builds a professional image prompt internally using platform-specific templates. No prompt engineering required.  **Developer mode**: provide `prompt` directly to bypass prompt building. If both `caption` and `prompt` are sent, standard mode runs.  Credits: `count x credit_weight` (default: 5 per image). 
+  # @param workspace_uuid UUID of the workspace.
+  # @param image_generate_input 
+  # @param [Hash] opts the optional parameters
+  # @return [ImageGenerate200Response]
+  describe 'image_generate 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_prompt
+  # Build an optimized image prompt from a social media caption
+  # Builds a professional image generation prompt from a caption and platform. No image is generated. Use this to preview the prompt before calling `image-generate`. Costs 1 AI credit per call.  When `image-generate` builds the prompt internally (standard mode), no credit is charged for the prompt step. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param image_prompt_input 
+  # @param [Hash] opts the optional parameters
+  # @return [ImagePrompt200Response]
+  describe 'image_prompt 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_variations
+  # Generate variations of an existing media image
+  # Creates one or more variations of an existing workspace media item. Saves results to the media library. Credits: `count × credit_weight`. 
+  # @param workspace_uuid UUID of the workspace.
+  # @param image_variations_input 
+  # @param [Hash] opts the optional parameters
+  # @return [ImageVariations200Response]
+  describe 'image_variations 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 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