postboost 1.40.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 968b5251aaee3298d0c871697258f34f620bd4a4a7267462c56608d614088de4
-  data.tar.gz: f6c9cd7f2e9e50ae9e499d04a0d810e75992c2e496e6c174bcb9db32f40ea528
+  metadata.gz: 7664b189b25efbd888d62956131073659ac5ac40182e67811f18b8fa237d1fbf
+  data.tar.gz: 188e2a03c37763c4ffb145ba3940506ec27f157232c07b338cf6ca14870f5e12
 SHA512:
-  metadata.gz: b96d9f749409ca72e84997c497988badf6c6e759a563a6cace83dfce2e963b442b2a010ca17adeadfe6baaf21e621e4a7fe9887f39ad56044738f3cdea4e8229
-  data.tar.gz: 45c42cd12f076d2b607d5a5710839105e4d4660a492571fb51767557d35f05a81b78ef82870dfbac3952bbeb4d57ec397fc7d316fef9312fbf6d26c65f015ccb
+  metadata.gz: ed75c458dac42708e6375e14ed43a9ab664a0905265254483bf6c718dec28b334a56a6d830757b64548a38a0a83097e1c4b31bf780dd8ce5c095c85b4a7bb400
+  data.tar.gz: a0f03c49a13f955dedb9943b82963652f53c4d047b3245f0effb5bc350c9dbe6f7aac6a178146c554e26106dc8d740ba252f516d965551ecf330be1f017fd847

data/README.md

