hanzoai 8.5.156

data/lib/hanzoai/api/todo_api.rb

@@ -0,0 +1,917 @@
+=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 TodoApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Refused — a board is a repository on the forge
+    # Answers 405. A todo board IS a repository on this deployment's forge, so creating, renaming and deleting one is a FORGE operation carried out with FORGE permissions.  Offering it here would put a second endpoint on the same object, guarded by this surface instead of by the forge — a weaker guard on the same thing. So the route exists and refuses, rather than 404ing: \"not this service's job\" and \"no such thing\" are different facts, and the body names the forge so a caller knows where the job IS done.  What this surface DOES own is the work on a board: list the boards you can see, read and file their issues, move a card between columns, and read the schedule a milestone is. Those are the routes beside this one.
+    # @param key [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def delete_todo_projects_by_key(key, opts = {})
+      delete_todo_projects_by_key_with_http_info(key, opts)
+      nil
+    end
+
+    # Refused — a board is a repository on the forge
+    # Answers 405. A todo board IS a repository on this deployment's forge, so creating, renaming and deleting one is a FORGE operation carried out with FORGE permissions.  Offering it here would put a second endpoint on the same object, guarded by this surface instead of by the forge — a weaker guard on the same thing. So the route exists and refuses, rather than 404ing: \"not this service's job\" and \"no such thing\" are different facts, and the body names the forge so a caller knows where the job IS done.  What this surface DOES own is the work on a board: list the boards you can see, read and file their issues, move a card between columns, and read the schedule a milestone is. Those are the routes beside this one.
+    # @param key [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_todo_projects_by_key_with_http_info(key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.delete_todo_projects_by_key ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.delete_todo_projects_by_key"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}'.sub('{' + 'key' + '}', CGI.escape(key.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.delete_todo_projects_by_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: TodoApi#delete_todo_projects_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns a board's issues — work items with their column, priority, assignee, labels and schedule.
+    # Returns a board's issues — work items with their column, priority, assignee, labels and schedule.  WHICH board is a filter, not an address. Bound to a repository (the key from the path) it is that project's board; left unbound it is the org's whole board; narrowed by label it is a board smaller than any repository — which is the only way an app that lives as a directory inside a shared repository can have one. Every combination is the same rows through the same projection, so no two boards can disagree about what a column means.  The column is a LABEL on the forge, so the board and the forge web UI are the same object seen twice: relabelling in either moves the card in both. A closed issue reads as done whatever its labels say.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :key Key is the project whose issues to list, from the path. EMPTY means every project in the org — the global board. It is a filter like the rest of this struct rather than an address, which is what lets one op answer both \&quot;this board\&quot; and \&quot;all the work\&quot; without a second surface disagreeing with the first about what a column is.
+    # @option opts [String] :status Status keeps only issues in that board column: backlog, todo, in_progress, done or canceled. An unknown value is refused with 400.
+    # @option opts [String] :kind Kind keeps only work items of that shape: issue, pr or epic. An unknown value is refused with 400.
+    # @option opts [String] :repo Repo keeps only issues bound to that git repository.
+    # @option opts [String] :label Label keeps only issues carrying that label, compared case-insensitively.  This is how a board narrows to something SMALLER than a repository — the one mechanism for it. An estate whose apps are directories inside one repository (hanzoai/cloud carries ~140 of them) has no repository per app to address, so the app is a label: &#x60;label&#x3D;app/meet&#x60; is the meet board. Nothing is provisioned to make one exist; a board is the query.
+    # @option opts [String] :source Source keeps only issues opened from that surface: team, git, crm, helpdesk, cms or agent. An unknown value is refused with 400.
+    # @option opts [Boolean] :scheduled Scheduled keeps only issues that carry a date — a start, a due date or both. This is the timeline&#39;s slice of the board: pass scheduled&#x3D;true to get exactly the rows a gantt has somewhere to draw, instead of fetching every issue and discarding the undated ones client-side.
+    # @return [Array<IssueView>]
+    def get_todo_board(opts = {})
+      data, _status_code, _headers = get_todo_board_with_http_info(opts)
+      data
+    end
+
+    # Returns a board&#39;s issues — work items with their column, priority, assignee, labels and schedule.
+    # Returns a board&#39;s issues — work items with their column, priority, assignee, labels and schedule.  WHICH board is a filter, not an address. Bound to a repository (the key from the path) it is that project&#39;s board; left unbound it is the org&#39;s whole board; narrowed by label it is a board smaller than any repository — which is the only way an app that lives as a directory inside a shared repository can have one. Every combination is the same rows through the same projection, so no two boards can disagree about what a column means.  The column is a LABEL on the forge, so the board and the forge web UI are the same object seen twice: relabelling in either moves the card in both. A closed issue reads as done whatever its labels say.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :key Key is the project whose issues to list, from the path. EMPTY means every project in the org — the global board. It is a filter like the rest of this struct rather than an address, which is what lets one op answer both \&quot;this board\&quot; and \&quot;all the work\&quot; without a second surface disagreeing with the first about what a column is.
+    # @option opts [String] :status Status keeps only issues in that board column: backlog, todo, in_progress, done or canceled. An unknown value is refused with 400.
+    # @option opts [String] :kind Kind keeps only work items of that shape: issue, pr or epic. An unknown value is refused with 400.
+    # @option opts [String] :repo Repo keeps only issues bound to that git repository.
+    # @option opts [String] :label Label keeps only issues carrying that label, compared case-insensitively.  This is how a board narrows to something SMALLER than a repository — the one mechanism for it. An estate whose apps are directories inside one repository (hanzoai/cloud carries ~140 of them) has no repository per app to address, so the app is a label: &#x60;label&#x3D;app/meet&#x60; is the meet board. Nothing is provisioned to make one exist; a board is the query.
+    # @option opts [String] :source Source keeps only issues opened from that surface: team, git, crm, helpdesk, cms or agent. An unknown value is refused with 400.
+    # @option opts [Boolean] :scheduled Scheduled keeps only issues that carry a date — a start, a due date or both. This is the timeline&#39;s slice of the board: pass scheduled&#x3D;true to get exactly the rows a gantt has somewhere to draw, instead of fetching every issue and discarding the undated ones client-side.
+    # @return [Array<(Array<IssueView>, Integer, Hash)>] Array<IssueView> data, response status code and response headers
+    def get_todo_board_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_board ...'
+      end
+      # resource path
+      local_var_path = '/v1/todo/board'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'key'] = opts[:'key'] if !opts[:'key'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'kind'] = opts[:'kind'] if !opts[:'kind'].nil?
+      query_params[:'repo'] = opts[:'repo'] if !opts[:'repo'].nil?
+      query_params[:'label'] = opts[:'label'] if !opts[:'label'].nil?
+      query_params[:'source'] = opts[:'source'] if !opts[:'source'].nil?
+      query_params[:'scheduled'] = opts[:'scheduled'] if !opts[:'scheduled'].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] || 'Array<IssueView>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_board",
+        :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: TodoApi#get_todo_board\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Answers across every project in the org.
+    # Answers across every project in the org.  The org comes from the validated principal and never from the request: a caller able to name the org could read another tenant's backlog, and a search is exactly the shape that would quietly return it.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Q matches an issue&#39;s title or description. A word from the issue, which is what someone remembers — not its number, which is what they are looking up.
+    # @option opts [String] :project Project narrows to one team key; \&quot;\&quot; searches every project in the org, which is the point of this op.
+    # @option opts [String] :status Status keeps one board column: backlog, todo, in_progress, done, canceled.
+    # @option opts [String] :kind Kind keeps one shape: issue, pr, epic.
+    # @option opts [String] :repo Repo keeps issues bound to one git repository.
+    # @option opts [String] :room Room keeps issues bound to one collaboration room, spelled \&quot;&lt;workspace&gt;_&lt;room&gt;\&quot; — the exact value GET /v1/meet/call answers with, so a channel&#39;s call and its todo list name the room the same way. This is the read a channel view runs to draw its own list; it spans every board of the org, because the work a channel is about is not confined to one board.
+    # @option opts [String] :source Source keeps one origin: team, git, crm, helpdesk, cms, agent. \&quot;git\&quot; is how you ask for the mirrored GitHub issues specifically.
+    # @option opts [String] :assignee Assignee keeps issues held by one person. Pass \&quot;me\&quot; for yourself.
+    # @option opts [Integer] :limit Limit caps the answer; 0 means the default, and anything above the ceiling is clamped rather than refused — a search that errors on being too broad teaches people to guess.
+    # @return [IssueHits]
+    def get_todo_issues(opts = {})
+      data, _status_code, _headers = get_todo_issues_with_http_info(opts)
+      data
+    end
+
+    # Answers across every project in the org.
+    # Answers across every project in the org.  The org comes from the validated principal and never from the request: a caller able to name the org could read another tenant&#39;s backlog, and a search is exactly the shape that would quietly return it.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :q Q matches an issue&#39;s title or description. A word from the issue, which is what someone remembers — not its number, which is what they are looking up.
+    # @option opts [String] :project Project narrows to one team key; \&quot;\&quot; searches every project in the org, which is the point of this op.
+    # @option opts [String] :status Status keeps one board column: backlog, todo, in_progress, done, canceled.
+    # @option opts [String] :kind Kind keeps one shape: issue, pr, epic.
+    # @option opts [String] :repo Repo keeps issues bound to one git repository.
+    # @option opts [String] :room Room keeps issues bound to one collaboration room, spelled \&quot;&lt;workspace&gt;_&lt;room&gt;\&quot; — the exact value GET /v1/meet/call answers with, so a channel&#39;s call and its todo list name the room the same way. This is the read a channel view runs to draw its own list; it spans every board of the org, because the work a channel is about is not confined to one board.
+    # @option opts [String] :source Source keeps one origin: team, git, crm, helpdesk, cms, agent. \&quot;git\&quot; is how you ask for the mirrored GitHub issues specifically.
+    # @option opts [String] :assignee Assignee keeps issues held by one person. Pass \&quot;me\&quot; for yourself.
+    # @option opts [Integer] :limit Limit caps the answer; 0 means the default, and anything above the ceiling is clamped rather than refused — a search that errors on being too broad teaches people to guess.
+    # @return [Array<(IssueHits, Integer, Hash)>] IssueHits data, response status code and response headers
+    def get_todo_issues_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_issues ...'
+      end
+      # resource path
+      local_var_path = '/v1/todo/issues'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'q'] = opts[:'q'] if !opts[:'q'].nil?
+      query_params[:'project'] = opts[:'project'] if !opts[:'project'].nil?
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'kind'] = opts[:'kind'] if !opts[:'kind'].nil?
+      query_params[:'repo'] = opts[:'repo'] if !opts[:'repo'].nil?
+      query_params[:'room'] = opts[:'room'] if !opts[:'room'].nil?
+      query_params[:'source'] = opts[:'source'] if !opts[:'source'].nil?
+      query_params[:'assignee'] = opts[:'assignee'] if !opts[:'assignee'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].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] || 'IssueHits'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_issues",
+        :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: TodoApi#get_todo_issues\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns the boards of your org — the places your work actually is.
+    # Returns the boards of your org — the places your work actually is. The key addresses the board's issues.  A BOARD IS A PLACE WORK IS, not an object somebody provisioned. So the list is assembled from the work itself: the repositories your org has filed issues on, plus the boards the index holds. A repository with nothing on it is not in the list and is still perfectly addressable — GET /projects/<name> reads it and a create files into it — so nothing is lost by leaving it out.  Measured, which is why: reading the forge's whole repository inventory put 745 boards here, of which all but a handful were vendored forks and mirrors (.github, .profile, DOMPurify, BoatAttack) that will never carry this org's work. A list that long is not a list — the estate's real roadmap was in it somewhere and no one could see it.  The forge half is the FORGE's answer for your own account, so two people in one org can legitimately see different boards.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<TodoProject>]
+    def get_todo_projects(opts = {})
+      data, _status_code, _headers = get_todo_projects_with_http_info(opts)
+      data
+    end
+
+    # Returns the boards of your org — the places your work actually is.
+    # Returns the boards of your org — the places your work actually is. The key addresses the board&#39;s issues.  A BOARD IS A PLACE WORK IS, not an object somebody provisioned. So the list is assembled from the work itself: the repositories your org has filed issues on, plus the boards the index holds. A repository with nothing on it is not in the list and is still perfectly addressable — GET /projects/&lt;name&gt; reads it and a create files into it — so nothing is lost by leaving it out.  Measured, which is why: reading the forge&#39;s whole repository inventory put 745 boards here, of which all but a handful were vendored forks and mirrors (.github, .profile, DOMPurify, BoatAttack) that will never carry this org&#39;s work. A list that long is not a list — the estate&#39;s real roadmap was in it somewhere and no one could see it.  The forge half is the FORGE&#39;s answer for your own account, so two people in one org can legitimately see different boards.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<TodoProject>, Integer, Hash)>] Array<TodoProject> data, response status code and response headers
+    def get_todo_projects_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_projects ...'
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects'
+
+      # 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] || 'Array<TodoProject>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_projects",
+        :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: TodoApi#get_todo_projects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns one board of your org by its key — the repository name.
+    # Returns one board of your org by its key — the repository name. 404 when your org has no repository under that key, or when your own forge account cannot see it.
+    # @param key [String] Key is the project&#39;s org-unique handle: 2-8 uppercase alphanumerics starting with a letter (\&quot;ENG\&quot;, \&quot;OPS2\&quot;). Matched case-insensitively.
+    # @param [Hash] opts the optional parameters
+    # @return [TodoProject]
+    def get_todo_projects_by_key(key, opts = {})
+      data, _status_code, _headers = get_todo_projects_by_key_with_http_info(key, opts)
+      data
+    end
+
+    # Returns one board of your org by its key — the repository name.
+    # Returns one board of your org by its key — the repository name. 404 when your org has no repository under that key, or when your own forge account cannot see it.
+    # @param key [String] Key is the project&#39;s org-unique handle: 2-8 uppercase alphanumerics starting with a letter (\&quot;ENG\&quot;, \&quot;OPS2\&quot;). Matched case-insensitively.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(TodoProject, Integer, Hash)>] TodoProject data, response status code and response headers
+    def get_todo_projects_by_key_with_http_info(key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_projects_by_key ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.get_todo_projects_by_key"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}'.sub('{' + 'key' + '}', CGI.escape(key.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] || 'TodoProject'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_projects_by_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(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TodoApi#get_todo_projects_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns a board's issues — work items with their column, priority, assignee, labels and schedule.
+    # Returns a board's issues — work items with their column, priority, assignee, labels and schedule.  WHICH board is a filter, not an address. Bound to a repository (the key from the path) it is that project's board; left unbound it is the org's whole board; narrowed by label it is a board smaller than any repository — which is the only way an app that lives as a directory inside a shared repository can have one. Every combination is the same rows through the same projection, so no two boards can disagree about what a column means.  The column is a LABEL on the forge, so the board and the forge web UI are the same object seen twice: relabelling in either moves the card in both. A closed issue reads as done whatever its labels say.
+    # @param key [String] Key is the project whose issues to list, from the path. EMPTY means every project in the org — the global board. It is a filter like the rest of this struct rather than an address, which is what lets one op answer both \&quot;this board\&quot; and \&quot;all the work\&quot; without a second surface disagreeing with the first about what a column is.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :status Status keeps only issues in that board column: backlog, todo, in_progress, done or canceled. An unknown value is refused with 400.
+    # @option opts [String] :kind Kind keeps only work items of that shape: issue, pr or epic. An unknown value is refused with 400.
+    # @option opts [String] :repo Repo keeps only issues bound to that git repository.
+    # @option opts [String] :label Label keeps only issues carrying that label, compared case-insensitively.  This is how a board narrows to something SMALLER than a repository — the one mechanism for it. An estate whose apps are directories inside one repository (hanzoai/cloud carries ~140 of them) has no repository per app to address, so the app is a label: &#x60;label&#x3D;app/meet&#x60; is the meet board. Nothing is provisioned to make one exist; a board is the query.
+    # @option opts [String] :source Source keeps only issues opened from that surface: team, git, crm, helpdesk, cms or agent. An unknown value is refused with 400.
+    # @option opts [Boolean] :scheduled Scheduled keeps only issues that carry a date — a start, a due date or both. This is the timeline&#39;s slice of the board: pass scheduled&#x3D;true to get exactly the rows a gantt has somewhere to draw, instead of fetching every issue and discarding the undated ones client-side.
+    # @return [Array<IssueView>]
+    def get_todo_projects_by_key_issues(key, opts = {})
+      data, _status_code, _headers = get_todo_projects_by_key_issues_with_http_info(key, opts)
+      data
+    end
+
+    # Returns a board&#39;s issues — work items with their column, priority, assignee, labels and schedule.
+    # Returns a board&#39;s issues — work items with their column, priority, assignee, labels and schedule.  WHICH board is a filter, not an address. Bound to a repository (the key from the path) it is that project&#39;s board; left unbound it is the org&#39;s whole board; narrowed by label it is a board smaller than any repository — which is the only way an app that lives as a directory inside a shared repository can have one. Every combination is the same rows through the same projection, so no two boards can disagree about what a column means.  The column is a LABEL on the forge, so the board and the forge web UI are the same object seen twice: relabelling in either moves the card in both. A closed issue reads as done whatever its labels say.
+    # @param key [String] Key is the project whose issues to list, from the path. EMPTY means every project in the org — the global board. It is a filter like the rest of this struct rather than an address, which is what lets one op answer both \&quot;this board\&quot; and \&quot;all the work\&quot; without a second surface disagreeing with the first about what a column is.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :status Status keeps only issues in that board column: backlog, todo, in_progress, done or canceled. An unknown value is refused with 400.
+    # @option opts [String] :kind Kind keeps only work items of that shape: issue, pr or epic. An unknown value is refused with 400.
+    # @option opts [String] :repo Repo keeps only issues bound to that git repository.
+    # @option opts [String] :label Label keeps only issues carrying that label, compared case-insensitively.  This is how a board narrows to something SMALLER than a repository — the one mechanism for it. An estate whose apps are directories inside one repository (hanzoai/cloud carries ~140 of them) has no repository per app to address, so the app is a label: &#x60;label&#x3D;app/meet&#x60; is the meet board. Nothing is provisioned to make one exist; a board is the query.
+    # @option opts [String] :source Source keeps only issues opened from that surface: team, git, crm, helpdesk, cms or agent. An unknown value is refused with 400.
+    # @option opts [Boolean] :scheduled Scheduled keeps only issues that carry a date — a start, a due date or both. This is the timeline&#39;s slice of the board: pass scheduled&#x3D;true to get exactly the rows a gantt has somewhere to draw, instead of fetching every issue and discarding the undated ones client-side.
+    # @return [Array<(Array<IssueView>, Integer, Hash)>] Array<IssueView> data, response status code and response headers
+    def get_todo_projects_by_key_issues_with_http_info(key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_projects_by_key_issues ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.get_todo_projects_by_key_issues"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}/issues'.sub('{' + 'key' + '}', CGI.escape(key.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'status'] = opts[:'status'] if !opts[:'status'].nil?
+      query_params[:'kind'] = opts[:'kind'] if !opts[:'kind'].nil?
+      query_params[:'repo'] = opts[:'repo'] if !opts[:'repo'].nil?
+      query_params[:'label'] = opts[:'label'] if !opts[:'label'].nil?
+      query_params[:'source'] = opts[:'source'] if !opts[:'source'].nil?
+      query_params[:'scheduled'] = opts[:'scheduled'] if !opts[:'scheduled'].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] || 'Array<IssueView>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_projects_by_key_issues",
+        :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: TodoApi#get_todo_projects_by_key_issues\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Returns ONE work item in full — its description included.
+    # Returns ONE work item in full — its description included.  The list reads answer a board, and a board is a summary: the description is where the actual content of a work item lives — what an issue asks for, what an epic's acceptance criteria are — and no read on this surface returned it. The address is the one PATCH already accepts, so an item you can move is now an item you can read.  It reads the forge directly rather than filtering the org fan-out, then falls back to the index for a board the forge has never heard of — the same order, and the same reason, as GetProject: a row is one kind of thing however it came to exist, so a caller does not have to know which store it is in to fetch it.
+    # @param key [String] Key is the board — the repository name, or an index board&#39;s key.
+    # @param num [Integer] Num is the issue&#39;s number on that board.
+    # @param [Hash] opts the optional parameters
+    # @return [IssueView]
+    def get_todo_projects_by_key_issues_by_num(key, num, opts = {})
+      data, _status_code, _headers = get_todo_projects_by_key_issues_by_num_with_http_info(key, num, opts)
+      data
+    end
+
+    # Returns ONE work item in full — its description included.
+    # Returns ONE work item in full — its description included.  The list reads answer a board, and a board is a summary: the description is where the actual content of a work item lives — what an issue asks for, what an epic&#39;s acceptance criteria are — and no read on this surface returned it. The address is the one PATCH already accepts, so an item you can move is now an item you can read.  It reads the forge directly rather than filtering the org fan-out, then falls back to the index for a board the forge has never heard of — the same order, and the same reason, as GetProject: a row is one kind of thing however it came to exist, so a caller does not have to know which store it is in to fetch it.
+    # @param key [String] Key is the board — the repository name, or an index board&#39;s key.
+    # @param num [Integer] Num is the issue&#39;s number on that board.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(IssueView, Integer, Hash)>] IssueView data, response status code and response headers
+    def get_todo_projects_by_key_issues_by_num_with_http_info(key, num, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_projects_by_key_issues_by_num ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.get_todo_projects_by_key_issues_by_num"
+      end
+      # verify the required parameter 'num' is set
+      if @api_client.config.client_side_validation && num.nil?
+        fail ArgumentError, "Missing the required parameter 'num' when calling TodoApi.get_todo_projects_by_key_issues_by_num"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}/issues/{num}'.sub('{' + 'key' + '}', CGI.escape(key.to_s)).sub('{' + 'num' + '}', CGI.escape(num.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] || 'IssueView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_projects_by_key_issues_by_num",
+        :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: TodoApi#get_todo_projects_by_key_issues_by_num\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Summarises one room's work.
+    # Summarises one room's work.  The room is opaque here and is deliberately not resolved: this package cannot say whether a room exists — apps/team owns that document — so an unknown room answers an EMPTY board rather than a 404. That is the honest answer and the useful one: a channel that has never had an item filed in it and a channel id that was mistyped both have no work, and inventing a distinction would require this surface to hold a second copy of the room list (HIP-0523 §2 forbids it, and it would drift the first time a room was renamed).  Tenancy is the validated principal's org and nothing else, so a caller cannot read another tenant's channel by naming its room.
+    # @param room [String] Room is the room, spelled \&quot;&lt;workspace&gt;_&lt;room&gt;\&quot; — the same value GET /v1/meet/call answers with, so a channel&#39;s call and its work name the room identically. From the path.
+    # @param [Hash] opts the optional parameters
+    # @return [RoomWork]
+    def get_todo_rooms_by_room(room, opts = {})
+      data, _status_code, _headers = get_todo_rooms_by_room_with_http_info(room, opts)
+      data
+    end
+
+    # Summarises one room&#39;s work.
+    # Summarises one room&#39;s work.  The room is opaque here and is deliberately not resolved: this package cannot say whether a room exists — apps/team owns that document — so an unknown room answers an EMPTY board rather than a 404. That is the honest answer and the useful one: a channel that has never had an item filed in it and a channel id that was mistyped both have no work, and inventing a distinction would require this surface to hold a second copy of the room list (HIP-0523 §2 forbids it, and it would drift the first time a room was renamed).  Tenancy is the validated principal&#39;s org and nothing else, so a caller cannot read another tenant&#39;s channel by naming its room.
+    # @param room [String] Room is the room, spelled \&quot;&lt;workspace&gt;_&lt;room&gt;\&quot; — the same value GET /v1/meet/call answers with, so a channel&#39;s call and its work name the room identically. From the path.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(RoomWork, Integer, Hash)>] RoomWork data, response status code and response headers
+    def get_todo_rooms_by_room_with_http_info(room, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.get_todo_rooms_by_room ...'
+      end
+      # verify the required parameter 'room' is set
+      if @api_client.config.client_side_validation && room.nil?
+        fail ArgumentError, "Missing the required parameter 'room' when calling TodoApi.get_todo_rooms_by_room"
+      end
+      # resource path
+      local_var_path = '/v1/todo/rooms/{room}'.sub('{' + 'room' + '}', CGI.escape(room.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] || 'RoomWork'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.get_todo_rooms_by_room",
+        :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: TodoApi#get_todo_rooms_by_room\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Refused — a board is a repository on the forge
+    # Answers 405. A todo board IS a repository on this deployment's forge, so creating, renaming and deleting one is a FORGE operation carried out with FORGE permissions.  Offering it here would put a second endpoint on the same object, guarded by this surface instead of by the forge — a weaker guard on the same thing. So the route exists and refuses, rather than 404ing: \"not this service's job\" and \"no such thing\" are different facts, and the body names the forge so a caller knows where the job IS done.  What this surface DOES own is the work on a board: list the boards you can see, read and file their issues, move a card between columns, and read the schedule a milestone is. Those are the routes beside this one.
+    # @param key [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def patch_todo_projects_by_key(key, opts = {})
+      patch_todo_projects_by_key_with_http_info(key, opts)
+      nil
+    end
+
+    # Refused — a board is a repository on the forge
+    # Answers 405. A todo board IS a repository on this deployment&#39;s forge, so creating, renaming and deleting one is a FORGE operation carried out with FORGE permissions.  Offering it here would put a second endpoint on the same object, guarded by this surface instead of by the forge — a weaker guard on the same thing. So the route exists and refuses, rather than 404ing: \&quot;not this service&#39;s job\&quot; and \&quot;no such thing\&quot; are different facts, and the body names the forge so a caller knows where the job IS done.  What this surface DOES own is the work on a board: list the boards you can see, read and file their issues, move a card between columns, and read the schedule a milestone is. Those are the routes beside this one.
+    # @param key [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def patch_todo_projects_by_key_with_http_info(key, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.patch_todo_projects_by_key ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.patch_todo_projects_by_key"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}'.sub('{' + 'key' + '}', CGI.escape(key.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.patch_todo_projects_by_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(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TodoApi#patch_todo_projects_by_key\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Edits a work item — rename it, rewrite it, move it to another column, or re-prioritise it.
+    # Edits a work item — rename it, rewrite it, move it to another column, or re-prioritise it. Absent fields are left alone.  MOVING A CARD IS A RELABEL. The column lives in the forge's label set, so the move replaces that set rather than writing a status column here that a forge-side change could contradict. Moving to `done` also CLOSES the issue on the forge, because a done card and an open issue are a contradiction.
+    # @param key [String] Key is the board — the repository name, from the path.
+    # @param num [Integer] Num is the issue number on that repository, from the path.
+    # @param issue_edit [IssueEdit] 
+    # @param [Hash] opts the optional parameters
+    # @return [IssueView]
+    def patch_todo_projects_by_key_issues_by_num(key, num, issue_edit, opts = {})
+      data, _status_code, _headers = patch_todo_projects_by_key_issues_by_num_with_http_info(key, num, issue_edit, opts)
+      data
+    end
+
+    # Edits a work item — rename it, rewrite it, move it to another column, or re-prioritise it.
+    # Edits a work item — rename it, rewrite it, move it to another column, or re-prioritise it. Absent fields are left alone.  MOVING A CARD IS A RELABEL. The column lives in the forge&#39;s label set, so the move replaces that set rather than writing a status column here that a forge-side change could contradict. Moving to &#x60;done&#x60; also CLOSES the issue on the forge, because a done card and an open issue are a contradiction.
+    # @param key [String] Key is the board — the repository name, from the path.
+    # @param num [Integer] Num is the issue number on that repository, from the path.
+    # @param issue_edit [IssueEdit] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(IssueView, Integer, Hash)>] IssueView data, response status code and response headers
+    def patch_todo_projects_by_key_issues_by_num_with_http_info(key, num, issue_edit, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.patch_todo_projects_by_key_issues_by_num ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.patch_todo_projects_by_key_issues_by_num"
+      end
+      # verify the required parameter 'num' is set
+      if @api_client.config.client_side_validation && num.nil?
+        fail ArgumentError, "Missing the required parameter 'num' when calling TodoApi.patch_todo_projects_by_key_issues_by_num"
+      end
+      # verify the required parameter 'issue_edit' is set
+      if @api_client.config.client_side_validation && issue_edit.nil?
+        fail ArgumentError, "Missing the required parameter 'issue_edit' when calling TodoApi.patch_todo_projects_by_key_issues_by_num"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}/issues/{num}'.sub('{' + 'key' + '}', CGI.escape(key.to_s)).sub('{' + 'num' + '}', CGI.escape(num.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(issue_edit)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'IssueView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.patch_todo_projects_by_key_issues_by_num",
+        :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(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TodoApi#patch_todo_projects_by_key_issues_by_num\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Refused — a board is a repository on the forge
+    # Answers 405. A todo board IS a repository on this deployment's forge, so creating, renaming and deleting one is a FORGE operation carried out with FORGE permissions.  Offering it here would put a second endpoint on the same object, guarded by this surface instead of by the forge — a weaker guard on the same thing. So the route exists and refuses, rather than 404ing: \"not this service's job\" and \"no such thing\" are different facts, and the body names the forge so a caller knows where the job IS done.  What this surface DOES own is the work on a board: list the boards you can see, read and file their issues, move a card between columns, and read the schedule a milestone is. Those are the routes beside this one.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def post_todo_projects(opts = {})
+      post_todo_projects_with_http_info(opts)
+      nil
+    end
+
+    # Refused — a board is a repository on the forge
+    # Answers 405. A todo board IS a repository on this deployment&#39;s forge, so creating, renaming and deleting one is a FORGE operation carried out with FORGE permissions.  Offering it here would put a second endpoint on the same object, guarded by this surface instead of by the forge — a weaker guard on the same thing. So the route exists and refuses, rather than 404ing: \&quot;not this service&#39;s job\&quot; and \&quot;no such thing\&quot; are different facts, and the body names the forge so a caller knows where the job IS done.  What this surface DOES own is the work on a board: list the boards you can see, read and file their issues, move a card between columns, and read the schedule a milestone is. Those are the routes beside this one.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_todo_projects_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.post_todo_projects ...'
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.post_todo_projects",
+        :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: TodoApi#post_todo_projects\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Opens a work item on the board — an issue on that repository on the deployment's forge, filed as YOU.
+    # Opens a work item on the board — an issue on that repository on the deployment's forge, filed as YOU.  The column and priority are written as LABELS, which is what makes the card and the forge issue the same object: someone relabelling in the forge web UI has moved your card.
+    # @param key [String] Key is the board — the repository name, from the path.
+    # @param new_issue [NewIssue] 
+    # @param [Hash] opts the optional parameters
+    # @return [IssueView]
+    def post_todo_projects_by_key_issues(key, new_issue, opts = {})
+      data, _status_code, _headers = post_todo_projects_by_key_issues_with_http_info(key, new_issue, opts)
+      data
+    end
+
+    # Opens a work item on the board — an issue on that repository on the deployment&#39;s forge, filed as YOU.
+    # Opens a work item on the board — an issue on that repository on the deployment&#39;s forge, filed as YOU.  The column and priority are written as LABELS, which is what makes the card and the forge issue the same object: someone relabelling in the forge web UI has moved your card.
+    # @param key [String] Key is the board — the repository name, from the path.
+    # @param new_issue [NewIssue] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(IssueView, Integer, Hash)>] IssueView data, response status code and response headers
+    def post_todo_projects_by_key_issues_with_http_info(key, new_issue, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.post_todo_projects_by_key_issues ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.post_todo_projects_by_key_issues"
+      end
+      # verify the required parameter 'new_issue' is set
+      if @api_client.config.client_side_validation && new_issue.nil?
+        fail ArgumentError, "Missing the required parameter 'new_issue' when calling TodoApi.post_todo_projects_by_key_issues"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}/issues'.sub('{' + 'key' + '}', CGI.escape(key.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(new_issue)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'IssueView'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.post_todo_projects_by_key_issues",
+        :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: TodoApi#post_todo_projects_by_key_issues\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Takes an issue: it becomes yours and it moves to in_progress.
+    # Takes an issue: it becomes yours and it moves to in_progress.  The holder is the CALLER, never an argument. \"Assign this to someone else\" is a different act with different authority, and it already exists as a PATCH; conflating them would let anyone hand work to anyone by naming them.  Claiming something already held by someone else is refused rather than silently taken — two agents on one issue is the failure this prevents, and a claim that quietly wins a race is worse than one that says no.
+    # @param key [String] 
+    # @param num [Integer] 
+    # @param [Hash] opts the optional parameters
+    # @return [IssueHit]
+    def post_todo_projects_by_key_issues_by_num_claim(key, num, opts = {})
+      data, _status_code, _headers = post_todo_projects_by_key_issues_by_num_claim_with_http_info(key, num, opts)
+      data
+    end
+
+    # Takes an issue: it becomes yours and it moves to in_progress.
+    # Takes an issue: it becomes yours and it moves to in_progress.  The holder is the CALLER, never an argument. \&quot;Assign this to someone else\&quot; is a different act with different authority, and it already exists as a PATCH; conflating them would let anyone hand work to anyone by naming them.  Claiming something already held by someone else is refused rather than silently taken — two agents on one issue is the failure this prevents, and a claim that quietly wins a race is worse than one that says no.
+    # @param key [String] 
+    # @param num [Integer] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(IssueHit, Integer, Hash)>] IssueHit data, response status code and response headers
+    def post_todo_projects_by_key_issues_by_num_claim_with_http_info(key, num, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TodoApi.post_todo_projects_by_key_issues_by_num_claim ...'
+      end
+      # verify the required parameter 'key' is set
+      if @api_client.config.client_side_validation && key.nil?
+        fail ArgumentError, "Missing the required parameter 'key' when calling TodoApi.post_todo_projects_by_key_issues_by_num_claim"
+      end
+      # verify the required parameter 'num' is set
+      if @api_client.config.client_side_validation && num.nil?
+        fail ArgumentError, "Missing the required parameter 'num' when calling TodoApi.post_todo_projects_by_key_issues_by_num_claim"
+      end
+      # resource path
+      local_var_path = '/v1/todo/projects/{key}/issues/{num}/claim'.sub('{' + 'key' + '}', CGI.escape(key.to_s)).sub('{' + 'num' + '}', CGI.escape(num.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] || 'IssueHit'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer']
+
+      new_options = opts.merge(
+        :operation => :"TodoApi.post_todo_projects_by_key_issues_by_num_claim",
+        :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: TodoApi#post_todo_projects_by_key_issues_by_num_claim\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end