postboost 1.0.0 → 1.14.0

data/docs/AccountHealth.md

@@ -0,0 +1,34 @@
+# PostBoost::AccountHealth
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** |  |  |
+| **uuid** | **String** |  |  |
+| **name** | **String** |  |  |
+| **provider** | **String** |  |  |
+| **authorized** | **Boolean** | False when the account must be reconnected. |  |
+| **has_token** | **Boolean** | Whether an access token is stored for the account. |  |
+| **healthy** | **Boolean** | `authorized` and `has_token`: the account can publish. |  |
+| **daily_cap** | [**AccountHealthDailyCap**](AccountHealthDailyCap.md) |  |  |
+| **connection** | [**AccountConnectionHealth**](AccountConnectionHealth.md) |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AccountHealth.new(
+  id: null,
+  uuid: null,
+  name: null,
+  provider: null,
+  authorized: null,
+  has_token: null,
+  healthy: null,
+  daily_cap: null,
+  connection: null
+)
+```
+

data/docs/AccountHealthDailyCap.md

@@ -0,0 +1,20 @@
+# PostBoost::AccountHealthDailyCap
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **limit** | **Integer** | Posts allowed per UTC day for this network. |  |
+| **used_today** | **Integer** | Scheduled, awaiting-approval and published posts counted for today (UTC). |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AccountHealthDailyCap.new(
+  limit: null,
+  used_today: null
+)
+```
+

data/docs/AccountSchedule.md

