late-sdk 0.0.42

data/docs/MessagesApi.md

@@ -0,0 +1,453 @@
+# Late::MessagesApi
+
+All URIs are relative to *https://getlate.dev/api*
+
+| Method | HTTP request | Description |
+| ------ | ------------ | ----------- |
+| [**edit_inbox_message**](MessagesApi.md#edit_inbox_message) | **PATCH** /v1/inbox/conversations/{conversationId}/messages/{messageId} | Edit message |
+| [**get_inbox_conversation**](MessagesApi.md#get_inbox_conversation) | **GET** /v1/inbox/conversations/{conversationId} | Get conversation |
+| [**get_inbox_conversation_messages**](MessagesApi.md#get_inbox_conversation_messages) | **GET** /v1/inbox/conversations/{conversationId}/messages | List messages |
+| [**list_inbox_conversations**](MessagesApi.md#list_inbox_conversations) | **GET** /v1/inbox/conversations | List conversations |
+| [**send_inbox_message**](MessagesApi.md#send_inbox_message) | **POST** /v1/inbox/conversations/{conversationId}/messages | Send message |
+| [**update_inbox_conversation**](MessagesApi.md#update_inbox_conversation) | **PUT** /v1/inbox/conversations/{conversationId} | Update conversation status |
+
+
+## edit_inbox_message
+
+> <EditInboxMessage200Response> edit_inbox_message(conversation_id, message_id, edit_inbox_message_request)
+
+Edit message
+
+Edit the text and/or reply markup of a previously sent Telegram message. Only supported for Telegram. Returns 400 for other platforms. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'late-sdk'
+# setup authorization
+Late.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Late::MessagesApi.new
+conversation_id = 'conversation_id_example' # String | The conversation ID
+message_id = 'message_id_example' # String | The Telegram message ID to edit
+edit_inbox_message_request = Late::EditInboxMessageRequest.new({account_id: 'account_id_example'}) # EditInboxMessageRequest | 
+
+begin
+  # Edit message
+  result = api_instance.edit_inbox_message(conversation_id, message_id, edit_inbox_message_request)
+  p result
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->edit_inbox_message: #{e}"
+end
+```
+
+#### Using the edit_inbox_message_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<EditInboxMessage200Response>, Integer, Hash)> edit_inbox_message_with_http_info(conversation_id, message_id, edit_inbox_message_request)
+
+```ruby
+begin
+  # Edit message
+  data, status_code, headers = api_instance.edit_inbox_message_with_http_info(conversation_id, message_id, edit_inbox_message_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <EditInboxMessage200Response>
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->edit_inbox_message_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_id** | **String** | The conversation ID |  |
+| **message_id** | **String** | The Telegram message ID to edit |  |
+| **edit_inbox_message_request** | [**EditInboxMessageRequest**](EditInboxMessageRequest.md) |  |  |
+
+### Return type
+
+[**EditInboxMessage200Response**](EditInboxMessage200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## get_inbox_conversation
+
+> <GetInboxConversation200Response> get_inbox_conversation(conversation_id, account_id)
+
+Get conversation
+
+Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
+
+### Examples
+
+```ruby
+require 'time'
+require 'late-sdk'
+# setup authorization
+Late.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Late::MessagesApi.new
+conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+account_id = 'account_id_example' # String | The social account ID
+
+begin
+  # Get conversation
+  result = api_instance.get_inbox_conversation(conversation_id, account_id)
+  p result
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->get_inbox_conversation: #{e}"
+end
+```
+
+#### Using the get_inbox_conversation_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetInboxConversation200Response>, Integer, Hash)> get_inbox_conversation_with_http_info(conversation_id, account_id)
+
+```ruby
+begin
+  # Get conversation
+  data, status_code, headers = api_instance.get_inbox_conversation_with_http_info(conversation_id, account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetInboxConversation200Response>
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->get_inbox_conversation_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **account_id** | **String** | The social account ID |  |
+
+### Return type
+
+[**GetInboxConversation200Response**](GetInboxConversation200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_inbox_conversation_messages
+
+> <GetInboxConversationMessages200Response> get_inbox_conversation_messages(conversation_id, account_id)
+
+List messages
+
+Fetch messages for a specific conversation. Requires accountId query parameter.
+
+### Examples
+
+```ruby
+require 'time'
+require 'late-sdk'
+# setup authorization
+Late.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Late::MessagesApi.new
+conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+account_id = 'account_id_example' # String | Social account ID
+
+begin
+  # List messages
+  result = api_instance.get_inbox_conversation_messages(conversation_id, account_id)
+  p result
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->get_inbox_conversation_messages: #{e}"
+end
+```
+
+#### Using the get_inbox_conversation_messages_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetInboxConversationMessages200Response>, Integer, Hash)> get_inbox_conversation_messages_with_http_info(conversation_id, account_id)
+
+```ruby
+begin
+  # List messages
+  data, status_code, headers = api_instance.get_inbox_conversation_messages_with_http_info(conversation_id, account_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetInboxConversationMessages200Response>
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->get_inbox_conversation_messages_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **account_id** | **String** | Social account ID |  |
+
+### Return type
+
+[**GetInboxConversationMessages200Response**](GetInboxConversationMessages200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## list_inbox_conversations
+
+> <ListInboxConversations200Response> list_inbox_conversations(opts)
+
+List conversations
+
+Fetch conversations (DMs) from all connected messaging accounts in a single API call. Supports filtering by profile and platform. Results are aggregated and deduplicated. Supported platforms: Facebook, Instagram, Twitter/X, Bluesky, Reddit, Telegram. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'late-sdk'
+# setup authorization
+Late.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Late::MessagesApi.new
+opts = {
+  profile_id: 'profile_id_example', # String | Filter by profile ID
+  platform: 'facebook', # String | Filter by platform
+  status: 'active', # String | Filter by conversation status
+  sort_order: 'asc', # String | Sort order by updated time
+  limit: 56, # Integer | Maximum number of conversations to return
+  cursor: 'cursor_example', # String | Pagination cursor for next page
+  account_id: 'account_id_example' # String | Filter by specific social account ID
+}
+
+begin
+  # List conversations
+  result = api_instance.list_inbox_conversations(opts)
+  p result
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->list_inbox_conversations: #{e}"
+end
+```
+
+#### Using the list_inbox_conversations_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListInboxConversations200Response>, Integer, Hash)> list_inbox_conversations_with_http_info(opts)
+
+```ruby
+begin
+  # List conversations
+  data, status_code, headers = api_instance.list_inbox_conversations_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListInboxConversations200Response>
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->list_inbox_conversations_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **profile_id** | **String** | Filter by profile ID | [optional] |
+| **platform** | **String** | Filter by platform | [optional] |
+| **status** | **String** | Filter by conversation status | [optional] |
+| **sort_order** | **String** | Sort order by updated time | [optional][default to &#39;desc&#39;] |
+| **limit** | **Integer** | Maximum number of conversations to return | [optional][default to 50] |
+| **cursor** | **String** | Pagination cursor for next page | [optional] |
+| **account_id** | **String** | Filter by specific social account ID | [optional] |
+
+### Return type
+
+[**ListInboxConversations200Response**](ListInboxConversations200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## send_inbox_message
+
+> <SendInboxMessage200Response> send_inbox_message(conversation_id, send_inbox_message_request)
+
+Send message
+
+Send a message in a conversation. Supports text, attachments, quick replies, buttons, and message tags. Attachment and interactive message support varies by platform.
+
+### Examples
+
+```ruby
+require 'time'
+require 'late-sdk'
+# setup authorization
+Late.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Late::MessagesApi.new
+conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+send_inbox_message_request = Late::SendInboxMessageRequest.new({account_id: 'account_id_example'}) # SendInboxMessageRequest | 
+
+begin
+  # Send message
+  result = api_instance.send_inbox_message(conversation_id, send_inbox_message_request)
+  p result
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->send_inbox_message: #{e}"
+end
+```
+
+#### Using the send_inbox_message_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<SendInboxMessage200Response>, Integer, Hash)> send_inbox_message_with_http_info(conversation_id, send_inbox_message_request)
+
+```ruby
+begin
+  # Send message
+  data, status_code, headers = api_instance.send_inbox_message_with_http_info(conversation_id, send_inbox_message_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <SendInboxMessage200Response>
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->send_inbox_message_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **send_inbox_message_request** | [**SendInboxMessageRequest**](SendInboxMessageRequest.md) |  |  |
+
+### Return type
+
+[**SendInboxMessage200Response**](SendInboxMessage200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json, multipart/form-data
+- **Accept**: application/json
+
+
+## update_inbox_conversation
+
+> <UpdateInboxConversation200Response> update_inbox_conversation(conversation_id, update_inbox_conversation_request)
+
+Update conversation status
+
+Archive or activate a conversation. Requires accountId in request body.
+
+### Examples
+
+```ruby
+require 'time'
+require 'late-sdk'
+# setup authorization
+Late.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Late::MessagesApi.new
+conversation_id = 'conversation_id_example' # String | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
+update_inbox_conversation_request = Late::UpdateInboxConversationRequest.new({account_id: 'account_id_example', status: 'active'}) # UpdateInboxConversationRequest | 
+
+begin
+  # Update conversation status
+  result = api_instance.update_inbox_conversation(conversation_id, update_inbox_conversation_request)
+  p result
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->update_inbox_conversation: #{e}"
+end
+```
+
+#### Using the update_inbox_conversation_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<UpdateInboxConversation200Response>, Integer, Hash)> update_inbox_conversation_with_http_info(conversation_id, update_inbox_conversation_request)
+
+```ruby
+begin
+  # Update conversation status
+  data, status_code, headers = api_instance.update_inbox_conversation_with_http_info(conversation_id, update_inbox_conversation_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <UpdateInboxConversation200Response>
+rescue Late::ApiError => e
+  puts "Error when calling MessagesApi->update_inbox_conversation_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **conversation_id** | **String** | The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID. |  |
+| **update_inbox_conversation_request** | [**UpdateInboxConversationRequest**](UpdateInboxConversationRequest.md) |  |  |
+
+### Return type
+
+[**UpdateInboxConversation200Response**](UpdateInboxConversation200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/docs/Money.md

@@ -0,0 +1,22 @@
+# Late::Money
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **currency_code** | **String** | ISO 4217 currency code (e.g. USD, EUR) |  |
+| **units** | **String** | Whole units of the amount |  |
+| **nanos** | **Integer** | Nano units (10^-9) of the amount | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::Money.new(
+  currency_code: null,
+  units: null,
+  nanos: null
+)
+```
+

data/docs/Pagination.md

@@ -0,0 +1,24 @@
+# Late::Pagination
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **page** | **Integer** |  | [optional] |
+| **limit** | **Integer** |  | [optional] |
+| **total** | **Integer** |  | [optional] |
+| **pages** | **Integer** |  | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::Pagination.new(
+  page: null,
+  limit: null,
+  total: null,
+  pages: null
+)
+```
+

data/docs/Pending.md

@@ -0,0 +1,22 @@
+# Late::Pending
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** |  | [optional] |
+| **expires_at** | **Time** |  | [optional] |
+| **expires_in** | **Integer** | Seconds until expiration | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::Pending.new(
+  status: null,
+  expires_at: null,
+  expires_in: null
+)
+```
+

data/docs/PinterestPlatformData.md

@@ -0,0 +1,26 @@
+# Late::PinterestPlatformData
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **title** | **String** | Pin title. Defaults to first line of content or \"Pin\". Must be ≤ 100 characters. | [optional] |
+| **board_id** | **String** | Target Pinterest board ID. If omitted, the first available board is used. | [optional] |
+| **link** | **String** | Destination link (pin URL) | [optional] |
+| **cover_image_url** | **String** | Optional cover image for video pins | [optional] |
+| **cover_image_key_frame_time** | **Integer** | Optional key frame time in seconds for derived video cover | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::PinterestPlatformData.new(
+  title: null,
+  board_id: null,
+  link: null,
+  cover_image_url: null,
+  cover_image_key_frame_time: null
+)
+```
+

data/docs/PlatformAnalytics.md

@@ -0,0 +1,28 @@
+# Late::PlatformAnalytics
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **platform** | **String** |  | [optional] |
+| **status** | **String** |  | [optional] |
+| **account_id** | **String** |  | [optional] |
+| **account_username** | **String** |  | [optional] |
+| **analytics** | [**PostAnalytics**](PostAnalytics.md) |  | [optional] |
+| **account_metrics** | [**PlatformAnalyticsAccountMetrics**](PlatformAnalyticsAccountMetrics.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::PlatformAnalytics.new(
+  platform: null,
+  status: null,
+  account_id: null,
+  account_username: null,
+  analytics: null,
+  account_metrics: null
+)
+```
+

data/docs/PlatformAnalyticsAccountMetrics.md

@@ -0,0 +1,22 @@
+# Late::PlatformAnalyticsAccountMetrics
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **followers** | **Integer** | Followers/fans count (e.g., Instagram, Facebook Pages, Twitter) | [optional] |
+| **subscribers** | **Integer** | Subscribers count (e.g., YouTube) | [optional] |
+| **last_updated** | **Time** |  | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::PlatformAnalyticsAccountMetrics.new(
+  followers: null,
+  subscribers: null,
+  last_updated: null
+)
+```
+

data/docs/PlatformTarget.md

@@ -0,0 +1,42 @@
+# Late::PlatformTarget
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **platform** | **String** | Supported values: twitter, threads, instagram, youtube, facebook, linkedin, pinterest, reddit, tiktok, bluesky, googlebusiness, telegram | [optional] |
+| **account_id** | [**PlatformTargetAccountId**](PlatformTargetAccountId.md) |  | [optional] |
+| **custom_content** | **String** | Platform-specific text override. When set, this content is used instead of the top-level post content for this platform. Useful for tailoring captions per platform (e.g. keeping tweets under 280 characters). | [optional] |
+| **custom_media** | [**Array<MediaItem>**](MediaItem.md) |  | [optional] |
+| **scheduled_for** | **Time** | Optional per-platform scheduled time override (uses post.scheduledFor when omitted) | [optional] |
+| **platform_specific_data** | [**PlatformTargetPlatformSpecificData**](PlatformTargetPlatformSpecificData.md) |  | [optional] |
+| **status** | **String** | Platform-specific status: pending, publishing, published, failed | [optional] |
+| **platform_post_id** | **String** | The native post ID on the platform (populated after successful publish) | [optional] |
+| **platform_post_url** | **String** | Public URL of the published post. Included in the response for immediate posts; for scheduled posts, fetch via GET /v1/posts/{postId} after publish time. | [optional] |
+| **published_at** | **Time** | Timestamp when the post was published to this platform | [optional] |
+| **error_message** | **String** | Human-readable error message when status is failed. Contains platform-specific error details explaining why the publish failed. | [optional] |
+| **error_category** | **String** | Error category for programmatic handling: auth_expired (token expired/revoked), user_content (wrong format/too long), user_abuse (rate limits/spam), account_issue (config problems), platform_rejected (policy violation), platform_error (5xx/maintenance), system_error (Late infra), unknown | [optional] |
+| **error_source** | **String** | Who caused the error: user (fix content/reconnect), platform (outage/API change), system (Late issue, rare) | [optional] |
+
+## Example
+
+```ruby
+require 'late-sdk'
+
+instance = Late::PlatformTarget.new(
+  platform: twitter,
+  account_id: null,
+  custom_content: null,
+  custom_media: null,
+  scheduled_for: null,
+  platform_specific_data: null,
+  status: pending,
+  platform_post_id: 1234567890123456789,
+  platform_post_url: https://twitter.com/acmecorp/status/1234567890123456789,
+  published_at: null,
+  error_message: null,
+  error_category: null,
+  error_source: null
+)
+```
+

data/docs/PlatformTargetAccountId.md

@@ -0,0 +1,49 @@
+# Late::PlatformTargetAccountId
+
+## Class instance methods
+
+### `openapi_one_of`
+
+Returns the list of classes defined in oneOf.
+
+#### Example
+
+```ruby
+require 'late-sdk'
+
+Late::PlatformTargetAccountId.openapi_one_of
+# =>
+# [
+#   :'SocialAccount',
+#   :'String'
+# ]
+```
+
+### build
+
+Find the appropriate object from the `openapi_one_of` list and casts the data into it.
+
+#### Example
+
+```ruby
+require 'late-sdk'
+
+Late::PlatformTargetAccountId.build(data)
+# => #<SocialAccount:0x00007fdd4aab02a0>
+
+Late::PlatformTargetAccountId.build(data_that_doesnt_match)
+# => nil
+```
+
+#### Parameters
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+| **data** | **Mixed** | data to be matched against the list of oneOf items |
+
+#### Return type
+
+- `SocialAccount`
+- `String`
+- `nil` (if no type matches)
+