postboost 1.8.0 → 1.14.0

data/docs/BlogToSocial200Response.md

@@ -5,6 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **data** | [**BlogToSocialResponse**](BlogToSocialResponse.md) |  | [optional] |
+| **meta** | [**BrandVoiceMeta**](BrandVoiceMeta.md) |  | [optional] |
 
 ## Example
 
@@ -12,7 +13,8 @@
 require 'postboost'
 
 instance = PostBoost::BlogToSocial200Response.new(
-  data: null
+  data: null,
+  meta: null
 )
 ```
 

data/docs/BlogToSocialInput.md

@@ -17,6 +17,7 @@
 | **language** | **String** | Output language as an ISO 639-1 code (e.g. `en`, `de`, `fr`). Use `auto` to match the blog post's language automatically.  | [optional][default to 'auto'] |
 | **custom_instructions** | **String** | Additional instructions appended to the AI prompt (e.g. \"always mention our free tier\"). | [optional] |
 | **create_post** | **Boolean** | When `true`, creates a draft post in the workspace with per-account caption versions. If an image is available, it is imported and attached to the post.  | [optional][default to false] |
+| **use_brand_voice** | **Boolean** | Apply the workspace brand voice (see `GET brand-voice`) to the captions. An explicit `tone` is kept, but the brand voice wins on vocabulary, words to avoid and calls to action.  | [optional][default to true] |
 
 ## Example
 
@@ -36,7 +37,8 @@ instance = PostBoost::BlogToSocialInput.new(
   cta: link,
   language: auto,
   custom_instructions: Always mention that PostBoost supports 12+ platforms.,
-  create_post: null
+  create_post: null,
+  use_brand_voice: null
 )
 ```
 

data/docs/BrandVoice.md

@@ -0,0 +1,48 @@
+# PostBoost::BrandVoice
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **business_name** | **String** |  | [optional] |
+| **mission** | **String** |  | [optional] |
+| **industry** | **String** |  | [optional] |
+| **personality** | **String** |  | [optional] |
+| **audience** | **Array<String>** |  | [optional] |
+| **topics_preferred** | **Array<String>** |  | [optional] |
+| **topics_avoided** | **Array<String>** |  | [optional] |
+| **tone_formal** | **Integer** |  |  |
+| **tone_playful** | **Integer** |  |  |
+| **tone_technical** | **Integer** |  |  |
+| **emoji_style** | **String** |  |  |
+| **hashtag_strategy** | **String** |  |  |
+| **avoid_words** | **Array<String>** |  | [optional] |
+| **preferred_cta** | **Array<String>** |  | [optional] |
+| **example_posts** | **Array<String>** |  | [optional] |
+| **updated_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::BrandVoice.new(
+  business_name: null,
+  mission: null,
+  industry: null,
+  personality: null,
+  audience: null,
+  topics_preferred: null,
+  topics_avoided: null,
+  tone_formal: null,
+  tone_playful: null,
+  tone_technical: null,
+  emoji_style: null,
+  hashtag_strategy: null,
+  avoid_words: null,
+  preferred_cta: null,
+  example_posts: null,
+  updated_at: null
+)
+```
+

data/docs/BrandVoiceInput.md

@@ -0,0 +1,46 @@
+# PostBoost::BrandVoiceInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **business_name** | **String** |  | [optional] |
+| **mission** | **String** |  | [optional] |
+| **industry** | **String** |  | [optional] |
+| **personality** | **String** | How the brand sounds. The first sentence also feeds image prompts. | [optional] |
+| **audience** | **Array<String>** |  | [optional] |
+| **topics_preferred** | **Array<String>** |  | [optional] |
+| **topics_avoided** | **Array<String>** |  | [optional] |
+| **tone_formal** | **Integer** | 1 very casual, 3 neutral, 5 very formal. | [optional] |
+| **tone_playful** | **Integer** | 1 strictly serious, 3 neutral, 5 very playful. | [optional] |
+| **tone_technical** | **Integer** | 1 very simple, 3 neutral, 5 highly technical. | [optional] |
+| **emoji_style** | **String** |  | [optional] |
+| **hashtag_strategy** | **String** |  | [optional] |
+| **avoid_words** | **Array<String>** |  | [optional] |
+| **preferred_cta** | **Array<String>** |  | [optional] |
+| **example_posts** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::BrandVoiceInput.new(
+  business_name: null,
+  mission: null,
+  industry: null,
+  personality: null,
+  audience: null,
+  topics_preferred: null,
+  topics_avoided: null,
+  tone_formal: null,
+  tone_playful: null,
+  tone_technical: null,
+  emoji_style: null,
+  hashtag_strategy: null,
+  avoid_words: null,
+  preferred_cta: null,
+  example_posts: null
+)
+```
+

