bzapper 0.7.0

data/lib/bzapper/errors.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module Bzapper
+  # Erro devolvido pela API do bZapper (ou de rede, em {NetworkError}).
+  #
+  # Toda resposta fora de 2xx vira um `Bzapper::Error` — ou a subclasse do status. **Use
+  # {#code} na sua lógica**: ele é estável (`instance_not_connected`, `insufficient_scope`…).
+  # O {#message} é o `message` do corpo — texto para humanos, traduzido conforme `locale:`, que
+  # pode mudar (sem corpo JSON, é o próprio {#code}). {#detailed_message} junta código, status,
+  # escopo exigido, `Retry-After` e `request_id` (é o que aparece num erro não tratado).
+  #
+  # Argumento inválido no seu código (chave vazia, parâmetro de caminho vazio/"."/"..") NÃO é
+  # `Bzapper::Error`: é `ArgumentError`/`TypeError`, na hora, sem requisição.
+  class Error < StandardError
+    # @return [String] código estável: `body.code`, senão `body.error`, senão `HTTP_<status>`
+    #   (corpo não-JSON); `INVALID_RESPONSE` quando um 2xx chega com corpo que não é JSON;
+    #   `NETWORK_ERROR` em falha de rede.
+    attr_reader :code
+    # @return [Integer] status HTTP (`0` em erro de rede).
+    attr_reader :status
+    # @return [String, nil] header `X-Request-Id` da resposta, senão o `X-Request-Id` que a SDK
+    #   enviou. Informe-o ao suporte.
+    attr_reader :request_id
+    # @return [Integer, Float, nil] segundos do header `Retry-After` (só em 429).
+    attr_reader :retry_after
+    # @return [String, nil] escopo que faltou na chave (header `X-Required-Scope`, só em 403).
+    attr_reader :required_scope
+    # @return [String, nil] idioma da mensagem (`body.locale`), quando veio.
+    attr_reader :locale
+    # @return [Hash, String, nil] corpo da resposta decodificado, ou o texto cru se não é JSON.
+    attr_reader :body
+
+    def initialize(message = nil, code: nil, status: 0, request_id: nil, retry_after: nil,
+                   required_scope: nil, locale: nil, body: nil)
+      @code = code
+      @status = status
+      @request_id = request_id
+      @retry_after = retry_after
+      @required_scope = required_scope
+      @locale = locale
+      @body = body
+      super(message || code || self.class.name)
+    end
+
+    # Mensagem completa: `code (HTTP status): message — escopo… [request_id=…]`.
+    # @return [String]
+    def detailed_message(highlight: false, **_options) # rubocop:disable Lint/UnusedMethodArgument
+      text = +"#{code} (HTTP #{status})"
+      text << ": #{message}" unless message == code
+      text << " — escopo exigido: #{required_scope}" if required_scope
+      text << " — tente de novo em #{retry_after}s" unless retry_after.nil?
+      text << " [request_id=#{request_id}]" if request_id
+      text
+    end
+
+    # Alias do padrão Berni (`status_code` nas SDKs Python/PHP).
+    # @return [Integer]
+    def status_code
+      status
+    end
+
+    def inspect
+      "#<#{self.class.name} code=#{code.inspect} status=#{status.inspect} " \
+        "request_id=#{request_id.inspect}>"
+    end
+
+    STATUS_CLASSES = {} # preenchido abaixo, depois das subclasses
+    private_constant :STATUS_CLASSES
+
+    # Classe de erro para um status HTTP (5xx → {ServerError}; sem classe própria → a base).
+    # @param status [Integer]
+    # @return [Class]
+    def self.class_for(status)
+      return STATUS_CLASSES[status] if STATUS_CLASSES.key?(status)
+      return ServerError if status >= 500 && status <= 599
+
+      Error
+    end
+  end
+
+  # Nome da base no padrão Berni (`BzapperError` nas outras SDKs). É a MESMA classe.
+  BzapperError = Error
+
+  # 401 — chave ausente, inválida ou revogada (`connect_revoked` numa conexão Connect encerrada).
+  class AuthenticationError < Error; end
+
+  # 403 — sem permissão: papel insuficiente ou escopo faltando na chave ({#required_scope}).
+  class PermissionDeniedError < Error; end
+
+  # 404 — o recurso não existe (ou não é deste projeto).
+  class NotFoundError < Error; end
+
+  # 409 — o estado atual impede a operação.
+  class ConflictError < Error; end
+
+  # 400 e 422 — corpo ou parâmetro inválido.
+  class ValidationError < Error; end
+
+  # 429 — limite de requisições; {#retry_after} diz quanto esperar.
+  class RateLimitError < Error; end
+
+  # 5xx — erro do lado da API. Informe o {#request_id}.
+  class ServerError < Error; end
+
+  # Falha de conexão ou timeout (`status == 0`, `code == "NETWORK_ERROR"`).
+  class NetworkError < Error
+    def initialize(message = nil, request_id: nil, **_ignored)
+      super(message || "NETWORK_ERROR", code: "NETWORK_ERROR", status: 0, request_id: request_id)
+    end
+  end
+
+  class Error
+    STATUS_CLASSES.merge!(
+      400 => ValidationError,
+      401 => AuthenticationError,
+      403 => PermissionDeniedError,
+      404 => NotFoundError,
+      409 => ConflictError,
+      422 => ValidationError,
+      429 => RateLimitError
+    ).freeze
+  end
+
+  # Assinatura de webhook ausente ou inválida ({Webhook.construct_event}). Não processe o evento.
+  class SignatureError < StandardError; end
+end

