postboost 1.0.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69b47ffd2944596cfb6f7fe0d7b48f3f2331274977ab92955f8a6e6ae2e14920
-  data.tar.gz: 2d81ba41fd16eb6e79e64c9285753ff960cea738e6facbc6528b5dc50f5db62e
+  metadata.gz: a05b82d879c23d3d2fb7a4b154371e5558ed060958c4fb0a1494c9fed828840b
+  data.tar.gz: 6b7c7e51383665387fae7811f5067e8418a6e73d72a5b70bde220f2f64ccdd81
 SHA512:
-  metadata.gz: ddd0dfd8a3b77864e846970aeff826e882e28bf0f5213431d8096e12730b3f0043683720689205d1b5b38c325bb387e0aa10d25a76f0ab0df55abec460c9eda4
-  data.tar.gz: 4a07a1a17a732112644b0b1b5b8c5885895834d646371d48c477e35c49218e080ba9e5b733d89ba136d0ab0dcc665a6bd31b103c3d5c9b950b84ee129e689e00
+  metadata.gz: 3da2b728cf87252a8160fecb659947ea25a2be4e4476f67e77fa53da27e9c98e75737e6281defa0528791842fdd66ae511ac9717e38249c1ab14331dcb993e19
+  data.tar.gz: b99793de48918b19c819164b975dd49969c922d05de13e96b6911e53676ffa5532f88daf007a635ca7abf9e2cdaf6fe762b36b282a412f4f4da0e8ca77e15089

data/README.md