data/docs/BrandVoiceMeta.md

@@ -0,0 +1,18 @@
+# PostBoost::BrandVoiceMeta
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **brand_voice_applied** | **Boolean** | Whether the workspace brand voice shaped this result. |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::BrandVoiceMeta.new(
+  brand_voice_applied: null
+)
+```
+

data/docs/ChannelAccount.md

@@ -0,0 +1,36 @@
+# PostBoost::ChannelAccount
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  |  |
+| **uuid** | **String** |  |  |
+| **name** | **String** |  |  |
+| **username** | **String** | Telegram public channel username; null for private channels, Discord and Slack. | [optional] |
+| **image** | **String** |  | [optional] |
+| **provider** | **String** |  |  |
+| **data** | **Object** | Provider metadata (Telegram `chat_id`, Discord `channel_id`/`guild_id`, Slack `team_id`). |  |
+| **authorized** | **Boolean** |  |  |
+| **profile_url** | **String** |  | [optional] |
+| **created_at** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::ChannelAccount.new(
+  id: null,
+  uuid: null,
+  name: Product news,
+  username: null,
+  image: null,
+  provider: null,
+  data: null,
+  authorized: null,
+  profile_url: null,
+  created_at: null
+)
+```
+

data/docs/CodedError.md

@@ -0,0 +1,22 @@
+# PostBoost::CodedError
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **message** | **String** |  |  |
+| **code** | **String** | Machine-readable reason, e.g. `ai_credits_exhausted`, `image_credits_exhausted`, `not_enough_posts`. | [optional] |
+| **errors** | **Hash<String, Object>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::CodedError.new(
+  message: null,
+  code: null,
+  errors: null
+)
+```
+

data/docs/Competitor.md

@@ -0,0 +1,34 @@
+# PostBoost::Competitor
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  |  |
+| **account_id** | **Integer** |  |  |
+| **username** | **String** |  |  |
+| **name** | **String** |  | [optional] |
+| **image** | **String** |  | [optional] |
+| **followers_count** | **Integer** |  | [optional] |
+| **media_count** | **Integer** |  | [optional] |
+| **avg_engagement** | **Integer** | Average likes plus comments per imported post. |  |
+| **last_snapshot_date** | **Date** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::Competitor.new(
+  id: null,
+  account_id: null,
+  username: natgeo,
+  name: null,
+  image: null,
+  followers_count: null,
+  media_count: null,
+  avg_engagement: null,
+  last_snapshot_date: null
+)
+```
+

data/docs/CompetitorDetail.md

