postboost 1.37.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fb6e503e4691a3ceb05df6a0022c1b7e4de7681eb11f1a77892851bdf0dca6c
-  data.tar.gz: 7f8a0b69cee9173bfd60de6db69364d4843554ce03b65811b0acae38098dc23c
+  metadata.gz: c7c82e043c8ad256aea7ad6a9a64d3549ec5681fbcc40fa2e4308ad521aa2acb
+  data.tar.gz: 611905e90c5728324eaad40dd3985dd65d344feb2874f084187a08a5093e3b93
 SHA512:
-  metadata.gz: 8a6d82ccf3be478e2fb5c9b10e5fa2a91b20dc71811624575c99d3defdd6799dc62c83155ba44a538c289cb01654804c3836306a4b4811188decf805edba8f49
-  data.tar.gz: adbb73d6e246794adf1fc93bcc927f6e7290bb25fb7d9441c8c6bb64d0a9e1ad98811eb6aae23547125cce7494a755d00a4a273f0a36351e713c6e31383d64ec
+  metadata.gz: ac79e1061617233d9363da6035288a0be1a014fcbf244c15cf8b0bc466f4c1ce0ccb49f7ca26f9f0958708758b21958b4817295e860418a1ba3b10430ab58de4
+  data.tar.gz: '07280c347b567da3121cc7c7570fae41fdb666e471eb7e7e88895ecb43b26f4d5eea8c489dff1284f2648b491e9bb25e73097342a6d28440df5352388eb8b265'

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.37.0 |
+| **Version** | v1.39.0 |
 
 ## Quick start
 
