hanzoai 8.5.156

data/lib/hanzoai/api/link_api.rb

@@ -0,0 +1,710 @@
+=begin
+#Hanzo Cloud API
+
+#The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
+
+The version of the OpenAPI document: v1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.14.0
+
+=end
+
+require 'cgi'
+
+module Hanzoai
+  class LinkApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Logs out one account and stops the sessions it was running.
+    # Logs out one account and stops the sessions it was running.  It revokes a single linked account and stops the agent sessions that ran under it, answering with the revoked row and how many sessions stopped. The link is RETAINED with a revoked status rather than deleted, so its usage history and the audit trail survive the log-out — which also means a revoked account still appears in the list, and is excluded from the route plan rather than absent from it. The session stop is narrowed to the revoking user's own sessions on that device, provider and account, and a stop that fails does not fail the revoke: the revoked row is the durable truth. An id that does not exist, or belongs to another user or org, is the same 404.
+    # @param id [String] ID is the link to act on, from the path. It is scoped to the caller, so another user's or org's id is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [RevokeResp]
+    def delete_link_by_id(id, opts = {})
+      data, _status_code, _headers = delete_link_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Logs out one account and stops the sessions it was running.
+    # Logs out one account and stops the sessions it was running.  It revokes a single linked account and stops the agent sessions that ran under it, answering with the revoked row and how many sessions stopped. The link is RETAINED with a revoked status rather than deleted, so its usage history and the audit trail survive the log-out — which also means a revoked account still appears in the list, and is excluded from the route plan rather than absent from it. The session stop is narrowed to the revoking user's own sessions on that device, provider and account, and a stop that fails does not fail the revoke: the revoked row is the durable truth. An id that does not exist, or belongs to another user or org, is the same 404.
+    # @param id [String] ID is the link to act on, from the path. It is scoped to the caller, so another user's or org's id is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RevokeResp, Integer, Hash)>] RevokeResp data, response status code and response headers
+    def delete_link_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.delete_link_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling LinkApi.delete_link_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/link/{id}'.sub('{' + 'id' + '}', CGI.escape(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] || 'RevokeResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.delete_link_by_id",
+        :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: LinkApi#delete_link_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Lists your linked accounts and the devices they sit on.
+    # Lists your linked accounts and the devices they sit on.  It answers the caller's own links plus a devices projection of the same rows folded per machine — the cross-machine \"AI Providers / Accounts\" view. A device is a projection, not a stored entity: its labels come from its most-recently-seen account, so there is no device to create and none to garbage-collect. Revoked links are INCLUDED rather than dropped, because a logged-out account keeps its usage history and audit trail. Scoped to the caller: a validated principal and a non-empty org, else 403.
+    # @param [Hash] opts the optional parameters
+    # @return [LinkList]
+    def get_link(opts = {})
+      data, _status_code, _headers = get_link_with_http_info(opts)
+      data
+    end
+
+    # Lists your linked accounts and the devices they sit on.
+    # Lists your linked accounts and the devices they sit on.  It answers the caller&#39;s own links plus a devices projection of the same rows folded per machine — the cross-machine \&quot;AI Providers / Accounts\&quot; view. A device is a projection, not a stored entity: its labels come from its most-recently-seen account, so there is no device to create and none to garbage-collect. Revoked links are INCLUDED rather than dropped, because a logged-out account keeps its usage history and audit trail. Scoped to the caller: a validated principal and a non-empty org, else 403.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LinkList, Integer, Hash)>] LinkList data, response status code and response headers
+    def get_link_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link ...'
+      end
+      # resource path
+      local_var_path = '/v1/link'
+
+      # 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] || 'LinkList'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link",
+        :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: LinkApi#get_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reads one linked account.
+    # Reads one linked account.  It answers a single link — its device, provider, account, plan, how it bills, its status and its latest usage snapshot. An id that does not exist, or belongs to another user or org, is the same 404: the scope is a bound predicate on the read, so a wrong id and a foreign id are indistinguishable and neither confirms the other's existence. The static paths on this collection — route, usage, devices — register before this one and win first-match, so a link whose id collided with one of those words could not be addressed here.
+    # @param id [String] ID is the link to act on, from the path. It is scoped to the caller, so another user&#39;s or org&#39;s id is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [LinkView]
+    def get_link_by_id(id, opts = {})
+      data, _status_code, _headers = get_link_by_id_with_http_info(id, opts)
+      data
+    end
+
+    # Reads one linked account.
+    # Reads one linked account.  It answers a single link — its device, provider, account, plan, how it bills, its status and its latest usage snapshot. An id that does not exist, or belongs to another user or org, is the same 404: the scope is a bound predicate on the read, so a wrong id and a foreign id are indistinguishable and neither confirms the other&#39;s existence. The static paths on this collection — route, usage, devices — register before this one and win first-match, so a link whose id collided with one of those words could not be addressed here.
+    # @param id [String] ID is the link to act on, from the path. It is scoped to the caller, so another user&#39;s or org&#39;s id is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LinkView, Integer, Hash)>] LinkView data, response status code and response headers
+    def get_link_by_id_with_http_info(id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link_by_id ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling LinkApi.get_link_by_id"
+      end
+      # resource path
+      local_var_path = '/v1/link/{id}'.sub('{' + 'id' + '}', CGI.escape(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] || 'LinkView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link_by_id",
+        :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: LinkApi#get_link_by_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Shows one machine: its accounts, usage and live sessions.
+    # Shows one machine: its accounts, usage and live sessions.  It answers one device — its host and OS labels, every account the caller has signed in on that machine with its latest usage, and how many agent sessions the caller currently has running on it. The device labels come from the most-recently-seen account, since a device is a projection of its links rather than a row of its own. A machine with none of the caller's accounts is 404, which is also the answer when the machine belongs to someone else — the scope makes the two indistinguishable, deliberately. The session count reports 0 where the agent plane is not mounted rather than failing the read.
+    # @param machine [String] Machine is the machine to act on, from the path. It is scoped to the caller, so a machine with none of the caller&#39;s accounts is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [DeviceView]
+    def get_link_devices_by_machine(machine, opts = {})
+      data, _status_code, _headers = get_link_devices_by_machine_with_http_info(machine, opts)
+      data
+    end
+
+    # Shows one machine: its accounts, usage and live sessions.
+    # Shows one machine: its accounts, usage and live sessions.  It answers one device — its host and OS labels, every account the caller has signed in on that machine with its latest usage, and how many agent sessions the caller currently has running on it. The device labels come from the most-recently-seen account, since a device is a projection of its links rather than a row of its own. A machine with none of the caller&#39;s accounts is 404, which is also the answer when the machine belongs to someone else — the scope makes the two indistinguishable, deliberately. The session count reports 0 where the agent plane is not mounted rather than failing the read.
+    # @param machine [String] Machine is the machine to act on, from the path. It is scoped to the caller, so a machine with none of the caller&#39;s accounts is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeviceView, Integer, Hash)>] DeviceView data, response status code and response headers
+    def get_link_devices_by_machine_with_http_info(machine, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link_devices_by_machine ...'
+      end
+      # verify the required parameter 'machine' is set
+      if @api_client.config.client_side_validation && machine.nil?
+        fail ArgumentError, "Missing the required parameter 'machine' when calling LinkApi.get_link_devices_by_machine"
+      end
+      # resource path
+      local_var_path = '/v1/link/devices/{machine}'.sub('{' + 'machine' + '}', CGI.escape(machine.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] || 'DeviceView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link_devices_by_machine",
+        :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: LinkApi#get_link_devices_by_machine\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Gets the failover order across your linked accounts.
+    # Gets the failover order across your linked accounts.  It answers an ordered redundancy plan over the caller's LINKED (not revoked) accounts: each candidate with its remaining rate-limit headroom, whether it is routable right now, how it BILLS (plan or commerce), and a reason when it is not — plus the primary to try first. It is what lets a router fail over from one subscription to another and fall back to the metered API as the always-available backstop, knowing the cost consequence before it dials.  It is POLICY, not execution: the plan is computed purely from the usage snapshots already in the registry, never by probing a provider, so it is a total function of the links and costs nothing to ask for. Actually dialing, detecting a live 429 and advancing to the next candidate belongs to the caller. A link with no snapshot counts as full headroom.
+    # @param [Hash] opts the optional parameters
+    # @return [RoutePlan]
+    def get_link_route(opts = {})
+      data, _status_code, _headers = get_link_route_with_http_info(opts)
+      data
+    end
+
+    # Gets the failover order across your linked accounts.
+    # Gets the failover order across your linked accounts.  It answers an ordered redundancy plan over the caller&#39;s LINKED (not revoked) accounts: each candidate with its remaining rate-limit headroom, whether it is routable right now, how it BILLS (plan or commerce), and a reason when it is not — plus the primary to try first. It is what lets a router fail over from one subscription to another and fall back to the metered API as the always-available backstop, knowing the cost consequence before it dials.  It is POLICY, not execution: the plan is computed purely from the usage snapshots already in the registry, never by probing a provider, so it is a total function of the links and costs nothing to ask for. Actually dialing, detecting a live 429 and advancing to the next candidate belongs to the caller. A link with no snapshot counts as full headroom.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RoutePlan, Integer, Hash)>] RoutePlan data, response status code and response headers
+    def get_link_route_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link_route ...'
+      end
+      # resource path
+      local_var_path = '/v1/link/route'
+
+      # 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] || 'RoutePlan'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link_route",
+        :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: LinkApi#get_link_route\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Shows one provider account's own usage dashboard.
+    # Shows one provider account's own usage dashboard.  It answers the time series for a SINGLE provider account — the windows in range plus the currently-open ones — as that provider's own meter reported it: \"my plan is 47% through its 6h window, resets at 14:20\". current is the newest instance of each lane (the headline); windows is the history behind it, both computed from ONE deduped read. provider is required; an unknown window class or range is 400, never a quiet fallback to a different one. When no series is available the response is a 200 with available:false and empty lists — an honest \"we have no data\", which is a different claim from zero usage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :provider Provider is the provider whose meter to read. Required.
+    # @option opts [String] :account Account narrows to one account when a user has several with the provider.
+    # @option opts [String] :window Window selects a window class: 6h, day, week or month. Empty reads all.
+    # @option opts [String] :range Range is the period, one of 1h, 24h, 7d or 30d; empty means 24h, and an unknown label is 400, never a quiet fallback.
+    # @return [BoardResp]
+    def get_link_usage(opts = {})
+      data, _status_code, _headers = get_link_usage_with_http_info(opts)
+      data
+    end
+
+    # Shows one provider account&#39;s own usage dashboard.
+    # Shows one provider account&#39;s own usage dashboard.  It answers the time series for a SINGLE provider account — the windows in range plus the currently-open ones — as that provider&#39;s own meter reported it: \&quot;my plan is 47% through its 6h window, resets at 14:20\&quot;. current is the newest instance of each lane (the headline); windows is the history behind it, both computed from ONE deduped read. provider is required; an unknown window class or range is 400, never a quiet fallback to a different one. When no series is available the response is a 200 with available:false and empty lists — an honest \&quot;we have no data\&quot;, which is a different claim from zero usage.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :provider Provider is the provider whose meter to read. Required.
+    # @option opts [String] :account Account narrows to one account when a user has several with the provider.
+    # @option opts [String] :window Window selects a window class: 6h, day, week or month. Empty reads all.
+    # @option opts [String] :range Range is the period, one of 1h, 24h, 7d or 30d; empty means 24h, and an unknown label is 400, never a quiet fallback.
+    # @return [Array<(BoardResp, Integer, Hash)>] BoardResp data, response status code and response headers
+    def get_link_usage_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link_usage ...'
+      end
+      # resource path
+      local_var_path = '/v1/link/usage'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'provider'] = opts[:'provider'] if !opts[:'provider'].nil?
+      query_params[:'account'] = opts[:'account'] if !opts[:'account'].nil?
+      query_params[:'window'] = opts[:'window'] if !opts[:'window'].nil?
+      query_params[:'range'] = opts[:'range'] if !opts[:'range'].nil?
+
+      # 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] || 'BoardResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link_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: LinkApi#get_link_usage\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Breaks down what the gateway routed through each of your accounts.
+    # Breaks down what the gateway routed through each of your accounts.  It answers one row per linked account the GATEWAY actually routed through, plus their total — requests, prompt and completion tokens, and cost. This is the routed ledger, the read twin of the counter the router writes, and it is distinct from both of its neighbours: not the device collector's plan snapshots, and not the org money ledger. The source and scope fields on the response say so on every payload. The same shape answers in the billing namespace, from one shaping function, so the two mounts cannot drift.
+    # @param [Hash] opts the optional parameters
+    # @return [AccountsUsage]
+    def get_link_usage_accounts(opts = {})
+      data, _status_code, _headers = get_link_usage_accounts_with_http_info(opts)
+      data
+    end
+
+    # Breaks down what the gateway routed through each of your accounts.
+    # Breaks down what the gateway routed through each of your accounts.  It answers one row per linked account the GATEWAY actually routed through, plus their total — requests, prompt and completion tokens, and cost. This is the routed ledger, the read twin of the counter the router writes, and it is distinct from both of its neighbours: not the device collector&#39;s plan snapshots, and not the org money ledger. The source and scope fields on the response say so on every payload. The same shape answers in the billing namespace, from one shaping function, so the two mounts cannot drift.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(AccountsUsage, Integer, Hash)>] AccountsUsage data, response status code and response headers
+    def get_link_usage_accounts_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link_usage_accounts ...'
+      end
+      # resource path
+      local_var_path = '/v1/link/usage/accounts'
+
+      # 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] || 'AccountsUsage'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link_usage_accounts",
+        :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: LinkApi#get_link_usage_accounts\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Shows plan consumption and Hanzo spend side by side.
+    # Shows plan consumption and Hanzo spend side by side.  It answers the global usage board over one window: the caller's own linked accounts, metered from each provider's own login, alongside their org's Hanzo-routed inference. These come from different ledgers and mean different things, so every row is LABELLED by source, by scope and by availability, and THE TWO ARE NEVER SUMMED — a plan's percentage is not money, and a provider's own spend is not a Hanzo charge. The rows sit side by side and say what they are.  One resolver fixes the window for both halves, so the two sets always cover the same period. range is one of 1h, 24h, 7d or 30d and defaults to 24h; anything else is 400 rather than a silent substitution. A ledger that cannot answer reports available:false instead of a zero that would read as \"no usage\".
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :range Range is the period, one of 1h, 24h, 7d or 30d; empty means 24h, and an unknown label is 400, never a silent substitution.
+    # @return [SummaryResp]
+    def get_link_usage_summary(opts = {})
+      data, _status_code, _headers = get_link_usage_summary_with_http_info(opts)
+      data
+    end
+
+    # Shows plan consumption and Hanzo spend side by side.
+    # Shows plan consumption and Hanzo spend side by side.  It answers the global usage board over one window: the caller&#39;s own linked accounts, metered from each provider&#39;s own login, alongside their org&#39;s Hanzo-routed inference. These come from different ledgers and mean different things, so every row is LABELLED by source, by scope and by availability, and THE TWO ARE NEVER SUMMED — a plan&#39;s percentage is not money, and a provider&#39;s own spend is not a Hanzo charge. The rows sit side by side and say what they are.  One resolver fixes the window for both halves, so the two sets always cover the same period. range is one of 1h, 24h, 7d or 30d and defaults to 24h; anything else is 400 rather than a silent substitution. A ledger that cannot answer reports available:false instead of a zero that would read as \&quot;no usage\&quot;.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :range Range is the period, one of 1h, 24h, 7d or 30d; empty means 24h, and an unknown label is 400, never a silent substitution.
+    # @return [Array<(SummaryResp, Integer, Hash)>] SummaryResp data, response status code and response headers
+    def get_link_usage_summary_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.get_link_usage_summary ...'
+      end
+      # resource path
+      local_var_path = '/v1/link/usage/summary'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'range'] = opts[:'range'] if !opts[:'range'].nil?
+
+      # 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] || 'SummaryResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.get_link_usage_summary",
+        :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: LinkApi#get_link_usage_summary\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Registers a signed-in AI provider account on a machine.
+    # Registers a signed-in AI provider account on a machine.  It records that a developer has signed into one provider account on one machine — a Claude Max or ChatGPT Plus subscription, a Hanzo key, a raw provider key — and answers 201 with the stored link. Re-reporting the same (machine, provider, account) UPDATES that link rather than creating a second, so a collector may call this on every heartbeat. machine and provider are required (400 otherwise), as is a valid kind, and every field is length-bounded. Scoped to the caller: a validated principal and a non-empty org, else 403, so a caller writes only their OWN accounts within their own org.
+    # @param enroll_req [EnrollReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [LinkView]
+    def post_link(enroll_req, opts = {})
+      data, _status_code, _headers = post_link_with_http_info(enroll_req, opts)
+      data
+    end
+
+    # Registers a signed-in AI provider account on a machine.
+    # Registers a signed-in AI provider account on a machine.  It records that a developer has signed into one provider account on one machine — a Claude Max or ChatGPT Plus subscription, a Hanzo key, a raw provider key — and answers 201 with the stored link. Re-reporting the same (machine, provider, account) UPDATES that link rather than creating a second, so a collector may call this on every heartbeat. machine and provider are required (400 otherwise), as is a valid kind, and every field is length-bounded. Scoped to the caller: a validated principal and a non-empty org, else 403, so a caller writes only their OWN accounts within their own org.
+    # @param enroll_req [EnrollReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LinkView, Integer, Hash)>] LinkView data, response status code and response headers
+    def post_link_with_http_info(enroll_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.post_link ...'
+      end
+      # verify the required parameter 'enroll_req' is set
+      if @api_client.config.client_side_validation && enroll_req.nil?
+        fail ArgumentError, "Missing the required parameter 'enroll_req' when calling LinkApi.post_link"
+      end
+      # resource path
+      local_var_path = '/v1/link'
+
+      # 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(enroll_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LinkView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.post_link",
+        :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: LinkApi#post_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Logs out every account on one machine and stops its sessions.
+    # Logs out every account on one machine and stops its sessions.  It revokes every one of the caller's accounts on one machine and stops the agent sessions they were running, answering with how many of each. This is the \"I lost that laptop\" button. Revoked links are RETAINED, not deleted, so usage history and the audit trail survive a log-out — the rows come back in the response with their new status. The session stop reaches only the REVOKING user's own sessions, so a shared machine name can never be used to stop a co-tenant's work, and a stop that fails does not fail the revoke: the revoked row is the durable truth and the count then honestly reports fewer. A machine with nothing left to revoke is 404.
+    # @param machine [String] Machine is the machine to act on, from the path. It is scoped to the caller, so a machine with none of the caller&#39;s accounts is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [RevokeResp]
+    def post_link_devices_by_machine_revoke(machine, opts = {})
+      data, _status_code, _headers = post_link_devices_by_machine_revoke_with_http_info(machine, opts)
+      data
+    end
+
+    # Logs out every account on one machine and stops its sessions.
+    # Logs out every account on one machine and stops its sessions.  It revokes every one of the caller&#39;s accounts on one machine and stops the agent sessions they were running, answering with how many of each. This is the \&quot;I lost that laptop\&quot; button. Revoked links are RETAINED, not deleted, so usage history and the audit trail survive a log-out — the rows come back in the response with their new status. The session stop reaches only the REVOKING user&#39;s own sessions, so a shared machine name can never be used to stop a co-tenant&#39;s work, and a stop that fails does not fail the revoke: the revoked row is the durable truth and the count then honestly reports fewer. A machine with nothing left to revoke is 404.
+    # @param machine [String] Machine is the machine to act on, from the path. It is scoped to the caller, so a machine with none of the caller&#39;s accounts is a 404.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RevokeResp, Integer, Hash)>] RevokeResp data, response status code and response headers
+    def post_link_devices_by_machine_revoke_with_http_info(machine, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.post_link_devices_by_machine_revoke ...'
+      end
+      # verify the required parameter 'machine' is set
+      if @api_client.config.client_side_validation && machine.nil?
+        fail ArgumentError, "Missing the required parameter 'machine' when calling LinkApi.post_link_devices_by_machine_revoke"
+      end
+      # resource path
+      local_var_path = '/v1/link/devices/{machine}/revoke'.sub('{' + 'machine' + '}', CGI.escape(machine.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] || 'RevokeResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.post_link_devices_by_machine_revoke",
+        :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: LinkApi#post_link_devices_by_machine_revoke\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Reports usage samples from the device collector.
+    # Reports usage samples from the device collector.  It ingests a batch of usage samples and answers with how many were accepted, whether history was durably stored, and the links they refreshed. A report also REFRESHES one link per distinct (machine, provider, account) it names, so a running collector keeps the accounts overview current without a separate registration call.  A caller can only ever report for THEMSELVES: org and subject come from the validated bearer, never from the body, so no sample can be attributed to another user or tenant. History is FAIL-SOFT and stored says which happened — a warehouse outage still accepts the report and refreshes the links rather than failing the device, and answers 202 either way. Send either one sample inline or up to 256 in samples; an empty batch or an over-long one is 400, as is a provider, window class or kind outside the closed vocabulary — an unrecognized window is refused rather than rewritten, because a silently reclassified sample would fill a dashboard with a class nobody reported.
+    # @param ingest_req [IngestReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [IngestResp]
+    def post_link_usage(ingest_req, opts = {})
+      data, _status_code, _headers = post_link_usage_with_http_info(ingest_req, opts)
+      data
+    end
+
+    # Reports usage samples from the device collector.
+    # Reports usage samples from the device collector.  It ingests a batch of usage samples and answers with how many were accepted, whether history was durably stored, and the links they refreshed. A report also REFRESHES one link per distinct (machine, provider, account) it names, so a running collector keeps the accounts overview current without a separate registration call.  A caller can only ever report for THEMSELVES: org and subject come from the validated bearer, never from the body, so no sample can be attributed to another user or tenant. History is FAIL-SOFT and stored says which happened — a warehouse outage still accepts the report and refreshes the links rather than failing the device, and answers 202 either way. Send either one sample inline or up to 256 in samples; an empty batch or an over-long one is 400, as is a provider, window class or kind outside the closed vocabulary — an unrecognized window is refused rather than rewritten, because a silently reclassified sample would fill a dashboard with a class nobody reported.
+    # @param ingest_req [IngestReq] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(IngestResp, Integer, Hash)>] IngestResp data, response status code and response headers
+    def post_link_usage_with_http_info(ingest_req, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LinkApi.post_link_usage ...'
+      end
+      # verify the required parameter 'ingest_req' is set
+      if @api_client.config.client_side_validation && ingest_req.nil?
+        fail ArgumentError, "Missing the required parameter 'ingest_req' when calling LinkApi.post_link_usage"
+      end
+      # resource path
+      local_var_path = '/v1/link/usage'
+
+      # 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(ingest_req)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'IngestResp'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"LinkApi.post_link_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(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: LinkApi#post_link_usage\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end