postboost 1.0.0 → 1.14.0

data/lib/postboost/api/workspaces_api.rb

@@ -1,9 +1,9 @@
 =begin
 #PostBoost API
 
-#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 8+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
+#The PostBoost REST API lets you publish, schedule, and analyze social media posts across 12+ platforms from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.  ## Base URL All workspace-scoped endpoints are prefixed with `/{workspaceUuid}`. Panel/admin endpoints are prefixed with `/panel`.  ## Plan access Every workspace-scoped endpoint returns `403` when the workspace's plan does not include API access (capability `api`).  ## Dates and times Post dates and times (`date`, `time`, `accounts_schedule`) are read in the request's `timezone` when one is given, otherwise in the workspace timezone.  ## Idempotent requests Send an `Idempotency-Key` header (any unique string, for example a UUID) with a `POST`. Repeating the request with the same key within 24 hours returns the stored response with `Idempotent-Replayed: true` and creates nothing new. Reusing a key with a different body returns `422`; a request still in progress with the same key returns `409`. `5xx` and `429` responses are not stored, so they can be retried with the same key.  ## Guardrails for automated clients Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns `409` (`code: duplicate_post`, override with `allow_duplicate: true`), scheduling past an account's daily cap returns `429` (`code: account_daily_cap_reached`), and scheduling to an account that must be reconnected returns `422` (`code: account_unauthorized` or `account_token_missing`). Use `POST /{workspaceUuid}/posts/validate` for a dry run and `GET /{workspaceUuid}/activity` to review what API clients did.  ## Authentication All requests require a Bearer token in the `Authorization` header. Generate tokens in your PostBoost dashboard under **Settings → Access Tokens**.  ``` Authorization: Bearer YOUR_API_TOKEN ``` 
 
-The version of the OpenAPI document: 1.0.0
+The version of the OpenAPI document: 1.14.0
 Contact: hi@postboost.co
 Generated by: https://openapi-generator.tech
 Generator version: 7.9.0
@@ -20,6 +20,7 @@ module PostBoost
       @api_client = api_client
     end
     # Add user to workspace
+    # Adds an existing user to the workspace with a specified role. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param workspace_user_input [WorkspaceUserInput] 
     # @param [Hash] opts the optional parameters
@@ -30,6 +31,7 @@ module PostBoost
     end
 
     # Add user to workspace
+    # Adds an existing user to the workspace with a specified role. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param workspace_user_input [WorkspaceUserInput] 
     # @param [Hash] opts the optional parameters