@@ -98,8 +98,10 @@ Class | Method | HTTP request | Description
 *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* | [**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
 *PostBoost::FreeToolsApi* | [**list_free_tools**](docs/FreeToolsApi.md#list_free_tools) | **GET** /tools | List the free tools
 *PostBoost::FreeToolsApi* | [**preview_post**](docs/FreeToolsApi.md#preview_post) | **POST** /tools/social-media-post-preview | Preview where a post folds and when its image is cropped on Instagram, X, LinkedIn and Facebook

data/docs/Account.md

@@ -9,7 +9,7 @@
 | **name** | **String** |  |  |
 | **username** | **String** |  |  |
 | **image** | **String** |  | [optional] |
-| **provider** | **String** |  |  |
+| **provider** | **String** | Network key. Known values: `twitter`, `facebook_page`, `instagram`, `instagram_standalone`, `threads`, `linkedin`, `linkedin_page`, `tiktok`, `youtube`, `pinterest`, `gbp`, `bluesky`, `mastodon`, `pixelfed`, `telegram`, `discord`, `slack`. New networks add new keys, so treat unknown values as valid.  |  |
 | **data** | **Object** | Provider-specific metadata. |  |
 | **authorized** | **Boolean** |  |  |
 | **profile_url** | **String** | Public URL of the account's profile on the network, when known. | [optional] |
@@ -31,7 +31,7 @@ instance = PostBoost::Account.new(
   name: My Instagram,
   username: myhandle,
   image: null,
-  provider: null,
+  provider: instagram,
   data: null,
   authorized: null,
   profile_url: null,

data/docs/AnalyticsApi.md

@@ -762,7 +762,7 @@ end
 
 Update the report branding
 
-Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo`. Admins and members only.
+Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo` (a multipart file upload, so it is not an MCP tool). Admins and members only.
 
 ### Examples
 

data/docs/CreatePost201Response.md

@@ -11,9 +11,9 @@
 | **accounts** | [**Array<Account>**](Account.md) |  |  |
 | **versions** | [**Array<PostVersion>**](PostVersion.md) |  |  |
 | **tags** | [**Array<Tag>**](Tag.md) |  |  |
-| **scheduled_at** | **Time** |  | [optional] |
-| **published_at** | **Time** |  | [optional] |
-| **created_at** | **Time** |  |  |
+| **scheduled_at** | **String** | `Y-m-d H:i:s` in UTC (not RFC 3339). | [optional] |
+| **published_at** | **String** | `Y-m-d H:i:s` in UTC (not RFC 3339). | [optional] |
+| **created_at** | **String** | `Y-m-d H:i:s` in UTC (not RFC 3339). |  |
 | **trashed** | **Boolean** |  |  |
 | **warnings** | [**Array<PostWarning>**](PostWarning.md) | Present only when there is at least one warning. | [optional] |
 
@@ -30,9 +30,9 @@ instance = PostBoost::CreatePost201Response.new(
   accounts: null,
   versions: null,
   tags: null,
-  scheduled_at: null,
-  published_at: null,
-  created_at: null,
+  scheduled_at: 2026-10-16 10:00:00,
+  published_at: 2026-10-16 10:00:04,
+  created_at: 2026-10-16 09:58:12,
   trashed: null,
   warnings: null
 )

data/docs/FreeToolGenerateHooksRequest.md

@@ -0,0 +1,26 @@
+# PostBoost::FreeToolGenerateHooksRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **topic** | **String** | What the post is about. |  |
+| **tone** | **String** | Tone of the hooks, as on the caption generator. | [optional][default to 'friendly'] |
+| **count** | **Integer** | How many hooks to write. | [optional][default to 5] |
+| **network** | **String** | The network the text is written for. | [optional][default to 'instagram'] |
+| **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::FreeToolGenerateHooksRequest.new(
+  topic: null,
+  tone: null,
+  count: null,
+  network: null,
+  workspace: null
+)
+```
+

data/docs/FreeToolGenerateHooksResponse.md

@@ -0,0 +1,24 @@
+# PostBoost::FreeToolGenerateHooksResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **hooks** | [**Array<FreeToolGenerateHooksResponseHooksInner>**](FreeToolGenerateHooksResponseHooksInner.md) | `count` hooks in several styles. | [optional] |
+| **notice** | **String** | Only while AI is switched off: the hooks are templates from the free library (getHookTemplates) with the topic filled in, free of charge. | [optional] |
+| **credits_spent** | **Integer** | AI credits this call took from the workspace: 1, or 0 for a cached result. | [optional] |
+| **cached** | **Boolean** | True when the same request was answered before (free). | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateHooksResponse.new(
+  hooks: null,
+  notice: null,
+  credits_spent: null,
+  cached: null
+)
+```
+

data/docs/FreeToolGenerateHooksResponseHooksInner.md

@@ -0,0 +1,20 @@
+# PostBoost::FreeToolGenerateHooksResponseHooksInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **text** | **String** | The hook. | [optional] |
+| **category** | **String** | Hook style, as in getHookTemplates. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGenerateHooksResponseHooksInner.new(
+  text: null,
+  category: null
+)
+```
+

data/docs/FreeToolGetHookTemplatesResponse.md

@@ -0,0 +1,20 @@
+# PostBoost::FreeToolGetHookTemplatesResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **hooks** | [**Array<FreeToolGetHookTemplatesResponseHooksInner>**](FreeToolGetHookTemplatesResponseHooksInner.md) |  | [optional] |
+| **total** | **Integer** | Number of hooks returned. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGetHookTemplatesResponse.new(
+  hooks: null,
+  total: null
+)
+```
+

data/docs/FreeToolGetHookTemplatesResponseHooksInner.md

@@ -0,0 +1,24 @@
+# PostBoost::FreeToolGetHookTemplatesResponseHooksInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **text** | **String** | The hook, with `{topic}` filled in when a topic was given. | [optional] |
+| **template** | **String** | The template with its `{topic}` placeholder. | [optional] |
+| **category** | **String** | Hook style. | [optional] |
+| **networks** | **Array<String>** | Networks the hook suits. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::FreeToolGetHookTemplatesResponseHooksInner.new(
+  text: null,
+  template: null,
+  category: null,
+  networks: null
+)
+```
+

data/docs/FreeToolsApi.md

@@ -16,8 +16,10 @@ All URIs are relative to *https://postboost.co/app/api*
 | [**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 |
 | [**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 |
 | [**list_free_tools**](FreeToolsApi.md#list_free_tools) | **GET** /tools | List the free tools |
 | [**preview_post**](FreeToolsApi.md#preview_post) | **POST** /tools/social-media-post-preview | Preview where a post folds and when its image is cropped on Instagram, X, LinkedIn and Facebook |
@@ -802,6 +804,75 @@ end
 - **Accept**: application/json
 
 
+## generate_hooks
+
+> <FreeToolGenerateHooksResponse> generate_hooks(free_tool_generate_hooks_request)
+
+Generate hooks (opening lines) for a social media post with AI (needs a token, spends AI credits)
+
+Generate hooks (opening lines) for a social media post with AI (needs a token, spends AI credits). The same logic as the free web tool at https://postboost.co/tools/hook-generator. Needs an API token (a scoped key needs the `ai` ability and pays with its own workspace). A new generation spends 1 AI credit of the workspace you name (or your active workspace); a repeated identical request is answered from the cache for free.
+
+### 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_hooks_request = PostBoost::FreeToolGenerateHooksRequest.new({topic: 'topic_example'}) # FreeToolGenerateHooksRequest | 
+
+begin
+  # Generate hooks (opening lines) for a social media post with AI (needs a token, spends AI credits)
+  result = api_instance.generate_hooks(free_tool_generate_hooks_request)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->generate_hooks: #{e}"
+end
+```
+
+#### Using the generate_hooks_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FreeToolGenerateHooksResponse>, Integer, Hash)> generate_hooks_with_http_info(free_tool_generate_hooks_request)
+
+```ruby
+begin
+  # Generate hooks (opening lines) for a social media post with AI (needs a token, spends AI credits)
+  data, status_code, headers = api_instance.generate_hooks_with_http_info(free_tool_generate_hooks_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FreeToolGenerateHooksResponse>
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->generate_hooks_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **free_tool_generate_hooks_request** | [**FreeToolGenerateHooksRequest**](FreeToolGenerateHooksRequest.md) |  |  |
+
+### Return type
+
+[**FreeToolGenerateHooksResponse**](FreeToolGenerateHooksResponse.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## generate_qr_code
 
 > <FreeToolGenerateQrCodeResponse> generate_qr_code(free_tool_generate_qr_code_request)
@@ -932,6 +1003,78 @@ No authorization required
 - **Accept**: application/json
 
 
+## get_hook_templates
+
+> <FreeToolGetHookTemplatesResponse> get_hook_templates(opts)
+
+Get free hook templates for social media posts, filtered by style and network
+
+Get free hook templates for social media posts, filtered by style and network. The same logic as the free web tool at https://postboost.co/tools/hook-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
+opts = {
+  topic: 'topic_example', # String | 
+  category: 'question', # String | 
+  network: 'instagram', # String | 
+  search: 'search_example' # String | 
+}
+
+begin
+  # Get free hook templates for social media posts, filtered by style and network
+  result = api_instance.get_hook_templates(opts)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->get_hook_templates: #{e}"
+end
+```
+
+#### Using the get_hook_templates_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<FreeToolGetHookTemplatesResponse>, Integer, Hash)> get_hook_templates_with_http_info(opts)
+
+```ruby
+begin
+  # Get free hook templates for social media posts, filtered by style and network
+  data, status_code, headers = api_instance.get_hook_templates_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <FreeToolGetHookTemplatesResponse>
+rescue PostBoost::ApiError => e
+  puts "Error when calling FreeToolsApi->get_hook_templates_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **topic** | **String** |  | [optional] |
+| **category** | **String** |  | [optional] |
+| **network** | **String** |  | [optional] |
+| **search** | **String** |  | [optional] |
+
+### Return type
+
+[**FreeToolGetHookTemplatesResponse**](FreeToolGetHookTemplatesResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_image_sizes
 
 > <FreeToolGetImageSizesResponse> get_image_sizes(opts)

data/docs/Post.md

@@ -11,9 +11,9 @@
 | **accounts** | [**Array<Account>**](Account.md) |  |  |
 | **versions** | [**Array<PostVersion>**](PostVersion.md) |  |  |
 | **tags** | [**Array<Tag>**](Tag.md) |  |  |
-| **scheduled_at** | **Time** |  | [optional] |
-| **published_at** | **Time** |  | [optional] |
-| **created_at** | **Time** |  |  |
+| **scheduled_at** | **String** | `Y-m-d H:i:s` in UTC (not RFC 3339). | [optional] |
+| **published_at** | **String** | `Y-m-d H:i:s` in UTC (not RFC 3339). | [optional] |
+| **created_at** | **String** | `Y-m-d H:i:s` in UTC (not RFC 3339). |  |
 | **trashed** | **Boolean** |  |  |
 
 ## Example
@@ -29,9 +29,9 @@ instance = PostBoost::Post.new(
   accounts: null,
   versions: null,
   tags: null,
-  scheduled_at: null,
-  published_at: null,
-  created_at: null,
+  scheduled_at: 2026-10-16 10:00:00,
+  published_at: 2026-10-16 10:00:04,
+  created_at: 2026-10-16 09:58:12,
   trashed: null
 )
 ```

data/docs/WebhookEnvelope.md

@@ -0,0 +1,26 @@
+# PostBoost::WebhookEnvelope
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **event** | **String** |  |  |
+| **id** | **String** | Delivery ID, one per event. Retries and manual resends repeat it. |  |
+| **occurred_at** | **Time** | When the event happened (ISO 8601, UTC). |  |
+| **workspace_uuid** | **String** | The workspace the event belongs to (null only on instance-wide system webhooks). Also sent as the `X-PostBoost-Workspace` header. |  |
+| **data** | **Hash<String, Object>** | The post (`post.*`, as `getPost` returns it, plus `account` on per-account events), the account (`account.*`) or the reply draft (`inbox.*`). |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::WebhookEnvelope.new(
+  event: null,
+  id: null,
+  occurred_at: 2026-10-12T10:00:03+00:00,
+  workspace_uuid: null,
+  data: null
+)
+```
+

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.37.0
+The version of the OpenAPI document: 1.39.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.37.0
+The version of the OpenAPI document: 1.39.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.37.0
+The version of the OpenAPI document: 1.39.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.37.0
+The version of the OpenAPI document: 1.39.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.37.0
+The version of the OpenAPI document: 1.39.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.37.0
+The version of the OpenAPI document: 1.39.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -759,7 +759,7 @@ module PostBoost
     end
 
     # Update the report branding
-    # Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo`. Admins and members only.
+    # Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo` (a multipart file upload, so it is not an MCP tool). Admins and members only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param report_branding_input [ReportBrandingInput] 
     # @param [Hash] opts the optional parameters
@@ -770,7 +770,7 @@ module PostBoost
     end
 
     # Update the report branding
-    # Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo`. Admins and members only.
+    # Name, colour and footer of PDF reports. Fields you leave out keep their value. Upload the logo with `uploadReportBrandingLogo` (a multipart file upload, so it is not an MCP tool). Admins and members only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param report_branding_input [ReportBrandingInput] 
     # @param [Hash] opts the optional parameters

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.37.0
+The version of the OpenAPI document: 1.39.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0