postboost 1.0.0 → 1.8.0

data/docs/MediaApi.md

@@ -6,13 +6,17 @@ All URIs are relative to *https://postboost.co/app/api*
 | ------ | ------------ | ----------- |
 | [**abort_chunked_upload**](MediaApi.md#abort_chunked_upload) | **DELETE** /{workspaceUuid}/media/chunked/{uploadUuid} | Abort chunked upload |
 | [**complete_chunked_upload**](MediaApi.md#complete_chunked_upload) | **POST** /{workspaceUuid}/media/chunked/{uploadUuid}/complete | Complete chunked upload |
+| [**create_media_folder**](MediaApi.md#create_media_folder) | **POST** /{workspaceUuid}/media/folders | Create media folder |
 | [**delete_media_bulk**](MediaApi.md#delete_media_bulk) | **DELETE** /{workspaceUuid}/media | Delete media (bulk) |
+| [**delete_media_folder**](MediaApi.md#delete_media_folder) | **DELETE** /{workspaceUuid}/media/folders/{folderUuid} | Delete media folder |
 | [**get_media**](MediaApi.md#get_media) | **GET** /{workspaceUuid}/media/{mediaUuid} | Get media |
 | [**get_remote_upload_status**](MediaApi.md#get_remote_upload_status) | **GET** /{workspaceUuid}/media/remote/{downloadId}/status | Get remote upload status |
 | [**initiate_chunked_upload**](MediaApi.md#initiate_chunked_upload) | **POST** /{workspaceUuid}/media/chunked/initiate | Initiate chunked upload |
 | [**initiate_remote_upload**](MediaApi.md#initiate_remote_upload) | **POST** /{workspaceUuid}/media/remote/initiate | Initiate remote upload |
 | [**list_media**](MediaApi.md#list_media) | **GET** /{workspaceUuid}/media | List media |
+| [**list_media_folders**](MediaApi.md#list_media_folders) | **GET** /{workspaceUuid}/media/folders | List media folders |
 | [**update_media**](MediaApi.md#update_media) | **PUT** /{workspaceUuid}/media/{mediaUuid} | Update media |
+| [**update_media_folder**](MediaApi.md#update_media_folder) | **PUT** /{workspaceUuid}/media/folders/{folderUuid} | Update media folder |
 | [**upload_chunk**](MediaApi.md#upload_chunk) | **POST** /{workspaceUuid}/media/chunked/{uploadUuid}/upload | Upload a chunk |
 | [**upload_media**](MediaApi.md#upload_media) | **POST** /{workspaceUuid}/media | Upload media (binary) |
 
@@ -89,11 +93,11 @@ nil (empty response body)
 
 ## complete_chunked_upload
 
-> <Media> complete_chunked_upload(workspace_uuid, upload_uuid)
+> <Media> complete_chunked_upload(workspace_uuid, upload_uuid, opts)
 
 Complete chunked upload
 
-Signal that all chunks have been uploaded. Returns the final media object.
+Signal that all chunks have been uploaded. Returns the final media object. A video may come back with `is_processing` set to `true` while its conversion runs.
 
 ### Examples
 
@@ -109,10 +113,13 @@ end
 api_instance = PostBoost::MediaApi.new
 workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
 upload_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | 
+opts = {
+  complete_chunked_upload_request: PostBoost::CompleteChunkedUploadRequest.new # CompleteChunkedUploadRequest | 
+}
 
 begin
   # Complete chunked upload
-  result = api_instance.complete_chunked_upload(workspace_uuid, upload_uuid)
+  result = api_instance.complete_chunked_upload(workspace_uuid, upload_uuid, opts)
   p result
 rescue PostBoost::ApiError => e
   puts "Error when calling MediaApi->complete_chunked_upload: #{e}"
@@ -123,12 +130,12 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<Media>, Integer, Hash)> complete_chunked_upload_with_http_info(workspace_uuid, upload_uuid)
+> <Array(<Media>, Integer, Hash)> complete_chunked_upload_with_http_info(workspace_uuid, upload_uuid, opts)
 
 ```ruby
 begin
   # Complete chunked upload
-  data, status_code, headers = api_instance.complete_chunked_upload_with_http_info(workspace_uuid, upload_uuid)
+  data, status_code, headers = api_instance.complete_chunked_upload_with_http_info(workspace_uuid, upload_uuid, opts)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <Media>
@@ -143,6 +150,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **workspace_uuid** | **String** | UUID of the workspace. |  |
 | **upload_uuid** | **String** |  |  |
+| **complete_chunked_upload_request** | [**CompleteChunkedUploadRequest**](CompleteChunkedUploadRequest.md) |  | [optional] |
 
 ### Return type
 
@@ -154,7 +162,78 @@ end
 
 ### HTTP request headers
 
-- **Content-Type**: Not defined
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## create_media_folder
+
+> <MediaFolder> create_media_folder(workspace_uuid, create_media_folder_request)
+
+Create media folder
+
+Creates a folder at the top level or under `parent`. The name must be unique among its siblings.
+
+### 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::MediaApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+create_media_folder_request = PostBoost::CreateMediaFolderRequest.new({name: 'name_example'}) # CreateMediaFolderRequest | 
+
+begin
+  # Create media folder
+  result = api_instance.create_media_folder(workspace_uuid, create_media_folder_request)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->create_media_folder: #{e}"
+end
+```
+
+#### Using the create_media_folder_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MediaFolder>, Integer, Hash)> create_media_folder_with_http_info(workspace_uuid, create_media_folder_request)
+
+```ruby
+begin
+  # Create media folder
+  data, status_code, headers = api_instance.create_media_folder_with_http_info(workspace_uuid, create_media_folder_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MediaFolder>
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->create_media_folder_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **create_media_folder_request** | [**CreateMediaFolderRequest**](CreateMediaFolderRequest.md) |  |  |
+
+### Return type
+
+[**MediaFolder**](MediaFolder.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
 - **Accept**: application/json
 
 
@@ -164,7 +243,7 @@ end
 
 Delete media (bulk)
 
-Delete one or more media items by their IDs.
+Delete one or more media items by their numeric IDs or UUIDs (both may be mixed, up to 500 per request).
 
 ### Examples
 
@@ -179,7 +258,7 @@ end
 
 api_instance = PostBoost::MediaApi.new
 workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
-delete_media_bulk_request = PostBoost::DeleteMediaBulkRequest.new({items: [37]}) # DeleteMediaBulkRequest | 
+delete_media_bulk_request = PostBoost::DeleteMediaBulkRequest.new({items: [nil]}) # DeleteMediaBulkRequest | 
 
 begin
   # Delete media (bulk)
@@ -229,6 +308,81 @@ end
 - **Accept**: application/json
 
 
+## delete_media_folder
+
+> Object delete_media_folder(workspace_uuid, folder_uuid, opts)
+
+Delete media folder
+
+Deletes a folder. By default its media and sub-folders move up to the folder's parent; with `delete_media` set to true every media item below the folder is deleted as well.
+
+### 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::MediaApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+folder_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the media folder.
+opts = {
+  delete_media_folder_request: PostBoost::DeleteMediaFolderRequest.new # DeleteMediaFolderRequest | 
+}
+
+begin
+  # Delete media folder
+  result = api_instance.delete_media_folder(workspace_uuid, folder_uuid, opts)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->delete_media_folder: #{e}"
+end
+```
+
+#### Using the delete_media_folder_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Object, Integer, Hash)> delete_media_folder_with_http_info(workspace_uuid, folder_uuid, opts)
+
+```ruby
+begin
+  # Delete media folder
+  data, status_code, headers = api_instance.delete_media_folder_with_http_info(workspace_uuid, folder_uuid, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Object
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->delete_media_folder_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **folder_uuid** | **String** | UUID of the media folder. |  |
+| **delete_media_folder_request** | [**DeleteMediaFolderRequest**](DeleteMediaFolderRequest.md) |  | [optional] |
+
+### Return type
+
+**Object**
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## get_media
 
 > <Media> get_media(workspace_uuid, media_uuid)
@@ -373,7 +527,7 @@ end
 
 ## initiate_chunked_upload
 
-> <InitiateChunkedUpload200Response> initiate_chunked_upload(workspace_uuid, initiate_chunked_upload_request)
+> <InitiateChunkedUpload201Response> initiate_chunked_upload(workspace_uuid, initiate_chunked_upload_request)
 
 Initiate chunked upload
 
@@ -407,7 +561,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<InitiateChunkedUpload200Response>, Integer, Hash)> initiate_chunked_upload_with_http_info(workspace_uuid, initiate_chunked_upload_request)
+> <Array(<InitiateChunkedUpload201Response>, Integer, Hash)> initiate_chunked_upload_with_http_info(workspace_uuid, initiate_chunked_upload_request)
 
 ```ruby
 begin
@@ -415,7 +569,7 @@ begin
   data, status_code, headers = api_instance.initiate_chunked_upload_with_http_info(workspace_uuid, initiate_chunked_upload_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <InitiateChunkedUpload200Response>
+  p data # => <InitiateChunkedUpload201Response>
 rescue PostBoost::ApiError => e
   puts "Error when calling MediaApi->initiate_chunked_upload_with_http_info: #{e}"
 end
@@ -430,7 +584,7 @@ end
 
 ### Return type
 
-[**InitiateChunkedUpload200Response**](InitiateChunkedUpload200Response.md)
+[**InitiateChunkedUpload201Response**](InitiateChunkedUpload201Response.md)
 
 ### Authorization
 
@@ -444,7 +598,7 @@ end
 
 ## initiate_remote_upload
 
-> <InitiateRemoteUpload200Response> initiate_remote_upload(workspace_uuid, initiate_remote_upload_request)
+> <InitiateRemoteUpload201Response> initiate_remote_upload(workspace_uuid, initiate_remote_upload_request)
 
 Initiate remote upload
 
@@ -478,7 +632,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<InitiateRemoteUpload200Response>, Integer, Hash)> initiate_remote_upload_with_http_info(workspace_uuid, initiate_remote_upload_request)
+> <Array(<InitiateRemoteUpload201Response>, Integer, Hash)> initiate_remote_upload_with_http_info(workspace_uuid, initiate_remote_upload_request)
 
 ```ruby
 begin
@@ -486,7 +640,7 @@ begin
   data, status_code, headers = api_instance.initiate_remote_upload_with_http_info(workspace_uuid, initiate_remote_upload_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <InitiateRemoteUpload200Response>
+  p data # => <InitiateRemoteUpload201Response>
 rescue PostBoost::ApiError => e
   puts "Error when calling MediaApi->initiate_remote_upload_with_http_info: #{e}"
 end
@@ -501,7 +655,7 @@ end
 
 ### Return type
 
-[**InitiateRemoteUpload200Response**](InitiateRemoteUpload200Response.md)
+[**InitiateRemoteUpload201Response**](InitiateRemoteUpload201Response.md)
 
 ### Authorization
 
@@ -519,7 +673,7 @@ end
 
 List media
 
-Returns a paginated list of media assets in the workspace library.
+Returns a paginated list of media assets in the workspace library. Without `folder` every item is listed, whatever folder it is filed in. A `keyword` search always looks at the whole library and ignores `folder` and `favorite`. 
 
 ### Examples
 
@@ -535,7 +689,15 @@ end
 api_instance = PostBoost::MediaApi.new
 workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
 opts = {
-  page: 56 # Integer | Page number (20 items per page).
+  page: 56, # Integer | Page number.
+  limit: 56, # Integer | Items per page. Values below 1 fall back to 50; values above 100 are capped at 100.
+  folder: 'folder_example', # String | Media folder UUID, or `root` for items not filed in any folder.
+  mime_types: ['inner_example'], # Array<String> | Only these MIME types (for example `image/png`).
+  type: 'image', # String | Only this media type.
+  keyword: 'keyword_example', # String | Search media by name.
+  usage: 'unused', # String | Filter by how the media is used in posts.
+  favorite: true, # Boolean | When `true`, only media the caller marked as favorite.
+  sort: 'newest' # String | 
 }
 
 begin
@@ -570,7 +732,15 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **workspace_uuid** | **String** | UUID of the workspace. |  |
-| **page** | **Integer** | Page number (20 items per page). | [optional][default to 1] |
+| **page** | **Integer** | Page number. | [optional][default to 1] |
+| **limit** | **Integer** | Items per page. Values below 1 fall back to 50; values above 100 are capped at 100. | [optional][default to 50] |
+| **folder** | **String** | Media folder UUID, or &#x60;root&#x60; for items not filed in any folder. | [optional] |
+| **mime_types** | [**Array&lt;String&gt;**](String.md) | Only these MIME types (for example &#x60;image/png&#x60;). | [optional] |
+| **type** | **String** | Only this media type. | [optional] |
+| **keyword** | **String** | Search media by name. | [optional] |
+| **usage** | **String** | Filter by how the media is used in posts. | [optional] |
+| **favorite** | **Boolean** | When &#x60;true&#x60;, only media the caller marked as favorite. | [optional] |
+| **sort** | **String** |  | [optional][default to &#39;newest&#39;] |
 
 ### Return type
 
@@ -586,13 +756,82 @@ end
 - **Accept**: application/json
 
 
+## list_media_folders
+
+> <ListMediaFolders200Response> list_media_folders(workspace_uuid)
+
+List media folders
+
+Returns the whole folder tree of the media library in one response (not paginated). Rebuild the tree from each folder's `parent`.
+
+### 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::MediaApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+
+begin
+  # List media folders
+  result = api_instance.list_media_folders(workspace_uuid)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->list_media_folders: #{e}"
+end
+```
+
+#### Using the list_media_folders_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ListMediaFolders200Response>, Integer, Hash)> list_media_folders_with_http_info(workspace_uuid)
+
+```ruby
+begin
+  # List media folders
+  data, status_code, headers = api_instance.list_media_folders_with_http_info(workspace_uuid)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ListMediaFolders200Response>
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->list_media_folders_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+
+### Return type
+
+[**ListMediaFolders200Response**](ListMediaFolders200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## update_media
 
 > Object update_media(workspace_uuid, media_uuid, update_media_request)
 
 Update media
 
-Update the alt text of a media asset.
+Update the name, alt text, or folder of a media asset. Only the keys present in the body are written. Sending `folder: null` moves the item to the library root; omitting `folder` leaves it where it is. 
 
 ### Examples
 
@@ -608,7 +847,7 @@ end
 api_instance = PostBoost::MediaApi.new
 workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
 media_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the media asset.
-update_media_request = PostBoost::UpdateMediaRequest.new({alt_text: 'alt_text_example'}) # UpdateMediaRequest | 
+update_media_request = PostBoost::UpdateMediaRequest.new # UpdateMediaRequest | 
 
 begin
   # Update media
@@ -659,9 +898,82 @@ end
 - **Accept**: application/json
 
 
+## update_media_folder
+
+> <MediaFolder> update_media_folder(workspace_uuid, folder_uuid, media_folder_input)
+
+Update media folder
+
+Renames a folder and/or moves it. Sending `parent` moves the folder (null = top level); omitting it keeps the current parent. A folder cannot be moved into itself or one of its descendants.
+
+### 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::MediaApi.new
+workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
+folder_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the media folder.
+media_folder_input = PostBoost::MediaFolderInput.new # MediaFolderInput | 
+
+begin
+  # Update media folder
+  result = api_instance.update_media_folder(workspace_uuid, folder_uuid, media_folder_input)
+  p result
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->update_media_folder: #{e}"
+end
+```
+
+#### Using the update_media_folder_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MediaFolder>, Integer, Hash)> update_media_folder_with_http_info(workspace_uuid, folder_uuid, media_folder_input)
+
+```ruby
+begin
+  # Update media folder
+  data, status_code, headers = api_instance.update_media_folder_with_http_info(workspace_uuid, folder_uuid, media_folder_input)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MediaFolder>
+rescue PostBoost::ApiError => e
+  puts "Error when calling MediaApi->update_media_folder_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **workspace_uuid** | **String** | UUID of the workspace. |  |
+| **folder_uuid** | **String** | UUID of the media folder. |  |
+| **media_folder_input** | [**MediaFolderInput**](MediaFolderInput.md) |  |  |
+
+### Return type
+
+[**MediaFolder**](MediaFolder.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## upload_chunk
 
-> <UploadChunk200Response> upload_chunk(workspace_uuid, upload_uuid, chunk, chunk_index)
+> <UploadChunk201Response> upload_chunk(workspace_uuid, upload_uuid, chunk, chunk_index)
 
 Upload a chunk
 
@@ -697,7 +1009,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UploadChunk200Response>, Integer, Hash)> upload_chunk_with_http_info(workspace_uuid, upload_uuid, chunk, chunk_index)
+> <Array(<UploadChunk201Response>, Integer, Hash)> upload_chunk_with_http_info(workspace_uuid, upload_uuid, chunk, chunk_index)
 
 ```ruby
 begin
@@ -705,7 +1017,7 @@ begin
   data, status_code, headers = api_instance.upload_chunk_with_http_info(workspace_uuid, upload_uuid, chunk, chunk_index)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UploadChunk200Response>
+  p data # => <UploadChunk201Response>
 rescue PostBoost::ApiError => e
   puts "Error when calling MediaApi->upload_chunk_with_http_info: #{e}"
 end
@@ -722,7 +1034,7 @@ end
 
 ### Return type
 
-[**UploadChunk200Response**](UploadChunk200Response.md)
+[**UploadChunk201Response**](UploadChunk201Response.md)
 
 ### Authorization
 
@@ -757,7 +1069,8 @@ api_instance = PostBoost::MediaApi.new
 workspace_uuid = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the workspace.
 file = File.new('/path/to/some/file') # File | The file to upload.
 opts = {
-  alt_text: 'alt_text_example' # String | Alternative text for accessibility.
+  alt_text: 'alt_text_example', # String | Alternative text for accessibility.
+  folder: '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | UUID of the media folder to file the upload in. Omit or null for the library root.
 }
 
 begin
@@ -794,6 +1107,7 @@ end
 | **workspace_uuid** | **String** | UUID of the workspace. |  |
 | **file** | **File** | The file to upload. |  |
 | **alt_text** | **String** | Alternative text for accessibility. | [optional] |
+| **folder** | **String** | UUID of the media folder to file the upload in. Omit or null for the library root. | [optional] |
 
 ### Return type
 

data/docs/MediaFolder.md

@@ -0,0 +1,24 @@
+# PostBoost::MediaFolder
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **uuid** | **String** |  |  |
+| **name** | **String** |  |  |
+| **parent** | **String** | UUID of the parent folder; null for a top-level folder. |  |
+| **media_count** | **Integer** | Media filed anywhere below the folder, including its sub-folders. |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::MediaFolder.new(
+  uuid: null,
+  name: Campaign assets,
+  parent: null,
+  media_count: null
+)
+```
+

data/docs/MediaFolderInput.md

@@ -0,0 +1,20 @@
+# PostBoost::MediaFolderInput
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **name** | **String** | Folder name; must be unique among its siblings (case-insensitive). | [optional] |
+| **parent** | **String** | UUID of the parent folder, or null for the top level. Folders nest to a limited depth. | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::MediaFolderInput.new(
+  name: null,
+  parent: null
+)
+```
+

data/docs/MediaFolderRef.md

@@ -0,0 +1,20 @@
+# PostBoost::MediaFolderRef
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **uuid** | **String** |  |  |
+| **name** | **String** |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::MediaFolderRef.new(
+  uuid: null,
+  name: null
+)
+```
+

data/docs/Mention.md

@@ -0,0 +1,28 @@
+# PostBoost::Mention
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  |  |
+| **reference** | **Integer** | Write `{{mention:<reference>}}` in a post body to mention this entry; it is resolved to each network's identity at publish time. |  |
+| **name** | **String** |  |  |
+| **avatar** | **String** |  | [optional] |
+| **identities** | [**Array<MentionIdentity>**](MentionIdentity.md) |  | [optional] |
+| **created_at** | **Time** |  |  |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::Mention.new(
+  id: null,
+  reference: null,
+  name: Jane Doe,
+  avatar: null,
+  identities: null,
+  created_at: null
+)
+```
+

data/docs/MentionIdentity.md

@@ -0,0 +1,24 @@
+# PostBoost::MentionIdentity
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **provider** | **String** | Mention provider key (network family). |  |
+| **provider_id** | **String** | The profile's network ID, when resolved. Never accepted from clients. | [optional] |
+| **handle** | **String** |  |  |
+| **label** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'postboost'
+
+instance = PostBoost::MentionIdentity.new(
+  provider: linkedin,
+  provider_id: null,
+  handle: janedoe,
+  label: null
+)
+```
+