@@ -0,0 +1,119 @@
+# PostBoost Ruby SDK
+
+Official Ruby client for the [PostBoost API](https://postboost.co/docs/api).
+
+## Install
+
+```bash
+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.8.0 |
+
+## Quick start
+
+```ruby
+require 'postboost'
+
+PostBoost.configure { |c| c.access_token = ENV['POSTBOOST_API_TOKEN'] }
+
+api = PostBoost::PostsApi.new
+posts = api.list_posts('YOUR_WORKSPACE_UUID')
+posts.each { |p| puts p.uuid }
+```
+
+---
+
+## Documentation for API Endpoints
+
+All URIs are relative to *https://postboost.co/app/api*
+
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+*PostBoost::AIApi* | [**blog_to_social**](docs/AIApi.md#blog_to_social) | **POST** /{workspaceUuid}/ai/blog-to-social | Generate social media captions from a blog post
+*PostBoost::AIApi* | [**image_alt_text**](docs/AIApi.md#image_alt_text) | **POST** /{workspaceUuid}/ai/image-alt-text | Generate alt text for a media image using AI
+*PostBoost::AIApi* | [**image_edit**](docs/AIApi.md#image_edit) | **POST** /{workspaceUuid}/ai/image-edit | Edit an existing media image using AI
+*PostBoost::AIApi* | [**image_generate**](docs/AIApi.md#image_generate) | **POST** /{workspaceUuid}/ai/image-generate | Generate social media images from a caption
+*PostBoost::AIApi* | [**image_prompt**](docs/AIApi.md#image_prompt) | **POST** /{workspaceUuid}/ai/image-prompt | Build an optimized image prompt from a social media caption
+*PostBoost::AIApi* | [**image_variations**](docs/AIApi.md#image_variations) | **POST** /{workspaceUuid}/ai/image-variations | Generate variations of an existing media image
+*PostBoost::AccountsApi* | [**get_account**](docs/AccountsApi.md#get_account) | **GET** /{workspaceUuid}/accounts/{accountUuid} | Get account
+*PostBoost::AccountsApi* | [**list_accounts**](docs/AccountsApi.md#list_accounts) | **GET** /{workspaceUuid}/accounts | List accounts
+*PostBoost::AnalyticsApi* | [**get_account_analytics**](docs/AnalyticsApi.md#get_account_analytics) | **GET** /{workspaceUuid}/analytics/accounts/{accountUuid} | Get account analytics
+*PostBoost::AnalyticsApi* | [**get_analytics_summary**](docs/AnalyticsApi.md#get_analytics_summary) | **GET** /{workspaceUuid}/analytics | Get analytics summary
+*PostBoost::AnalyticsApi* | [**get_best_posting_times**](docs/AnalyticsApi.md#get_best_posting_times) | **GET** /{workspaceUuid}/analytics/best-times | Get best posting times
+*PostBoost::AnalyticsApi* | [**get_post_analytics_0**](docs/AnalyticsApi.md#get_post_analytics_0) | **GET** /{workspaceUuid}/posts/{postUuid}/analytics | Get post analytics
+*PostBoost::AnalyticsApi* | [**get_posting_times**](docs/AnalyticsApi.md#get_posting_times) | **GET** /{workspaceUuid}/analytics/posting-times | Get posting times heatmap
+*PostBoost::MediaApi* | [**abort_chunked_upload**](docs/MediaApi.md#abort_chunked_upload) | **DELETE** /{workspaceUuid}/media/chunked/{uploadUuid} | Abort chunked upload
+*PostBoost::MediaApi* | [**complete_chunked_upload**](docs/MediaApi.md#complete_chunked_upload) | **POST** /{workspaceUuid}/media/chunked/{uploadUuid}/complete | Complete chunked upload
+*PostBoost::MediaApi* | [**create_media_folder**](docs/MediaApi.md#create_media_folder) | **POST** /{workspaceUuid}/media/folders | Create media folder
+*PostBoost::MediaApi* | [**delete_media_bulk**](docs/MediaApi.md#delete_media_bulk) | **DELETE** /{workspaceUuid}/media | Delete media (bulk)
+*PostBoost::MediaApi* | [**delete_media_folder**](docs/MediaApi.md#delete_media_folder) | **DELETE** /{workspaceUuid}/media/folders/{folderUuid} | Delete media folder
+*PostBoost::MediaApi* | [**get_media**](docs/MediaApi.md#get_media) | **GET** /{workspaceUuid}/media/{mediaUuid} | Get media
+*PostBoost::MediaApi* | [**get_remote_upload_status**](docs/MediaApi.md#get_remote_upload_status) | **GET** /{workspaceUuid}/media/remote/{downloadId}/status | Get remote upload status
+*PostBoost::MediaApi* | [**initiate_chunked_upload**](docs/MediaApi.md#initiate_chunked_upload) | **POST** /{workspaceUuid}/media/chunked/initiate | Initiate chunked upload
+*PostBoost::MediaApi* | [**initiate_remote_upload**](docs/MediaApi.md#initiate_remote_upload) | **POST** /{workspaceUuid}/media/remote/initiate | Initiate remote upload
+*PostBoost::MediaApi* | [**list_media**](docs/MediaApi.md#list_media) | **GET** /{workspaceUuid}/media | List media
+*PostBoost::MediaApi* | [**list_media_folders**](docs/MediaApi.md#list_media_folders) | **GET** /{workspaceUuid}/media/folders | List media folders
+*PostBoost::MediaApi* | [**update_media**](docs/MediaApi.md#update_media) | **PUT** /{workspaceUuid}/media/{mediaUuid} | Update media
+*PostBoost::MediaApi* | [**update_media_folder**](docs/MediaApi.md#update_media_folder) | **PUT** /{workspaceUuid}/media/folders/{folderUuid} | Update media folder
+*PostBoost::MediaApi* | [**upload_chunk**](docs/MediaApi.md#upload_chunk) | **POST** /{workspaceUuid}/media/chunked/{uploadUuid}/upload | Upload a chunk
+*PostBoost::MediaApi* | [**upload_media**](docs/MediaApi.md#upload_media) | **POST** /{workspaceUuid}/media | Upload media (binary)
+*PostBoost::MentionsApi* | [**create_mention**](docs/MentionsApi.md#create_mention) | **POST** /{workspaceUuid}/mentions | Create mention
+*PostBoost::MentionsApi* | [**delete_mention**](docs/MentionsApi.md#delete_mention) | **DELETE** /{workspaceUuid}/mentions/{mentionId} | Delete mention
+*PostBoost::MentionsApi* | [**get_mention**](docs/MentionsApi.md#get_mention) | **GET** /{workspaceUuid}/mentions/{mentionId} | Get mention
+*PostBoost::MentionsApi* | [**list_mentions**](docs/MentionsApi.md#list_mentions) | **GET** /{workspaceUuid}/mentions | List mentions
+*PostBoost::MentionsApi* | [**update_mention**](docs/MentionsApi.md#update_mention) | **PUT** /{workspaceUuid}/mentions/{mentionId} | Update mention
+*PostBoost::PostsApi* | [**add_post_to_queue**](docs/PostsApi.md#add_post_to_queue) | **POST** /{workspaceUuid}/posts/add-to-queue/{postUuid} | Add post to queue
+*PostBoost::PostsApi* | [**approve_post**](docs/PostsApi.md#approve_post) | **POST** /{workspaceUuid}/posts/approve/{postUuid} | Approve post
+*PostBoost::PostsApi* | [**create_post**](docs/PostsApi.md#create_post) | **POST** /{workspaceUuid}/posts | Create post
+*PostBoost::PostsApi* | [**delete_post**](docs/PostsApi.md#delete_post) | **DELETE** /{workspaceUuid}/posts/{postUuid} | Delete post
+*PostBoost::PostsApi* | [**delete_posts_bulk**](docs/PostsApi.md#delete_posts_bulk) | **DELETE** /{workspaceUuid}/posts | Delete posts (bulk)
+*PostBoost::PostsApi* | [**get_post**](docs/PostsApi.md#get_post) | **GET** /{workspaceUuid}/posts/{postUuid} | Get post
+*PostBoost::PostsApi* | [**get_post_analytics**](docs/PostsApi.md#get_post_analytics) | **GET** /{workspaceUuid}/posts/{postUuid}/analytics | Get post analytics
+*PostBoost::PostsApi* | [**list_posts**](docs/PostsApi.md#list_posts) | **GET** /{workspaceUuid}/posts | List posts
+*PostBoost::PostsApi* | [**retry_post_account**](docs/PostsApi.md#retry_post_account) | **POST** /{workspaceUuid}/posts/retry/{postUuid}/{accountUuid} | Retry publishing to one account
+*PostBoost::PostsApi* | [**schedule_post**](docs/PostsApi.md#schedule_post) | **POST** /{workspaceUuid}/posts/schedule/{postUuid} | Schedule post
+*PostBoost::PostsApi* | [**update_post**](docs/PostsApi.md#update_post) | **PUT** /{workspaceUuid}/posts/{postUuid} | Update post
+*PostBoost::ReceiptsApi* | [**create_receipt**](docs/ReceiptsApi.md#create_receipt) | **POST** /panel/receipts | Create receipt
+*PostBoost::ReceiptsApi* | [**delete_receipt**](docs/ReceiptsApi.md#delete_receipt) | **DELETE** /panel/receipts/{receiptUuid} | Delete receipt
+*PostBoost::ReceiptsApi* | [**delete_receipts_bulk**](docs/ReceiptsApi.md#delete_receipts_bulk) | **DELETE** /panel/receipts | Delete receipts (bulk)
+*PostBoost::ReceiptsApi* | [**get_receipt**](docs/ReceiptsApi.md#get_receipt) | **GET** /panel/receipts/{receiptUuid} | Get receipt
+*PostBoost::ReceiptsApi* | [**list_receipts**](docs/ReceiptsApi.md#list_receipts) | **GET** /panel/receipts | List receipts
+*PostBoost::ReceiptsApi* | [**update_receipt**](docs/ReceiptsApi.md#update_receipt) | **PUT** /panel/receipts/{receiptUuid} | Update receipt
+*PostBoost::SubscriptionsApi* | [**add_generic_subscription**](docs/SubscriptionsApi.md#add_generic_subscription) | **POST** /panel/workspaces/{workspaceUuid}/subscription/generic | Add generic subscription
+*PostBoost::SubscriptionsApi* | [**cancel_subscription**](docs/SubscriptionsApi.md#cancel_subscription) | **POST** /panel/workspaces/{workspaceUuid}/subscription/cancel | Cancel subscription
+*PostBoost::SubscriptionsApi* | [**change_subscription_plan**](docs/SubscriptionsApi.md#change_subscription_plan) | **PUT** /panel/workspaces/{workspaceUuid}/subscription/change-plan | Change subscription plan
+*PostBoost::SubscriptionsApi* | [**checkout_subscription**](docs/SubscriptionsApi.md#checkout_subscription) | **POST** /panel/workspaces/{workspaceUuid}/subscription/new | New subscription checkout
+*PostBoost::SubscriptionsApi* | [**create_subscription**](docs/SubscriptionsApi.md#create_subscription) | **POST** /panel/workspaces/{workspaceUuid}/subscription | Create subscription
+*PostBoost::SubscriptionsApi* | [**delete_subscription**](docs/SubscriptionsApi.md#delete_subscription) | **DELETE** /panel/workspaces/{workspaceUuid}/subscription | Delete subscription
+*PostBoost::SubscriptionsApi* | [**get_subscription**](docs/SubscriptionsApi.md#get_subscription) | **GET** /panel/workspaces/{workspaceUuid}/subscription | Get subscription
+*PostBoost::SubscriptionsApi* | [**remove_generic_subscription**](docs/SubscriptionsApi.md#remove_generic_subscription) | **DELETE** /panel/workspaces/{workspaceUuid}/subscription/generic | Remove generic subscription
+*PostBoost::SubscriptionsApi* | [**resume_subscription**](docs/SubscriptionsApi.md#resume_subscription) | **POST** /panel/workspaces/{workspaceUuid}/subscription/resume | Resume subscription
+*PostBoost::SubscriptionsApi* | [**update_subscription**](docs/SubscriptionsApi.md#update_subscription) | **PUT** /panel/workspaces/{workspaceUuid}/subscription | Update subscription
+*PostBoost::TagsApi* | [**create_tag**](docs/TagsApi.md#create_tag) | **POST** /{workspaceUuid}/tags | Create tag
+*PostBoost::TagsApi* | [**delete_tag**](docs/TagsApi.md#delete_tag) | **DELETE** /{workspaceUuid}/tags/{tagUuid} | Delete tag
+*PostBoost::TagsApi* | [**get_tag**](docs/TagsApi.md#get_tag) | **GET** /{workspaceUuid}/tags/{tagUuid} | Get tag
+*PostBoost::TagsApi* | [**list_tags**](docs/TagsApi.md#list_tags) | **GET** /{workspaceUuid}/tags | List tags
+*PostBoost::TagsApi* | [**update_tag**](docs/TagsApi.md#update_tag) | **PUT** /{workspaceUuid}/tags/{tagUuid} | Update tag
+*PostBoost::UsersApi* | [**create_user**](docs/UsersApi.md#create_user) | **POST** /panel/users | Create user
+*PostBoost::UsersApi* | [**delete_user**](docs/UsersApi.md#delete_user) | **DELETE** /panel/users/{userId} | Delete user
+*PostBoost::UsersApi* | [**delete_users_bulk**](docs/UsersApi.md#delete_users_bulk) | **DELETE** /panel/users | Delete users (bulk)
+*PostBoost::UsersApi* | [**get_user**](docs/UsersApi.md#get_user) | **GET** /panel/users/{userId} | Get user
+*PostBoost::UsersApi* | [**list_users**](docs/UsersApi.md#list_users) | **GET** /panel/users | List users
+*PostBoost::UsersApi* | [**update_user**](docs/UsersApi.md#update_user) | **PUT** /panel/users/{userId} | Update user
+*PostBoost::WorkspacesApi* | [**add_user_to_workspace**](docs/WorkspacesApi.md#add_user_to_workspace) | **POST** /panel/workspaces/{workspaceUuid}/users | Add user to workspace
+*PostBoost::WorkspacesApi* | [**create_workspace**](docs/WorkspacesApi.md#create_workspace) | **POST** /panel/workspaces | Create workspace
+*PostBoost::WorkspacesApi* | [**delete_workspace**](docs/WorkspacesApi.md#delete_workspace) | **DELETE** /panel/workspaces/{workspaceUuid} | Delete workspace
+*PostBoost::WorkspacesApi* | [**delete_workspaces_bulk**](docs/WorkspacesApi.md#delete_workspaces_bulk) | **DELETE** /panel/workspaces | Delete workspaces (bulk)
+*PostBoost::WorkspacesApi* | [**get_workspace**](docs/WorkspacesApi.md#get_workspace) | **GET** /panel/workspaces/{workspaceUuid} | Get workspace
+*PostBoost::WorkspacesApi* | [**get_workspace_ai_credits**](docs/WorkspacesApi.md#get_workspace_ai_credits) | **GET** /panel/workspaces/{workspaceUuid}/ai-credits | Get workspace AI credits
+*PostBoost::WorkspacesApi* | [**list_my_workspaces**](docs/WorkspacesApi.md#list_my_workspaces) | **GET** /workspaces | List my workspaces
+*PostBoost::WorkspacesApi* | [**list_workspaces**](docs/WorkspacesApi.md#list_workspaces) | **GET** /panel/workspaces | List workspaces
+*PostBoost::WorkspacesApi* | [**remove_user_from_workspace**](docs/WorkspacesApi.md#remove_user_from_workspace) | **DELETE** /panel/workspaces/{workspaceUuid}/users | Remove user from workspace
+*PostBoost::WorkspacesApi* | [**update_workspace**](docs/WorkspacesApi.md#update_workspace) | **PUT** /panel/workspaces/{workspaceUuid} | Update workspace
+*PostBoost::WorkspacesApi* | [**update_workspace_user**](docs/WorkspacesApi.md#update_workspace_user) | **PUT** /panel/workspaces/{workspaceUuid}/users | Update user role in workspace

data/docs/AIApi.md

@@ -0,0 +1,439 @@
+# PostBoost::AIApi
+
+All URIs are relative to *https://postboost.co/app/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**blog_to_social**](AIApi.md#blog_to_social) | **POST** /{workspaceUuid}/ai/blog-to-social | Generate social media captions from a blog post |
+| [**image_alt_text**](AIApi.md#image_alt_text) | **POST** /{workspaceUuid}/ai/image-alt-text | Generate alt text for a media image using AI |
+| [**image_edit**](AIApi.md#image_edit) | **POST** /{workspaceUuid}/ai/image-edit | Edit an existing media image using AI |
+| [**image_generate**](AIApi.md#image_generate) | **POST** /{workspaceUuid}/ai/image-generate | Generate social media images from a caption |
+| [**image_prompt**](AIApi.md#image_prompt) | **POST** /{workspaceUuid}/ai/image-prompt | Build an optimized image prompt from a social media caption |
+| [**image_variations**](AIApi.md#image_variations) | **POST** /{workspaceUuid}/ai/image-variations | Generate variations of an existing media image |
+
+
+## blog_to_social
+
+> <BlogToSocial200Response> blog_to_social(workspace_uuid, blog_to_social_input)
+
+Generate social media captions from a blog post
+
+Generates platform-specific social media captions from a blog post URL or directly provided title and excerpt. Each platform generates one caption, which consumes one AI credit from the workspace's monthly allowance.  **Input modes** (at least one required): - **URL mode**: provide `url` and the API scrapes the blog content automatically, including detecting the featured image via `og:image`. - **Direct mode**: provide `title` and `excerpt` directly (no scraping).  If both are provided, direct values take priority.  When `create_post` is `true`, a draft post is created in the workspace with per-account caption versions. If an image is available (from `image_url` or the scraped `og:image`), it is imported into the workspace media library and attached to the draft post. 
+
+### 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::AIApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+blog_to_social_input = PostBoost::BlogToSocialInput.new # BlogToSocialInput | 
+
+begin
+  # Generate social media captions from a blog post
+  result = api_instance.blog_to_social(workspace_uuid, blog_to_social_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->blog_to_social: #{e}"
+end
+```
+
+#### Using the blog_to_social_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<BlogToSocial200Response>, Integer, Hash)> blog_to_social_with_http_info(workspace_uuid, blog_to_social_input)
+
+```ruby
+begin
+  # Generate social media captions from a blog post
+  data, status_code, headers = api_instance.blog_to_social_with_http_info(workspace_uuid, blog_to_social_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <BlogToSocial200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->blog_to_social_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **blog_to_social_input** | [**BlogToSocialInput**](BlogToSocialInput.md) |  |  |
+
+### Return type
+
+[**BlogToSocial200Response**](BlogToSocial200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## image_alt_text
+
+> <ImageAltText200Response> image_alt_text(workspace_uuid, image_alt_text_input)
+
+Generate alt text for a media image using AI
+
+Analyzes an existing workspace media item and generates accessible alt text. The alt text is saved back to the media record. Costs 1 AI credit per call. 
+
+### 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::AIApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+image_alt_text_input = PostBoost::ImageAltTextInput.new({media_uuid: 'media_uuid_example'}) # ImageAltTextInput | 
+
+begin
+  # Generate alt text for a media image using AI
+  result = api_instance.image_alt_text(workspace_uuid, image_alt_text_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_alt_text: #{e}"
+end
+```
+
+#### Using the image_alt_text_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ImageAltText200Response>, Integer, Hash)> image_alt_text_with_http_info(workspace_uuid, image_alt_text_input)
+
+```ruby
+begin
+  # Generate alt text for a media image using AI
+  data, status_code, headers = api_instance.image_alt_text_with_http_info(workspace_uuid, image_alt_text_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ImageAltText200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_alt_text_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **image_alt_text_input** | [**ImageAltTextInput**](ImageAltTextInput.md) |  |  |
+
+### Return type
+
+[**ImageAltText200Response**](ImageAltText200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## image_edit
+
+> <ImageGenerate200Response> image_edit(workspace_uuid, image_edit_input)
+
+Edit an existing media image using AI
+
+Edits an existing workspace media item using the source image and a text prompt. Optionally accepts a mask (transparent areas are replaced). Saves results to the media library. Credits: `count × credit_weight`. 
+
+### 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::AIApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+image_edit_input = PostBoost::ImageEditInput.new({media_uuid: 'media_uuid_example', prompt: 'Make the background a white studio backdrop'}) # ImageEditInput | 
+
+begin
+  # Edit an existing media image using AI
+  result = api_instance.image_edit(workspace_uuid, image_edit_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_edit: #{e}"
+end
+```
+
+#### Using the image_edit_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ImageGenerate200Response>, Integer, Hash)> image_edit_with_http_info(workspace_uuid, image_edit_input)
+
+```ruby
+begin
+  # Edit an existing media image using AI
+  data, status_code, headers = api_instance.image_edit_with_http_info(workspace_uuid, image_edit_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ImageGenerate200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_edit_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **image_edit_input** | [**ImageEditInput**](ImageEditInput.md) |  |  |
+
+### Return type
+
+[**ImageGenerate200Response**](ImageGenerate200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## image_generate
+
+> <ImageGenerate200Response> image_generate(workspace_uuid, image_generate_input)
+
+Generate social media images from a caption
+
+Generates one or more images and saves them immediately to the workspace media library.  **Standard mode** (recommended): provide `caption` + `platform`. PostBoost builds a professional image prompt internally using platform-specific templates. No prompt engineering required.  **Developer mode**: provide `prompt` directly to bypass prompt building. If both `caption` and `prompt` are sent, standard mode runs.  Credits: `count x credit_weight` (default: 5 per image). 
+
+### 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::AIApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+image_generate_input = PostBoost::ImageGenerateInput.new # ImageGenerateInput | 
+
+begin
+  # Generate social media images from a caption
+  result = api_instance.image_generate(workspace_uuid, image_generate_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_generate: #{e}"
+end
+```
+
+#### Using the image_generate_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ImageGenerate200Response>, Integer, Hash)> image_generate_with_http_info(workspace_uuid, image_generate_input)
+
+```ruby
+begin
+  # Generate social media images from a caption
+  data, status_code, headers = api_instance.image_generate_with_http_info(workspace_uuid, image_generate_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ImageGenerate200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_generate_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **image_generate_input** | [**ImageGenerateInput**](ImageGenerateInput.md) |  |  |
+
+### Return type
+
+[**ImageGenerate200Response**](ImageGenerate200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## image_prompt
+
+> <ImagePrompt200Response> image_prompt(workspace_uuid, image_prompt_input)
+
+Build an optimized image prompt from a social media caption
+
+Builds a professional image generation prompt from a caption and platform. No image is generated. Use this to preview the prompt before calling `image-generate`. Costs 1 AI credit per call.  When `image-generate` builds the prompt internally (standard mode), no credit is charged for the prompt step. 
+
+### 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::AIApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+image_prompt_input = PostBoost::ImagePromptInput.new({caption: 'Our summer sale starts today, 30% off everything!', platform: 'instagram'}) # ImagePromptInput | 
+
+begin
+  # Build an optimized image prompt from a social media caption
+  result = api_instance.image_prompt(workspace_uuid, image_prompt_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_prompt: #{e}"
+end
+```
+
+#### Using the image_prompt_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ImagePrompt200Response>, Integer, Hash)> image_prompt_with_http_info(workspace_uuid, image_prompt_input)
+
+```ruby
+begin
+  # Build an optimized image prompt from a social media caption
+  data, status_code, headers = api_instance.image_prompt_with_http_info(workspace_uuid, image_prompt_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ImagePrompt200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_prompt_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **image_prompt_input** | [**ImagePromptInput**](ImagePromptInput.md) |  |  |
+
+### Return type
+
+[**ImagePrompt200Response**](ImagePrompt200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## image_variations
+
+> <ImageVariations200Response> image_variations(workspace_uuid, image_variations_input)
+
+Generate variations of an existing media image
+
+Creates one or more variations of an existing workspace media item. Saves results to the media library. Credits: `count × credit_weight`. 
+
+### 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::AIApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+image_variations_input = PostBoost::ImageVariationsInput.new({media_uuid: 'media_uuid_example'}) # ImageVariationsInput | 
+
+begin
+  # Generate variations of an existing media image
+  result = api_instance.image_variations(workspace_uuid, image_variations_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_variations: #{e}"
+end
+```
+
+#### Using the image_variations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ImageVariations200Response>, Integer, Hash)> image_variations_with_http_info(workspace_uuid, image_variations_input)
+
+```ruby
+begin
+  # Generate variations of an existing media image
+  data, status_code, headers = api_instance.image_variations_with_http_info(workspace_uuid, image_variations_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ImageVariations200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling AIApi->image_variations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **image_variations_input** | [**ImageVariationsInput**](ImageVariationsInput.md) |  |  |
+
+### Return type
+
+[**ImageVariations200Response**](ImageVariations200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/AICredits.md

@@ -0,0 +1,22 @@
+# PostBoost::AICredits
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **available** | **Boolean** | Whether the workspace can spend AI credits now. Always true when no balance is tracked. |  |
+| **balance** | **Float** | Remaining credit balance (2 decimals), or null when no balance is tracked. |  |
+| **low** | **Boolean** | True when the balance is above 0 and at most 10. |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AICredits.new(
+  available: null,
+  balance: null,
+  low: null
+)
+```
+

data/docs/Account.md

@@ -4,15 +4,18 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** |  | [optional] |
-| **uuid** | **String** |  | [optional] |
-| **name** | **String** |  | [optional] |
-| **username** | **String** |  | [optional] |
+| **id** | **Integer** |  |  |
+| **uuid** | **String** |  |  |
+| **name** | **String** |  |  |
+| **username** | **String** |  |  |
 | **image** | **String** |  | [optional] |
-| **provider** | **String** |  | [optional] |
-| **data** | **Object** | Provider-specific metadata. | [optional] |
-| **authorized** | **Boolean** |  | [optional] |
-| **created_at** | **Time** |  | [optional] |
+| **provider** | **String** |  |  |
+| **data** | **Object** | Provider-specific metadata. |  |
+| **authorized** | **Boolean** |  |  |
+| **profile_url** | **String** | Public URL of the account's profile on the network, when known. | [optional] |
+| **publish_status** | **String** | Only present when the account is embedded in a post. Publishing state of this account for the post. | [optional] |
+| **published_parts** | **Integer** | Only present when the account is embedded in a post. How many parts (for example thread items or a first comment) are live on the network. | [optional] |
+| **created_at** | **Time** |  |  |
 
 ## Example
 
@@ -28,6 +31,9 @@ instance = PostBoost::Account.new(
   provider: null,
   data: null,
   authorized: null,
+  profile_url: null,
+  publish_status: null,
+  published_parts: null,
   created_at: null
 )
 ```

data/docs/AccountAnalytics.md

@@ -0,0 +1,28 @@
+# PostBoost::AccountAnalytics
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account** | [**Account**](Account.md) |  |  |
+| **type** | **String** | The analytics tab returned. |  |
+| **tabs** | **Array<String>** | Tabs this account supports; any of them can be passed as `type`. |  |
+| **period** | [**AnalyticsPeriod**](AnalyticsPeriod.md) |  |  |
+| **initial_sync** | [**AccountAnalyticsInitialSync**](AccountAnalyticsInitialSync.md) |  |  |
+| **data** | **Hash<String, Object>** | Provider- and tab-specific metrics. Chart series are lists of `{date, value}` points. |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::AccountAnalytics.new(
+  account: null,
+  type: null,
+  tabs: null,
+  period: null,
+  initial_sync: null,
+  data: null
+)
+```
+