@@ -0,0 +1,22 @@
+# PostBoost::AccountSchedule
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **Integer** | ID of one of the post's accounts. Entries for accounts the post does not carry are ignored. |  |
+| **date** | **Date** |  |  |
+| **time** | **String** | H:i, read in the request `timezone`. Must not be in the past. |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AccountSchedule.new(
+  account_id: null,
+  date: 2026-11-01,
+  time: 14:30
+)
+```
+

data/docs/AccountsApi.md

@@ -4,10 +4,157 @@ All URIs are relative to *https://postboost.co/app/api*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
+| [**connect_channel**](AccountsApi.md#connect_channel) | **POST** /{workspaceUuid}/accounts/connect/{provider} | Connect a Telegram, Discord or Slack channel |
+| [**create_reconnect_link**](AccountsApi.md#create_reconnect_link) | **POST** /{workspaceUuid}/accounts/{accountUuid}/reconnect-links | Create a reconnect link |
 | [**get_account**](AccountsApi.md#get_account) | **GET** /{workspaceUuid}/accounts/{accountUuid} | Get account |
+| [**get_account_health**](AccountsApi.md#get_account_health) | **GET** /{workspaceUuid}/account-health | Account health |
 | [**list_accounts**](AccountsApi.md#list_accounts) | **GET** /{workspaceUuid}/accounts | List accounts |
 
 
+## connect_channel
+
+> <ChannelAccount> connect_channel(workspace_uuid, provider, connect_channel_input)
+
+Connect a Telegram, Discord or Slack channel
+
+Connects a channel that uses a bot token or a webhook URL instead of a login. The credentials are checked against the network first, stored encrypted and never returned. Connecting the same channel again updates it (`200`) instead of adding a second account. Workspace admins only; counts toward the plan's social account limit.  - **telegram**: `bot_token` from @BotFather and `chat` (the channel's `@username`, or its   numeric id such as `-1001234567890` for a private channel). The bot must be an administrator   of the channel allowed to post messages. - **discord**: `webhook_url` from Channel settings → Integrations → Webhooks   (`https://discord.com/api/webhooks/…`). - **slack**: `webhook_url` of an incoming webhook (`https://hooks.slack.com/services/…`) and an   optional display `name`. Slack posts cannot be deleted from PostBoost, and images must be   publicly reachable.  Webhook URLs on any other host are refused (`422`) before any request is made. 
+
+### 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::AccountsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+provider = 'telegram' # String | 
+connect_channel_input = PostBoost::ConnectChannelInput.new # ConnectChannelInput | 
+
+begin
+  # Connect a Telegram, Discord or Slack channel
+  result = api_instance.connect_channel(workspace_uuid, provider, connect_channel_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AccountsApi->connect_channel: #{e}"
+end
+```
+
+#### Using the connect_channel_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ChannelAccount>, Integer, Hash)> connect_channel_with_http_info(workspace_uuid, provider, connect_channel_input)
+
+```ruby
+begin
+  # Connect a Telegram, Discord or Slack channel
+  data, status_code, headers = api_instance.connect_channel_with_http_info(workspace_uuid, provider, connect_channel_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ChannelAccount>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AccountsApi->connect_channel_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **provider** | **String** |  |  |
+| **connect_channel_input** | [**ConnectChannelInput**](ConnectChannelInput.md) |  |  |
+
+### Return type
+
+[**ChannelAccount**](ChannelAccount.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_reconnect_link
+
+> <ReconnectLink> create_reconnect_link(workspace_uuid, account_uuid)
+
+Create a reconnect link
+
+Creates a single-use link (valid 7 days) that lets someone without a PostBoost login, such as an agency's client, re-authorize this one account on its network. The link only refreshes the connection of this account; signing in as a different profile or page changes nothing. Workspace admins only. Available for Facebook Pages, Instagram, Threads, LinkedIn, TikTok, YouTube and Pinterest. Returns `404` while the feature is not enabled on this instance. 
+
+### 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::AccountsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+account_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the social media account.
+
+begin
+  # Create a reconnect link
+  result = api_instance.create_reconnect_link(workspace_uuid, account_uuid)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AccountsApi->create_reconnect_link: #{e}"
+end
+```
+
+#### Using the create_reconnect_link_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ReconnectLink>, Integer, Hash)> create_reconnect_link_with_http_info(workspace_uuid, account_uuid)
+
+```ruby
+begin
+  # Create a reconnect link
+  data, status_code, headers = api_instance.create_reconnect_link_with_http_info(workspace_uuid, account_uuid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ReconnectLink>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AccountsApi->create_reconnect_link_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **account_uuid** | **String** | UUID of the social media account. |  |
+
+### Return type
+
+[**ReconnectLink**](ReconnectLink.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_account
 
 > <Account> get_account(workspace_uuid, account_uuid)
@@ -79,13 +226,82 @@ end
 - **Accept**: application/json
 
 
+## get_account_health
+
+> <GetAccountHealth200Response> get_account_health(workspace_uuid)
+
+Account health
+
+Pre-flight health of every account in the workspace: whether it is authorized and holds an access token, how much of its daily post cap (per UTC day, scheduled, awaiting approval and published posts) is used today, and its connection health: predicted token expiry, latest publish outcome and where to reconnect it. The `account.token_expiring` and `account.disconnected` webhooks report changes as they happen. 
+
+### 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::AccountsApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+
+begin
+  # Account health
+  result = api_instance.get_account_health(workspace_uuid)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AccountsApi->get_account_health: #{e}"
+end
+```
+
+#### Using the get_account_health_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetAccountHealth200Response>, Integer, Hash)> get_account_health_with_http_info(workspace_uuid)
+
+```ruby
+begin
+  # Account health
+  data, status_code, headers = api_instance.get_account_health_with_http_info(workspace_uuid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetAccountHealth200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AccountsApi->get_account_health_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+
+### Return type
+
+[**GetAccountHealth200Response**](GetAccountHealth200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## list_accounts
 
-> <ListAccounts200Response> list_accounts(workspace_uuid)
+> <ListAccounts200Response> list_accounts(workspace_uuid, opts)
 
 List accounts
 
-Returns all social media accounts connected to the workspace.
+Returns all social media accounts connected to the workspace, newest first. Optional filters narrow the list.
 
 ### Examples
 
@@ -100,10 +316,16 @@ end
 
 api_instance = PostBoost::AccountsApi.new
 workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+opts = {
+  keyword: 'keyword_example', # String | Match the account name or username.
+  group: 'group_example', # String | Only accounts in this account group.
+  providers: ['inner_example'], # Array<String> | Only accounts of these providers (for example `instagram`, `linkedin`).
+  unauthorized: true # Boolean | When `true`, only accounts that need to be reconnected.
+}
 
 begin
   # List accounts
-  result = api_instance.list_accounts(workspace_uuid)
+  result = api_instance.list_accounts(workspace_uuid, opts)
   p result
 rescue PostBoost::ApiError => e
   puts "Error when calling AccountsApi->list_accounts: #{e}"
@@ -114,12 +336,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<ListAccounts200Response>, Integer, Hash)> list_accounts_with_http_info(workspace_uuid)
+> <Array(<ListAccounts200Response>, Integer, Hash)> list_accounts_with_http_info(workspace_uuid, opts)
 
 ```ruby
 begin
   # List accounts
-  data, status_code, headers = api_instance.list_accounts_with_http_info(workspace_uuid)
+  data, status_code, headers = api_instance.list_accounts_with_http_info(workspace_uuid, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <ListAccounts200Response>
@@ -133,6 +355,10 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **keyword** | **String** | Match the account name or username. | [optional] |
+| **group** | **String** | Only accounts in this account group. | [optional] |
+| **providers** | [**Array&lt;String&gt;**](String.md) | Only accounts of these providers (for example &#x60;instagram&#x60;, &#x60;linkedin&#x60;). | [optional] |
+| **unauthorized** | **Boolean** | When &#x60;true&#x60;, only accounts that need to be reconnected. | [optional] |
 
 ### Return type
 

data/docs/ActivityApi.md

@@ -0,0 +1,87 @@
+# PostBoost::ActivityApi
+
+All URIs are relative to *https://postboost.co/app/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**list_api_activity**](ActivityApi.md#list_api_activity) | **GET** /{workspaceUuid}/activity | List API activity |
+
+
+## list_api_activity
+
+> <ListApiActivity200Response> list_api_activity(workspace_uuid, opts)
+
+List API activity
+
+Every write request (`POST`, `PUT`, `DELETE`) made through the API in this workspace, newest first, with the client that made it and its outcome. Kept for 90 days. Send an `X-PostBoost-Client` header (for example `my-agent/1.2`) to label your requests; otherwise the `User-Agent` is recorded. 
+
+### 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::ActivityApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+opts = {
+  outcome: PostBoost::ApiActivityOutcome::CREATED, # ApiActivityOutcome | 
+  client: 'client_example', # String | Client label prefix, for example `mcp`.
+  since: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Only entries at or after this time (UTC).
+  page: 56 # Integer | 
+}
+
+begin
+  # List API activity
+  result = api_instance.list_api_activity(workspace_uuid, opts)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling ActivityApi->list_api_activity: #{e}"
+end
+```
+
+#### Using the list_api_activity_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListApiActivity200Response>, Integer, Hash)> list_api_activity_with_http_info(workspace_uuid, opts)
+
+```ruby
+begin
+  # List API activity
+  data, status_code, headers = api_instance.list_api_activity_with_http_info(workspace_uuid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListApiActivity200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling ActivityApi->list_api_activity_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **outcome** | [**ApiActivityOutcome**](.md) |  | [optional] |
+| **client** | **String** | Client label prefix, for example &#x60;mcp&#x60;. | [optional] |
+| **since** | **Time** | Only entries at or after this time (UTC). | [optional] |
+| **page** | **Integer** |  | [optional][default to 1] |
+
+### Return type
+
+[**ListApiActivity200Response**](ListApiActivity200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+

data/docs/AddCompetitor202Response.md

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

data/docs/AddCompetitor409Response.md

@@ -0,0 +1,20 @@
+# PostBoost::AddCompetitor409Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **message** | **String** |  | [optional] |
+| **competitor_id** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AddCompetitor409Response.new(
+  message: null,
+  competitor_id: null
+)
+```
+

data/docs/AddPostToQueueRequest.md

@@ -0,0 +1,18 @@
+# PostBoost::AddPostToQueueRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **timezone** | **String** | Accepted and validated for consistency with the other scheduling endpoints; queue slots are always taken from the workspace posting schedule. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AddPostToQueueRequest.new(
+  timezone: America/New_York
+)
+```
+

data/docs/AgentPageMeta.md

@@ -0,0 +1,24 @@
+# PostBoost::AgentPageMeta
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **current_page** | **Integer** |  |  |
+| **last_page** | **Integer** |  |  |
+| **per_page** | **Integer** |  |  |
+| **total** | **Integer** |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AgentPageMeta.new(
+  current_page: null,
+  last_page: null,
+  per_page: null,
+  total: null
+)
+```
+

data/docs/AgentProposal.md

@@ -0,0 +1,44 @@
+# PostBoost::AgentProposal
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **uuid** | **String** |  |  |
+| **run_uuid** | **String** |  | [optional] |
+| **post_uuid** | **String** |  | [optional] |
+| **account_id** | **Integer** |  | [optional] |
+| **kind** | **String** | `hold_post` moves the post back to draft; `edit_caption` replaces one caption. |  |
+| **severity** | **String** |  |  |
+| **reason** | **String** |  |  |
+| **payload** | **Hash<String, Object>** | The proposed change. `hold_post`: `reasons[]` (`code`, `account_id`, `message`, `severity`) and `scheduled_at`. `edit_caption`: `version_account_id` (0 = original), `item_index`, `before`, `after`. Both carry `post_updated_at`.  |  |
+| **status** | **String** |  |  |
+| **decided_at** | **Time** |  | [optional] |
+| **applied_at** | **Time** |  | [optional] |
+| **note** | **String** |  | [optional] |
+| **error** | **String** | Why a proposal went stale or failed. | [optional] |
+| **created_at** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AgentProposal.new(
+  uuid: null,
+  run_uuid: null,
+  post_uuid: null,
+  account_id: null,
+  kind: null,
+  severity: null,
+  reason: null,
+  payload: null,
+  status: null,
+  decided_at: null,
+  applied_at: null,
+  note: null,
+  error: null,
+  created_at: null
+)
+```
+

data/docs/AgentProposalDecision.md

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

data/docs/AgentRun.md

@@ -0,0 +1,44 @@
+# PostBoost::AgentRun
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **uuid** | **String** |  |  |
+| **agent_uuid** | **String** |  |  |
+| **agent_type** | **String** |  |  |
+| **trigger** | **String** |  |  |
+| **status** | **String** |  |  |
+| **started_at** | **Time** |  | [optional] |
+| **finished_at** | **Time** |  | [optional] |
+| **items_checked** | **Integer** |  |  |
+| **proposals_created** | **Integer** |  |  |
+| **credits_used** | **Integer** | AI credits this run used. |  |
+| **summary** | **String** |  | [optional] |
+| **error** | **String** |  | [optional] |
+| **created_at** | **Time** |  | [optional] |
+| **proposals** | [**Array<AgentProposal>**](AgentProposal.md) | Only on `GET /agent-runs/{runUuid}`. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AgentRun.new(
+  uuid: null,
+  agent_uuid: null,
+  agent_type: null,
+  trigger: null,
+  status: null,
+  started_at: null,
+  finished_at: null,
+  items_checked: null,
+  proposals_created: null,
+  credits_used: null,
+  summary: null,
+  error: null,
+  created_at: null,
+  proposals: null
+)
+```
+