@@ -91,6 +93,154 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Create a scoped API key
+    # Creates a least-privilege API key for the calling user, bound to this workspace. Pick the abilities it gets and, optionally, the accounts it may act on. The plain key is in `data.token` of this response only; store it safely.  | Ability | Allows | |---|---| | `read` | Every `GET`, plus the `posts/validate` dry run | | `write` | Creating and changing drafts, media, tags, mentions, the brand voice | | `publish` | Scheduling, queueing, publishing now, approving and retrying posts, and editing a post that is already scheduled | | `ai` | The `/ai/*` endpoints, running agents and turning on agent AI review (they also need AI credits) | | `webhooks` | Webhook subscription endpoints |  A scoped key is refused on other workspaces, on the admin panel, on API key management and on the app's built-in MCP endpoint (use `/mcp/postboost`). With `account_ids`, it may only name those accounts (in the URL, `accounts`, `account_ids` or post versions), cannot touch posts on other accounts, and `GET accounts` / `GET posts` only list matching items (pagination counts are computed before that filter). Workspace admins only, called with an unscoped key. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param api_key_input [ApiKeyInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [CreateApiKey201Response]
+    def create_api_key(workspace_uuid, api_key_input, opts = {})
+      data, _status_code, _headers = create_api_key_with_http_info(workspace_uuid, api_key_input, opts)
+      data
+    end
+
+    # Create a scoped API key
+    # Creates a least-privilege API key for the calling user, bound to this workspace. Pick the abilities it gets and, optionally, the accounts it may act on. The plain key is in `data.token` of this response only; store it safely.  | Ability | Allows | |---|---| | `read` | Every `GET`, plus the `posts/validate` dry run | | `write` | Creating and changing drafts, media, tags, mentions, the brand voice | | `publish` | Scheduling, queueing, publishing now, approving and retrying posts, and editing a post that is already scheduled | | `ai` | The `/ai/*` endpoints, running agents and turning on agent AI review (they also need AI credits) | | `webhooks` | Webhook subscription endpoints |  A scoped key is refused on other workspaces, on the admin panel, on API key management and on the app's built-in MCP endpoint (use `/mcp/postboost`). With `account_ids`, it may only name those accounts (in the URL, `accounts`, `account_ids` or post versions), cannot touch posts on other accounts, and `GET accounts` / `GET posts` only list matching items (pagination counts are computed before that filter). Workspace admins only, called with an unscoped key. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param api_key_input [ApiKeyInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CreateApiKey201Response, Integer, Hash)>] CreateApiKey201Response data, response status code and response headers
+    def create_api_key_with_http_info(workspace_uuid, api_key_input, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.create_api_key ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.create_api_key"
+      end
+      # verify the required parameter 'api_key_input' is set
+      if @api_client.config.client_side_validation && api_key_input.nil?
+        fail ArgumentError, "Missing the required parameter 'api_key_input' when calling WorkspacesApi.create_api_key"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/api-keys'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(api_key_input)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CreateApiKey201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.create_api_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#create_api_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create a client workspace
+    # Creates a client workspace on the Reseller client plan, with the caller as its owner and admin, and links it to this workspace. Fails with `422` and `code: client_limit_reached` once the plan's client limit is used (archived clients do not count). Archive clients on the Client workspaces page. Workspace admins with an unscoped key only. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param reseller_client_input [ResellerClientInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [CreateResellerClient201Response]
+    def create_reseller_client(workspace_uuid, reseller_client_input, opts = {})
+      data, _status_code, _headers = create_reseller_client_with_http_info(workspace_uuid, reseller_client_input, opts)
+      data
+    end
+
+    # Create a client workspace
+    # Creates a client workspace on the Reseller client plan, with the caller as its owner and admin, and links it to this workspace. Fails with &#x60;422&#x60; and &#x60;code: client_limit_reached&#x60; once the plan&#39;s client limit is used (archived clients do not count). Archive clients on the Client workspaces page. Workspace admins with an unscoped key only. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param reseller_client_input [ResellerClientInput] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CreateResellerClient201Response, Integer, Hash)>] CreateResellerClient201Response data, response status code and response headers
+    def create_reseller_client_with_http_info(workspace_uuid, reseller_client_input, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.create_reseller_client ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.create_reseller_client"
+      end
+      # verify the required parameter 'reseller_client_input' is set
+      if @api_client.config.client_side_validation && reseller_client_input.nil?
+        fail ArgumentError, "Missing the required parameter 'reseller_client_input' when calling WorkspacesApi.create_reseller_client"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/clients'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(reseller_client_input)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CreateResellerClient201Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.create_reseller_client",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#create_reseller_client\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create workspace
     # Create a new workspace. Admin only.
     # @param workspace_input [WorkspaceInput] 
@@ -159,7 +309,77 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Revoke a scoped API key
+    # Revokes a scoped key bound to this workspace. It stops working at once. Workspace admins only, called with an unscoped key.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param api_key_id [Integer] The key&#39;s &#x60;id&#x60; from &#x60;GET api-keys&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Object]
+    def delete_api_key(workspace_uuid, api_key_id, opts = {})
+      data, _status_code, _headers = delete_api_key_with_http_info(workspace_uuid, api_key_id, opts)
+      data
+    end
+
+    # Revoke a scoped API key
+    # Revokes a scoped key bound to this workspace. It stops working at once. Workspace admins only, called with an unscoped key.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param api_key_id [Integer] The key&#39;s &#x60;id&#x60; from &#x60;GET api-keys&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def delete_api_key_with_http_info(workspace_uuid, api_key_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.delete_api_key ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.delete_api_key"
+      end
+      # verify the required parameter 'api_key_id' is set
+      if @api_client.config.client_side_validation && api_key_id.nil?
+        fail ArgumentError, "Missing the required parameter 'api_key_id' when calling WorkspacesApi.delete_api_key"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/api-keys/{apiKeyId}'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s)).sub('{' + 'apiKeyId' + '}', CGI.escape(api_key_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.delete_api_key",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#delete_api_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete workspace
+    # Permanently deletes a single workspace and all its associated data. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -169,6 +389,7 @@ module PostBoost
     end
 
     # Delete workspace
+    # Permanently deletes a single workspace and all its associated data. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -221,6 +442,7 @@ module PostBoost
     end
 
     # Delete workspaces (bulk)
+    # Permanently deletes one or more workspaces and all their associated data. Admin only.
     # @param delete_workspaces_bulk_request [DeleteWorkspacesBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Object]
@@ -230,6 +452,7 @@ module PostBoost
     end
 
     # Delete workspaces (bulk)
+    # Permanently deletes one or more workspaces and all their associated data. Admin only.
     # @param delete_workspaces_bulk_request [DeleteWorkspacesBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
@@ -287,6 +510,7 @@ module PostBoost
     end
 
     # Get workspace
+    # Returns a single workspace by UUID including its subscription status. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Workspace]
@@ -296,6 +520,7 @@ module PostBoost
     end
 
     # Get workspace
+    # Returns a single workspace by UUID including its subscription status. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param [Hash] opts the optional parameters
     # @return [Array<(Workspace, Integer, Hash)>] Workspace data, response status code and response headers
@@ -347,12 +572,322 @@ module PostBoost
       return data, status_code, headers
     end
 
+    # Get workspace AI credits
+    # Returns whether the workspace can use AI credits, its remaining balance, and whether the balance is low. Admin only.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [AICredits]
+    def get_workspace_ai_credits(workspace_uuid, opts = {})
+      data, _status_code, _headers = get_workspace_ai_credits_with_http_info(workspace_uuid, opts)
+      data
+    end
+
+    # Get workspace AI credits
+    # Returns whether the workspace can use AI credits, its remaining balance, and whether the balance is low. Admin only.
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AICredits, Integer, Hash)>] AICredits data, response status code and response headers
+    def get_workspace_ai_credits_with_http_info(workspace_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.get_workspace_ai_credits ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.get_workspace_ai_credits"
+      end
+      # resource path
+      local_var_path = '/panel/workspaces/{workspaceUuid}/ai-credits'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AICredits'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.get_workspace_ai_credits",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#get_workspace_ai_credits\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # X (Twitter) usage
+    # The workspace's X posts this calendar month (UTC) against its monthly X allowance. Every thread part is one X post; a part with a link also counts as a link post. When the allowance is used up, scheduling to X is refused (`429`, `code: x_monthly_cap_reached`) and X posts that come due fail with \"Monthly X allowance reached\". Other networks are not affected. See the X policy in the developer docs. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [XUsage]
+    def get_x_usage(workspace_uuid, opts = {})
+      data, _status_code, _headers = get_x_usage_with_http_info(workspace_uuid, opts)
+      data
+    end
+
+    # X (Twitter) usage
+    # The workspace&#39;s X posts this calendar month (UTC) against its monthly X allowance. Every thread part is one X post; a part with a link also counts as a link post. When the allowance is used up, scheduling to X is refused (&#x60;429&#x60;, &#x60;code: x_monthly_cap_reached&#x60;) and X posts that come due fail with \&quot;Monthly X allowance reached\&quot;. Other networks are not affected. See the X policy in the developer docs. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(XUsage, Integer, Hash)>] XUsage data, response status code and response headers
+    def get_x_usage_with_http_info(workspace_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.get_x_usage ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.get_x_usage"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/usage/x'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'XUsage'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.get_x_usage",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#get_x_usage\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List scoped API keys
+    # Scoped API keys bound to this workspace, newest first. The secret is never shown again after creation. Workspace admins only, called with an unscoped key (a scoped key gets `403` with `code: insufficient_scope`). 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [ListApiKeys200Response]
+    def list_api_keys(workspace_uuid, opts = {})
+      data, _status_code, _headers = list_api_keys_with_http_info(workspace_uuid, opts)
+      data
+    end
+
+    # List scoped API keys
+    # Scoped API keys bound to this workspace, newest first. The secret is never shown again after creation. Workspace admins only, called with an unscoped key (a scoped key gets &#x60;403&#x60; with &#x60;code: insufficient_scope&#x60;). 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ListApiKeys200Response, Integer, Hash)>] ListApiKeys200Response data, response status code and response headers
+    def list_api_keys_with_http_info(workspace_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.list_api_keys ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.list_api_keys"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/api-keys'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListApiKeys200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.list_api_keys",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#list_api_keys\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List my workspaces
+    # Returns the workspaces the authenticated user belongs to, most recently updated first, with the caller's role in each. Use a returned `uuid` as `workspaceUuid`.
+    # @param [Hash] opts the optional parameters
+    # @return [ListMyWorkspaces200Response]
+    def list_my_workspaces(opts = {})
+      data, _status_code, _headers = list_my_workspaces_with_http_info(opts)
+      data
+    end
+
+    # List my workspaces
+    # Returns the workspaces the authenticated user belongs to, most recently updated first, with the caller&#39;s role in each. Use a returned &#x60;uuid&#x60; as &#x60;workspaceUuid&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ListMyWorkspaces200Response, Integer, Hash)>] ListMyWorkspaces200Response data, response status code and response headers
+    def list_my_workspaces_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.list_my_workspaces ...'
+      end
+      # resource path
+      local_var_path = '/workspaces'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListMyWorkspaces200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.list_my_workspaces",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#list_my_workspaces\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List client workspaces
+    # Client workspaces this workspace created on the Reseller plan, active first, then archived. `accounts_needing_reconnect` counts accounts whose connection must be renewed. `meta` gives the active clients and the plan's client limit. Workspace admins with an unscoped key only; other workspaces get `403` with `code: not_a_reseller`. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [ListResellerClients200Response]
+    def list_reseller_clients(workspace_uuid, opts = {})
+      data, _status_code, _headers = list_reseller_clients_with_http_info(workspace_uuid, opts)
+      data
+    end
+
+    # List client workspaces
+    # Client workspaces this workspace created on the Reseller plan, active first, then archived. &#x60;accounts_needing_reconnect&#x60; counts accounts whose connection must be renewed. &#x60;meta&#x60; gives the active clients and the plan&#39;s client limit. Workspace admins with an unscoped key only; other workspaces get &#x60;403&#x60; with &#x60;code: not_a_reseller&#x60;. 
+    # @param workspace_uuid [String] UUID of the workspace.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ListResellerClients200Response, Integer, Hash)>] ListResellerClients200Response data, response status code and response headers
+    def list_reseller_clients_with_http_info(workspace_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WorkspacesApi.list_reseller_clients ...'
+      end
+      # verify the required parameter 'workspace_uuid' is set
+      if @api_client.config.client_side_validation && workspace_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_uuid' when calling WorkspacesApi.list_reseller_clients"
+      end
+      # resource path
+      local_var_path = '/{workspaceUuid}/clients'.sub('{' + 'workspaceUuid' + '}', CGI.escape(workspace_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ListResellerClients200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WorkspacesApi.list_reseller_clients",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WorkspacesApi#list_reseller_clients\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List workspaces
     # Returns a paginated list of all workspaces. Admin only.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :keyword 
     # @option opts [String] :subscription_status 
     # @option opts [String] :access_status 
+    # @option opts [Integer] :page Page number (15 items per page). (default to 1)
     # @return [ListWorkspaces200Response]
     def list_workspaces(opts = {})
       data, _status_code, _headers = list_workspaces_with_http_info(opts)
@@ -365,6 +900,7 @@ module PostBoost
     # @option opts [String] :keyword 
     # @option opts [String] :subscription_status 
     # @option opts [String] :access_status 
+    # @option opts [Integer] :page Page number (15 items per page). (default to 1)
     # @return [Array<(ListWorkspaces200Response, Integer, Hash)>] ListWorkspaces200Response data, response status code and response headers
     def list_workspaces_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -386,6 +922,7 @@ module PostBoost
       query_params[:'keyword'] = opts[:'keyword'] if !opts[:'keyword'].nil?
       query_params[:'subscription_status'] = opts[:'subscription_status'] if !opts[:'subscription_status'].nil?
       query_params[:'access_status'] = opts[:'access_status'] if !opts[:'access_status'].nil?
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -422,6 +959,7 @@ module PostBoost
     end
 
     # Remove user from workspace
+    # Removes a user's access to the workspace. The user account is not deleted. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param remove_user_from_workspace_request [RemoveUserFromWorkspaceRequest] 
     # @param [Hash] opts the optional parameters
@@ -432,6 +970,7 @@ module PostBoost
     end
 
     # Remove user from workspace
+    # Removes a user&#39;s access to the workspace. The user account is not deleted. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param remove_user_from_workspace_request [RemoveUserFromWorkspaceRequest] 
     # @param [Hash] opts the optional parameters
@@ -494,6 +1033,7 @@ module PostBoost
     end
 
     # Update workspace
+    # Updates a workspace's name, owner, or access status. Admin only. `hex_color` is accepted but ignored.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param workspace_input [WorkspaceInput] 
     # @param [Hash] opts the optional parameters
@@ -504,6 +1044,7 @@ module PostBoost
     end
 
     # Update workspace
+    # Updates a workspace&#39;s name, owner, or access status. Admin only. &#x60;hex_color&#x60; is accepted but ignored.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param workspace_input [WorkspaceInput] 
     # @param [Hash] opts the optional parameters
@@ -566,6 +1107,7 @@ module PostBoost
     end
 
     # Update user role in workspace
+    # Changes a user's role or permissions within the workspace. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param workspace_user_input [WorkspaceUserInput] 
     # @param [Hash] opts the optional parameters
@@ -576,6 +1118,7 @@ module PostBoost
     end
 
     # Update user role in workspace
+    # Changes a user&#39;s role or permissions within the workspace. Admin only.
     # @param workspace_uuid [String] UUID of the workspace.
     # @param workspace_user_input [WorkspaceUserInput] 
     # @param [Hash] opts the optional parameters