@@ -0,0 +1,38 @@
+# PostBoost::CompetitorDetail
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  |  |
+| **account_id** | **Integer** |  |  |
+| **username** | **String** |  |  |
+| **name** | **String** |  | [optional] |
+| **image** | **String** |  | [optional] |
+| **followers_count** | **Integer** |  | [optional] |
+| **media_count** | **Integer** |  | [optional] |
+| **avg_engagement** | **Integer** | Average likes plus comments per imported post. |  |
+| **last_snapshot_date** | **Date** |  | [optional] |
+| **snapshots** | [**Array<CompetitorSnapshot>**](CompetitorSnapshot.md) |  |  |
+| **recent_media** | [**Array<CompetitorMedia>**](CompetitorMedia.md) |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::CompetitorDetail.new(
+  id: null,
+  account_id: null,
+  username: natgeo,
+  name: null,
+  image: null,
+  followers_count: null,
+  media_count: null,
+  avg_engagement: null,
+  last_snapshot_date: null,
+  snapshots: null,
+  recent_media: null
+)
+```
+

data/docs/CompetitorInput.md

@@ -0,0 +1,20 @@
+# PostBoost::CompetitorInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **Integer** | Your Instagram account `id` (connected through a Facebook Page) used to look the competitor up. |  |
+| **username** | **String** | Instagram username, with or without `@`. |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::CompetitorInput.new(
+  account_id: null,
+  username: natgeo
+)
+```
+

data/docs/CompetitorMedia.md

@@ -0,0 +1,28 @@
+# PostBoost::CompetitorMedia
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **caption** | **String** |  | [optional] |
+| **permalink** | **String** |  | [optional] |
+| **media_type** | **String** |  | [optional] |
+| **like_count** | **Integer** |  | [optional] |
+| **comments_count** | **Integer** |  | [optional] |
+| **timestamp** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::CompetitorMedia.new(
+  caption: null,
+  permalink: null,
+  media_type: null,
+  like_count: null,
+  comments_count: null,
+  timestamp: null
+)
+```
+

data/docs/CompetitorSnapshot.md

@@ -0,0 +1,22 @@
+# PostBoost::CompetitorSnapshot
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **date** | **Date** |  | [optional] |
+| **followers_count** | **Integer** |  | [optional] |
+| **media_count** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::CompetitorSnapshot.new(
+  date: null,
+  followers_count: null,
+  media_count: null
+)
+```
+

data/docs/CompetitorsApi.md