data/lib/bzapper/resources/accounts.rb

@@ -0,0 +1,394 @@
+# frozen_string_literal: true
+
+# GERADO por script/generate.rb a partir de packages/sdk/openapi.yaml — não edite à mão.
+
+module Bzapper
+  module Resources
+    # Conta, perfil, chaves de API, marca, projetos e usuários — `client.accounts`.
+    class Accounts < Base
+      # List the tenant's API keys (without the raw key). `GET /keys`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def list_my_keys(timeout: nil)
+        request("GET", "/keys", timeout: timeout)
+      end
+
+      # Generate a tenant API key (raw key shown only once). Admin only — an agent key/user gets 403
+      # admin_required. `POST /keys`
+      #
+      # @param name [String, nil] (corpo)
+      # @param role [String, nil] (corpo) Role of the key/user (super_admin is via the admin token).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def create_my_key(name: UNSET, role: UNSET, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "name" => name,
+          "role" => role
+        )
+        request("POST", "/keys", body: payload, idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Revoke a tenant API key. Admin only. `DELETE /keys/{id}`
+      #
+      # @param id [String] Instance ID (UUID).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def revoke_my_key(id, idempotency_key: nil, timeout: nil)
+        request("DELETE",
+                "/keys/#{segment(id, "id")}",
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Authenticated identity (+ profile when it's a user session). `GET /me`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_me(timeout: nil)
+        request("GET", "/me", timeout: timeout)
+      end
+
+      # Update the user profile (name/phone/job title). `PATCH /me`
+      #
+      # @param name [String, nil] (corpo)
+      # @param phone [String, nil] (corpo) Stored as +DDIdigits.
+      # @param job_title [String, nil] (corpo)
+      # @param locale [String, nil] (corpo) UI language to persist on the account (e.g. pt-BR). Empty
+      #   = unchanged.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def update_profile(name: UNSET, phone: UNSET, job_title: UNSET, locale: UNSET,
+                         idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "name" => name,
+          "phone" => phone,
+          "job_title" => job_title,
+          "locale" => locale
+        )
+        request("PATCH", "/me", body: payload, idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Shared identity of the numbers (brand kit + "About"). `GET /brand`
+      #
+      # Returns the tenant identity. Only `about` is applicable to the WhatsApp profile; each number's
+      # profile name and photo are set by the customer on their own phone when pairing the number
+      # (WhatsApp does not allow a linked device to change them).
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_brand(timeout: nil)
+        request("GET", "/brand", timeout: timeout)
+      end
+
+      # Update the shared identity. `PUT /brand`
+      #
+      # @param about [String, nil] (corpo) "About"/status — applied to all numbers.
+      # @param display_name [String, nil] (corpo) Business name (kit).
+      # @param logo_url [String, nil] (corpo) Logo URL (kit).
+      # @param website [String, nil] (corpo)
+      # @param email [String, nil] (corpo)
+      # @param phone [String, nil] (corpo) Contact phone in E.164 (+DDIdigits).
+      # @param address [String, nil] (corpo)
+      # @param description [String, nil] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def set_brand(about: UNSET, display_name: UNSET, logo_url: UNSET, website: UNSET,
+                    email: UNSET, phone: UNSET, address: UNSET, description: UNSET,
+                    idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "about" => about,
+          "display_name" => display_name,
+          "logo_url" => logo_url,
+          "website" => website,
+          "email" => email,
+          "phone" => phone,
+          "address" => address,
+          "description" => description
+        )
+        request("PUT", "/brand", body: payload, idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Apply the "About" to ALL connected numbers. `POST /brand/apply`
+      #
+      # Pushes the `about` (status message) to all of the tenant's connected numbers. Returns how many
+      # were applied, the skipped ones (disconnected) and the total.
+      #
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def apply_brand(idempotency_key: nil, timeout: nil)
+        request("POST", "/brand/apply", idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Upload the brand logo (multipart) → DO Spaces. `POST /brand/logo`
+      #
+      # @param file [String, IO, Pathname] conteúdo do arquivo (bytes), um IO ou o caminho no disco.
+      # @param filename [String, nil] nome do arquivo (padrão: o do caminho, senão "file").
+      # @param content_type [String, nil] tipo MIME (padrão: application/octet-stream).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def upload_brand_logo(file:, filename: nil, content_type: nil, idempotency_key: nil,
+                            timeout: nil)
+        request("POST",
+                "/brand/logo",
+                multipart: upload("file", file, filename, content_type),
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # List the account's projects. `GET /projects`
+      #
+      # Projects isolate numbers, inbox, API keys and statistics. Each API key belongs to ONE project;
+      # in the dashboard, the active project goes in the `X-Project-Id` header.
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def list_projects(timeout: nil)
+        request("GET", "/projects", timeout: timeout)
+      end
+
+      # Create a project (admin). `POST /projects`
+      #
+      # @param name [String] (corpo)
+      # @param api_mode [String, nil] (corpo) Rail of the project: UNOFFICIAL (QR-paired numbers) or
+      #   OFFICIAL (WhatsApp Cloud API). Immutable after creation.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def create_project(name:, api_mode: UNSET, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "name" => name,
+          "api_mode" => api_mode
+        )
+        request("POST",
+                "/projects",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Number status per project (traffic light). `GET /projects/health`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_projects_health(timeout: nil)
+        request("GET", "/projects/health", timeout: timeout)
+      end
+
+      # Update a project (admin). `PATCH /projects/{id}`
+      #
+      # `api_mode` is immutable and is ignored here.
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param name [String] (corpo)
+      # @param logo_url [String, nil] (corpo)
+      # @param color [String, nil] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def update_project(id, name:, logo_url: UNSET, color: UNSET, idempotency_key: nil,
+                         timeout: nil)
+        payload = compact(
+          "name" => name,
+          "logo_url" => logo_url,
+          "color" => color
+        )
+        request("PATCH",
+                "/projects/#{segment(id, "id")}",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Delete a project (admin). `DELETE /projects/{id}`
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def delete_project(id, idempotency_key: nil, timeout: nil)
+        request("DELETE",
+                "/projects/#{segment(id, "id")}",
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Identity of the numbers of a specific project. `GET /projects/{id}/brand`
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def get_project_brand(id, timeout: nil)
+        request("GET", "/projects/#{segment(id, "id")}/brand", timeout: timeout)
+      end
+
+      # Save the identity of a specific project's numbers (admin). `PUT /projects/{id}/brand`
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param about [String, nil] (corpo) "About"/status — applied to all numbers.
+      # @param display_name [String, nil] (corpo) Business name (kit).
+      # @param logo_url [String, nil] (corpo) Logo URL (kit).
+      # @param website [String, nil] (corpo)
+      # @param email [String, nil] (corpo)
+      # @param phone [String, nil] (corpo) Contact phone in E.164 (+DDIdigits).
+      # @param address [String, nil] (corpo)
+      # @param description [String, nil] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def set_project_brand(id, about: UNSET, display_name: UNSET, logo_url: UNSET, website: UNSET,
+                            email: UNSET, phone: UNSET, address: UNSET, description: UNSET,
+                            idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "about" => about,
+          "display_name" => display_name,
+          "logo_url" => logo_url,
+          "website" => website,
+          "email" => email,
+          "phone" => phone,
+          "address" => address,
+          "description" => description
+        )
+        request("PUT",
+                "/projects/#{segment(id, "id")}/brand",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Upload the project logo (multipart, PNG/JPEG/WebP up to 5 MB) — admin. `POST
+      # /projects/{id}/logo`
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param file [String, IO, Pathname] conteúdo do arquivo (bytes), um IO ou o caminho no disco.
+      # @param filename [String, nil] nome do arquivo (padrão: o do caminho, senão "file").
+      # @param content_type [String, nil] tipo MIME (padrão: application/octet-stream).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def upload_project_logo(id, file:, filename: nil, content_type: nil, idempotency_key: nil,
+                              timeout: nil)
+        request("POST",
+                "/projects/#{segment(id, "id")}/logo",
+                multipart: upload("file", file, filename, content_type),
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # List the account's users. `GET /users`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def list_users(timeout: nil)
+        request("GET", "/users", timeout: timeout)
+      end
+
+      # Invite a user (admin). `POST /users`
+      #
+      # Creates the user in the account with the given role and sends a link to set the password.
+      #
+      # @param email [String] (corpo)
+      # @param name [String, nil] (corpo)
+      # @param role [String, nil] (corpo) agent = member (no billing)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def invite_user(email:, name: UNSET, role: UNSET, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "email" => email,
+          "name" => name,
+          "role" => role
+        )
+        request("POST", "/users", body: payload, idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Change a user's role (admin). `PATCH /users/{id}`
+      #
+      # Demoting the last administrator of the account is refused (409 last_admin).
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param role [String] (corpo) agent = member (no billing)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def update_user_role(id, role:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "role" => role
+        )
+        request("PATCH",
+                "/users/#{segment(id, "id")}",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Remove a user from the account (admin). `DELETE /users/{id}`
+      #
+      # You cannot remove yourself (409 self_remove) nor the last administrator (409 last_admin).
+      #
+      # @param id [String] Resource ID (UUID).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def remove_user(id, idempotency_key: nil, timeout: nil)
+        request("DELETE",
+                "/users/#{segment(id, "id")}",
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Rename the account (company name) — admin. `PATCH /account`
+      #
+      # @param name [String] (corpo) Company name.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def update_account(name:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "name" => name
+        )
+        request("PATCH",
+                "/account",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+    end
+  end
+end