@@ -13,7 +13,7 @@ gem install postboost
 | **RubyGems** | [rubygems.org/gems/postboost](https://rubygems.org/gems/postboost) |
 | **GitHub** | [postboost-co/postboost-ruby](https://github.com/postboost-co/postboost-ruby) |
 | **Docs** | [postboost.co/docs/api](https://postboost.co/docs/api) |
-| **Version** | v1.40.0 |
+| **Version** | v1.42.0 |
 
 ## Quick start
 
@@ -95,12 +95,14 @@ Class | Method | HTTP request | Description
 *PostBoost::FreeToolsApi* | [**check_youtube_thumbnail**](docs/FreeToolsApi.md#check_youtube_thumbnail) | **POST** /tools/youtube-thumbnail-size-checker | Check a YouTube thumbnail's ratio, width, file size and format against YouTube's requirements
 *PostBoost::FreeToolsApi* | [**clean_text**](docs/FreeToolsApi.md#clean_text) | **POST** /tools/ai-text-cleaner | Clean AI-written text: dashes, quotes, invisible characters, markdown
 *PostBoost::FreeToolsApi* | [**count_characters**](docs/FreeToolsApi.md#count_characters) | **POST** /tools/social-media-character-counter | Count characters as each network counts them
+*PostBoost::FreeToolsApi* | [**format_instagram_caption**](docs/FreeToolsApi.md#format_instagram_caption) | **POST** /tools/instagram-line-break-generator | Keep blank lines in an Instagram caption with spacer lines, and count it
 *PostBoost::FreeToolsApi* | [**format_linked_in_post**](docs/FreeToolsApi.md#format_linked_in_post) | **POST** /tools/linkedin-post-formatter | Format a LinkedIn post with bold, italic and lists
 *PostBoost::FreeToolsApi* | [**generate_caption**](docs/FreeToolsApi.md#generate_caption) | **POST** /tools/instagram-caption-generator | Write three post captions for a topic with AI (needs a token, spends AI credits)
 *PostBoost::FreeToolsApi* | [**generate_fancy_text**](docs/FreeToolsApi.md#generate_fancy_text) | **POST** /tools/fancy-text-generator | Convert text to fancy Unicode styles
 *PostBoost::FreeToolsApi* | [**generate_hashtags**](docs/FreeToolsApi.md#generate_hashtags) | **POST** /tools/instagram-hashtag-generator | Generate hashtags for a post topic with AI (needs a token, spends AI credits)
 *PostBoost::FreeToolsApi* | [**generate_hooks**](docs/FreeToolsApi.md#generate_hooks) | **POST** /tools/hook-generator | Generate hooks (opening lines) for a social media post with AI (needs a token, spends AI credits)
 *PostBoost::FreeToolsApi* | [**generate_qr_code**](docs/FreeToolsApi.md#generate_qr_code) | **POST** /tools/qr-code-generator | Generate a QR code (SVG) for a link or text, with optional UTM tags
+*PostBoost::FreeToolsApi* | [**generate_social_posts_from_blog**](docs/FreeToolsApi.md#generate_social_posts_from_blog) | **POST** /tools/blog-to-social-media | Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits)
 *PostBoost::FreeToolsApi* | [**get_best_times_to_post**](docs/FreeToolsApi.md#get_best_times_to_post) | **GET** /tools/best-time-to-post | Get the best times to post per network from published studies, with sources
 *PostBoost::FreeToolsApi* | [**get_hook_templates**](docs/FreeToolsApi.md#get_hook_templates) | **GET** /tools/hook-generator/library | Get free hook templates for social media posts, filtered by style and network
 *PostBoost::FreeToolsApi* | [**get_image_sizes**](docs/FreeToolsApi.md#get_image_sizes) | **GET** /tools/social-media-image-sizes | Get social media image sizes per network, each with its source

data/docs/FreeToolFormatInstagramCaptionRequest.md

@@ -0,0 +1,22 @@
+# PostBoost::FreeToolFormatInstagramCaptionRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **text** | **String** |  |  |
+| **spacer** | **String** | What fills a blank line: braille (U+2800 Braille blank, shows as an empty line) or dot (a line with \".\"). | [optional][default to 'braille'] |
+| **hashtags_to_end** | **Boolean** | Move the hashtags that end a line to the bottom, after three spacer lines. A hashtag inside a sentence stays where it is. | [optional][default to false] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolFormatInstagramCaptionRequest.new(
+  text: null,
+  spacer: null,
+  hashtags_to_end: null
+)
+```
+

data/docs/FreeToolFormatInstagramCaptionResponse.md

@@ -0,0 +1,28 @@
+# PostBoost::FreeToolFormatInstagramCaptionResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **text** | **String** | The caption with spacer lines, ready to paste into Instagram. | [optional] |
+| **count** | **Integer** | Characters, counted like the PostBoost composer counts an Instagram caption. | [optional] |
+| **limit** | **Integer** | Instagram caption limit. | [optional] |
+| **over** | **Boolean** |  | [optional] |
+| **hashtags** | **Integer** | Hashtags in the caption. | [optional] |
+| **max_hashtags** | **Integer** | Hashtags PostBoost allows per Instagram post. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolFormatInstagramCaptionResponse.new(
+  text: null,
+  count: null,
+  limit: null,
+  over: null,
+  hashtags: null,
+  max_hashtags: null
+)
+```
+

data/docs/FreeToolGenerateSocialPostsFromBlogRequest.md

@@ -0,0 +1,32 @@
+# PostBoost::FreeToolGenerateSocialPostsFromBlogRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **url** | **String** | Public http(s) address of the blog post. Give `url` or `text`. | [optional] |
+| **text** | **String** | The blog post itself, instead of `url`. | [optional] |
+| **platforms** | **Array<String>** | Networks to write for, at most 4 per call (one AI credit each). |  |
+| **tone** | **String** |  | [optional][default to 'casual'] |
+| **length** | **String** |  | [optional][default to 'short'] |
+| **hashtags** | **String** | How many hashtags to include. | [optional][default to 'no'] |
+| **cta** | **String** | Call to action to end with. | [optional][default to 'no'] |
+| **workspace** | **String** | UUID of the workspace whose AI credits pay for the call. Default: your active workspace (a scoped API key: its own workspace). | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateSocialPostsFromBlogRequest.new(
+  url: null,
+  text: null,
+  platforms: null,
+  tone: null,
+  length: null,
+  hashtags: null,
+  cta: null,
+  workspace: null
+)
+```
+

data/docs/FreeToolGenerateSocialPostsFromBlogResponse.md

@@ -0,0 +1,24 @@
+# PostBoost::FreeToolGenerateSocialPostsFromBlogResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **posts** | [**Array<FreeToolGenerateSocialPostsFromBlogResponsePostsInner>**](FreeToolGenerateSocialPostsFromBlogResponsePostsInner.md) | One post per platform that came back, in the order asked. | [optional] |
+| **source** | [**FreeToolGenerateSocialPostsFromBlogResponseSource**](FreeToolGenerateSocialPostsFromBlogResponseSource.md) |  | [optional] |
+| **warnings** | [**Array<FreeToolGenerateSocialPostsFromBlogResponseWarningsInner>**](FreeToolGenerateSocialPostsFromBlogResponseWarningsInner.md) |  | [optional] |
+| **credits_spent** | **Integer** | AI credits this call took from the workspace: one per post. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateSocialPostsFromBlogResponse.new(
+  posts: null,
+  source: null,
+  warnings: null,
+  credits_spent: null
+)
+```
+

data/docs/FreeToolGenerateSocialPostsFromBlogResponsePostsInner.md

@@ -0,0 +1,26 @@
+# PostBoost::FreeToolGenerateSocialPostsFromBlogResponsePostsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **platform** | **String** |  | [optional] |
+| **text** | **String** | The post, cut at a sentence end when the model ran over the limit. | [optional] |
+| **hashtags** | **Array<String>** | Hashtags in the text, with #. | [optional] |
+| **characters** | **Integer** | Length as the network counts it (X weighs links as 23, YouTube counts bytes). | [optional] |
+| **limit** | **Integer** | The network's text limit. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateSocialPostsFromBlogResponsePostsInner.new(
+  platform: null,
+  text: null,
+  hashtags: null,
+  characters: null,
+  limit: null
+)
+```
+

data/docs/FreeToolGenerateSocialPostsFromBlogResponseSource.md

@@ -0,0 +1,20 @@
+# PostBoost::FreeToolGenerateSocialPostsFromBlogResponseSource
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **title** | **String** |  | [optional] |
+| **final_url** | **String** | Address after redirects. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateSocialPostsFromBlogResponseSource.new(
+  title: null,
+  final_url: null
+)
+```
+

data/docs/FreeToolGenerateSocialPostsFromBlogResponseWarningsInner.md

@@ -0,0 +1,22 @@
+# PostBoost::FreeToolGenerateSocialPostsFromBlogResponseWarningsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **code** | **String** | platforms_skipped: no reply within the time budget or the provider failed for them (not charged). | [optional] |
+| **message** | **String** |  | [optional] |
+| **platforms** | **Array<String>** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateSocialPostsFromBlogResponseWarningsInner.new(
+  code: null,
+  message: null,
+  platforms: null
+)
+```
+

data/docs/FreeToolsApi.md

@@ -13,12 +13,14 @@ All URIs are relative to *https://postboost.co/app/api*
 | [**check_youtube_thumbnail**](FreeToolsApi.md#check_youtube_thumbnail) | **POST** /tools/youtube-thumbnail-size-checker | Check a YouTube thumbnail's ratio, width, file size and format against YouTube's requirements |
 | [**clean_text**](FreeToolsApi.md#clean_text) | **POST** /tools/ai-text-cleaner | Clean AI-written text: dashes, quotes, invisible characters, markdown |
 | [**count_characters**](FreeToolsApi.md#count_characters) | **POST** /tools/social-media-character-counter | Count characters as each network counts them |
+| [**format_instagram_caption**](FreeToolsApi.md#format_instagram_caption) | **POST** /tools/instagram-line-break-generator | Keep blank lines in an Instagram caption with spacer lines, and count it |
 | [**format_linked_in_post**](FreeToolsApi.md#format_linked_in_post) | **POST** /tools/linkedin-post-formatter | Format a LinkedIn post with bold, italic and lists |
 | [**generate_caption**](FreeToolsApi.md#generate_caption) | **POST** /tools/instagram-caption-generator | Write three post captions for a topic with AI (needs a token, spends AI credits) |
 | [**generate_fancy_text**](FreeToolsApi.md#generate_fancy_text) | **POST** /tools/fancy-text-generator | Convert text to fancy Unicode styles |
 | [**generate_hashtags**](FreeToolsApi.md#generate_hashtags) | **POST** /tools/instagram-hashtag-generator | Generate hashtags for a post topic with AI (needs a token, spends AI credits) |
 | [**generate_hooks**](FreeToolsApi.md#generate_hooks) | **POST** /tools/hook-generator | Generate hooks (opening lines) for a social media post with AI (needs a token, spends AI credits) |
 | [**generate_qr_code**](FreeToolsApi.md#generate_qr_code) | **POST** /tools/qr-code-generator | Generate a QR code (SVG) for a link or text, with optional UTM tags |
+| [**generate_social_posts_from_blog**](FreeToolsApi.md#generate_social_posts_from_blog) | **POST** /tools/blog-to-social-media | Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits) |
 | [**get_best_times_to_post**](FreeToolsApi.md#get_best_times_to_post) | **GET** /tools/best-time-to-post | Get the best times to post per network from published studies, with sources |
 | [**get_hook_templates**](FreeToolsApi.md#get_hook_templates) | **GET** /tools/hook-generator/library | Get free hook templates for social media posts, filtered by style and network |
 | [**get_image_sizes**](FreeToolsApi.md#get_image_sizes) | **GET** /tools/social-media-image-sizes | Get social media image sizes per network, each with its source |
@@ -604,6 +606,70 @@ No authorization required
 - **Accept**: application/json
 
 
+## format_instagram_caption
+
+> <FreeToolFormatInstagramCaptionResponse> format_instagram_caption(free_tool_format_instagram_caption_request)
+
+Keep blank lines in an Instagram caption with spacer lines, and count it
+
+Keep blank lines in an Instagram caption with spacer lines, and count it. The same logic as the free web tool at https://postboost.co/tools/instagram-line-break-generator. No account needed: call it without a token, or with any API token.
+
+### Examples
+
+```ruby
+require 'time'
+require 'postboost'
+
+api_instance = PostBoost::FreeToolsApi.new
+free_tool_format_instagram_caption_request = PostBoost::FreeToolFormatInstagramCaptionRequest.new({text: 'text_example'}) # FreeToolFormatInstagramCaptionRequest | 
+
+begin
+  # Keep blank lines in an Instagram caption with spacer lines, and count it
+  result = api_instance.format_instagram_caption(free_tool_format_instagram_caption_request)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->format_instagram_caption: #{e}"
+end
+```
+
+#### Using the format_instagram_caption_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FreeToolFormatInstagramCaptionResponse>, Integer, Hash)> format_instagram_caption_with_http_info(free_tool_format_instagram_caption_request)
+
+```ruby
+begin
+  # Keep blank lines in an Instagram caption with spacer lines, and count it
+  data, status_code, headers = api_instance.format_instagram_caption_with_http_info(free_tool_format_instagram_caption_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FreeToolFormatInstagramCaptionResponse>
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->format_instagram_caption_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **free_tool_format_instagram_caption_request** | [**FreeToolFormatInstagramCaptionRequest**](FreeToolFormatInstagramCaptionRequest.md) |  |  |
+
+### Return type
+
+[**FreeToolFormatInstagramCaptionResponse**](FreeToolFormatInstagramCaptionResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## format_linked_in_post
 
 > <FreeToolFormatLinkedInPostResponse> format_linked_in_post(free_tool_format_linked_in_post_request)
@@ -1003,6 +1069,75 @@ No authorization required
 - **Accept**: application/json
 
 
+## generate_social_posts_from_blog
+
+> <FreeToolGenerateSocialPostsFromBlogResponse> generate_social_posts_from_blog(free_tool_generate_social_posts_from_blog_request)
+
+Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits)
+
+Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits). The same logic as the free web tool at https://postboost.co/tools/blog-to-social-media. Needs an API token (a scoped key needs the `ai` ability and pays with its own workspace). Each post spends 1 AI credit of the workspace you name (or your active workspace), so a call costs one credit per platform that comes back; results are not cached.
+
+### 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::FreeToolsApi.new
+free_tool_generate_social_posts_from_blog_request = PostBoost::FreeToolGenerateSocialPostsFromBlogRequest.new({platforms: ['facebook']}) # FreeToolGenerateSocialPostsFromBlogRequest | 
+
+begin
+  # Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits)
+  result = api_instance.generate_social_posts_from_blog(free_tool_generate_social_posts_from_blog_request)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->generate_social_posts_from_blog: #{e}"
+end
+```
+
+#### Using the generate_social_posts_from_blog_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FreeToolGenerateSocialPostsFromBlogResponse>, Integer, Hash)> generate_social_posts_from_blog_with_http_info(free_tool_generate_social_posts_from_blog_request)
+
+```ruby
+begin
+  # Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits)
+  data, status_code, headers = api_instance.generate_social_posts_from_blog_with_http_info(free_tool_generate_social_posts_from_blog_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FreeToolGenerateSocialPostsFromBlogResponse>
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->generate_social_posts_from_blog_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **free_tool_generate_social_posts_from_blog_request** | [**FreeToolGenerateSocialPostsFromBlogRequest**](FreeToolGenerateSocialPostsFromBlogRequest.md) |  |  |
+
+### Return type
+
+[**FreeToolGenerateSocialPostsFromBlogResponse**](FreeToolGenerateSocialPostsFromBlogResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## get_best_times_to_post
 
 > <FreeToolGetBestTimesToPostResponse> get_best_times_to_post(opts)

data/lib/postboost/api/account_groups_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/accounts_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/activity_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/agents_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/ai_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/analytics_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/competitors_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0

data/lib/postboost/api/free_tools_api.rb

@@ -3,7 +3,7 @@
 
 #The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network 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.40.0
+The version of the OpenAPI document: 1.42.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -631,6 +631,74 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Keep blank lines in an Instagram caption with spacer lines, and count it
+    # Keep blank lines in an Instagram caption with spacer lines, and count it. The same logic as the free web tool at https://postboost.co/tools/instagram-line-break-generator. No account needed: call it without a token, or with any API token.
+    # @param free_tool_format_instagram_caption_request [FreeToolFormatInstagramCaptionRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [FreeToolFormatInstagramCaptionResponse]
+    def format_instagram_caption(free_tool_format_instagram_caption_request, opts = {})
+      data, _status_code, _headers = format_instagram_caption_with_http_info(free_tool_format_instagram_caption_request, opts)
+      data
+    end
+
+    # Keep blank lines in an Instagram caption with spacer lines, and count it
+    # Keep blank lines in an Instagram caption with spacer lines, and count it. The same logic as the free web tool at https://postboost.co/tools/instagram-line-break-generator. No account needed: call it without a token, or with any API token.
+    # @param free_tool_format_instagram_caption_request [FreeToolFormatInstagramCaptionRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FreeToolFormatInstagramCaptionResponse, Integer, Hash)>] FreeToolFormatInstagramCaptionResponse data, response status code and response headers
+    def format_instagram_caption_with_http_info(free_tool_format_instagram_caption_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FreeToolsApi.format_instagram_caption ...'
+      end
+      # verify the required parameter 'free_tool_format_instagram_caption_request' is set
+      if @api_client.config.client_side_validation && free_tool_format_instagram_caption_request.nil?
+        fail ArgumentError, "Missing the required parameter 'free_tool_format_instagram_caption_request' when calling FreeToolsApi.format_instagram_caption"
+      end
+      # resource path
+      local_var_path = '/tools/instagram-line-break-generator'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(free_tool_format_instagram_caption_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FreeToolFormatInstagramCaptionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"FreeToolsApi.format_instagram_caption",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FreeToolsApi#format_instagram_caption\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Format a LinkedIn post with bold, italic and lists
     # Format a LinkedIn post with bold, italic and lists. The same logic as the free web tool at https://postboost.co/tools/linkedin-post-formatter. No account needed: call it without a token, or with any API token.
     # @param free_tool_format_linked_in_post_request [FreeToolFormatLinkedInPostRequest] 
@@ -1039,6 +1107,74 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits)
+    # Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits). The same logic as the free web tool at https://postboost.co/tools/blog-to-social-media. Needs an API token (a scoped key needs the `ai` ability and pays with its own workspace). Each post spends 1 AI credit of the workspace you name (or your active workspace), so a call costs one credit per platform that comes back; results are not cached.
+    # @param free_tool_generate_social_posts_from_blog_request [FreeToolGenerateSocialPostsFromBlogRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [FreeToolGenerateSocialPostsFromBlogResponse]
+    def generate_social_posts_from_blog(free_tool_generate_social_posts_from_blog_request, opts = {})
+      data, _status_code, _headers = generate_social_posts_from_blog_with_http_info(free_tool_generate_social_posts_from_blog_request, opts)
+      data
+    end
+
+    # Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits)
+    # Turn a blog post (URL or text) into one social post per network with AI (needs a token, spends AI credits). The same logic as the free web tool at https://postboost.co/tools/blog-to-social-media. Needs an API token (a scoped key needs the &#x60;ai&#x60; ability and pays with its own workspace). Each post spends 1 AI credit of the workspace you name (or your active workspace), so a call costs one credit per platform that comes back; results are not cached.
+    # @param free_tool_generate_social_posts_from_blog_request [FreeToolGenerateSocialPostsFromBlogRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FreeToolGenerateSocialPostsFromBlogResponse, Integer, Hash)>] FreeToolGenerateSocialPostsFromBlogResponse data, response status code and response headers
+    def generate_social_posts_from_blog_with_http_info(free_tool_generate_social_posts_from_blog_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FreeToolsApi.generate_social_posts_from_blog ...'
+      end
+      # verify the required parameter 'free_tool_generate_social_posts_from_blog_request' is set
+      if @api_client.config.client_side_validation && free_tool_generate_social_posts_from_blog_request.nil?
+        fail ArgumentError, "Missing the required parameter 'free_tool_generate_social_posts_from_blog_request' when calling FreeToolsApi.generate_social_posts_from_blog"
+      end
+      # resource path
+      local_var_path = '/tools/blog-to-social-media'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(free_tool_generate_social_posts_from_blog_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FreeToolGenerateSocialPostsFromBlogResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FreeToolsApi.generate_social_posts_from_blog",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FreeToolsApi#generate_social_posts_from_blog\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get the best times to post per network from published studies, with sources
     # Get the best times to post per network from published studies, with sources. The same logic as the free web tool at https://postboost.co/tools/best-time-to-post. No account needed: call it without a token, or with any API token.
     # @param [Hash] opts the optional parameters