@@ -0,0 +1,296 @@
+# PostBoost::CompetitorsApi
+
+All URIs are relative to *https://postboost.co/app/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**add_competitor**](CompetitorsApi.md#add_competitor) | **POST** /{workspaceUuid}/competitors | Track a competitor |
+| [**delete_competitor**](CompetitorsApi.md#delete_competitor) | **DELETE** /{workspaceUuid}/competitors/{competitorId} | Stop tracking a competitor |
+| [**get_competitor**](CompetitorsApi.md#get_competitor) | **GET** /{workspaceUuid}/competitors/{competitorId} | Get a competitor |
+| [**list_competitors**](CompetitorsApi.md#list_competitors) | **GET** /{workspaceUuid}/competitors | List competitors |
+
+
+## add_competitor
+
+> <AddCompetitor202Response> add_competitor(workspace_uuid, competitor_input)
+
+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). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'postboost'
+# setup authorization
+PostBoost.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PostBoost::CompetitorsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+competitor_input = PostBoost::CompetitorInput.new({account_id: 37, username: 'natgeo'}) # CompetitorInput | 
+
+begin
+  # Track a competitor
+  result = api_instance.add_competitor(workspace_uuid, competitor_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->add_competitor: #{e}"
+end
+```
+
+#### Using the add_competitor_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<AddCompetitor202Response>, Integer, Hash)> add_competitor_with_http_info(workspace_uuid, competitor_input)
+
+```ruby
+begin
+  # Track a competitor
+  data, status_code, headers = api_instance.add_competitor_with_http_info(workspace_uuid, competitor_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <AddCompetitor202Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->add_competitor_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **competitor_input** | [**CompetitorInput**](CompetitorInput.md) |  |  |
+
+### Return type
+
+[**AddCompetitor202Response**](AddCompetitor202Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## delete_competitor
+
+> delete_competitor(workspace_uuid, competitor_id)
+
+Stop tracking a competitor
+
+Deletes the competitor with its snapshots and media. Admins and members only (not viewers). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'postboost'
+# setup authorization
+PostBoost.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PostBoost::CompetitorsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+competitor_id = 56 # Integer | The competitor `id`.
+
+begin
+  # Stop tracking a competitor
+  api_instance.delete_competitor(workspace_uuid, competitor_id)
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->delete_competitor: #{e}"
+end
+```
+
+#### Using the delete_competitor_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> delete_competitor_with_http_info(workspace_uuid, competitor_id)
+
+```ruby
+begin
+  # Stop tracking a competitor
+  data, status_code, headers = api_instance.delete_competitor_with_http_info(workspace_uuid, competitor_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->delete_competitor_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **competitor_id** | **Integer** | The competitor &#x60;id&#x60;. |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_competitor
+
+> <GetCompetitor200Response> get_competitor(workspace_uuid, competitor_id)
+
+Get a competitor
+
+The competitor with daily follower snapshots for the last 90 days and its 12 most recent posts. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'postboost'
+# setup authorization
+PostBoost.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PostBoost::CompetitorsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+competitor_id = 56 # Integer | The competitor `id`.
+
+begin
+  # Get a competitor
+  result = api_instance.get_competitor(workspace_uuid, competitor_id)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->get_competitor: #{e}"
+end
+```
+
+#### Using the get_competitor_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetCompetitor200Response>, Integer, Hash)> get_competitor_with_http_info(workspace_uuid, competitor_id)
+
+```ruby
+begin
+  # Get a competitor
+  data, status_code, headers = api_instance.get_competitor_with_http_info(workspace_uuid, competitor_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetCompetitor200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->get_competitor_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **competitor_id** | **Integer** | The competitor &#x60;id&#x60;. |  |
+
+### Return type
+
+[**GetCompetitor200Response**](GetCompetitor200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_competitors
+
+> <ListCompetitors200Response> list_competitors(workspace_uuid, opts)
+
+List competitors
+
+Instagram business or creator accounts the workspace tracks, by follower count. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'postboost'
+# setup authorization
+PostBoost.configure do |config|
+  # Configure Bearer authorization: bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = PostBoost::CompetitorsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+opts = {
+  account_id: 56 # Integer | Only competitors tracked from this Instagram account `id`.
+}
+
+begin
+  # List competitors
+  result = api_instance.list_competitors(workspace_uuid, opts)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->list_competitors: #{e}"
+end
+```
+
+#### Using the list_competitors_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListCompetitors200Response>, Integer, Hash)> list_competitors_with_http_info(workspace_uuid, opts)
+
+```ruby
+begin
+  # List competitors
+  data, status_code, headers = api_instance.list_competitors_with_http_info(workspace_uuid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListCompetitors200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling CompetitorsApi->list_competitors_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **account_id** | **Integer** | Only competitors tracked from this Instagram account &#x60;id&#x60;. | [optional] |
+
+### Return type
+
+[**ListCompetitors200Response**](ListCompetitors200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/ConnectChannelInput.md

@@ -0,0 +1,24 @@
+# PostBoost::ConnectChannelInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **bot_token** | **String** | Telegram only. Bot token from @BotFather. | [optional] |
+| **chat** | **String** | Telegram only. Channel `@username` or numeric chat id. | [optional] |
+| **webhook_url** | **String** | Discord or Slack incoming webhook URL. | [optional] |
+| **name** | **String** | Slack only. Display name for the channel (Slack webhooks do not report one). | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::ConnectChannelInput.new(
+  bot_token: 123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsawQ,
+  chat: @yourchannel,
+  webhook_url: null,
+  name: null
+)
+```
+

data/docs/CreateAccountGroup201Response.md

@@ -0,0 +1,18 @@
+# PostBoost::CreateAccountGroup201Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **data** | [**AccountGroup**](AccountGroup.md) |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::CreateAccountGroup201Response.new(
+  data: null
+)
+```
+