asana 0.8.1 → 0.9.0

data/lib/asana/resources/project_membership.rb

@@ -12,6 +12,10 @@ module Asana
 
       attr_reader :id
 
+      attr_reader :gid
+
+      attr_reader :resource_type
+
       attr_reader :user
 
       attr_reader :project
@@ -26,24 +30,26 @@ module Asana
 
         # Returns the compact project membership records for the project.
         #
-        # project - [Id] The project for which to fetch memberships.
+        # project - [Gid] The project for which to fetch memberships.
         # user - [String] If present, the user to filter the memberships to.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
-        def get_many(client, project: required("project"), user: nil, per_page: 20, options: {})
+        def find_by_project(client, project: required("project"), user: nil, per_page: 20, options: {})
           params = { user: user, limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
           Collection.new(parse(client.get("/projects/#{project}/project_memberships", params: params, options: options)), type: Resource, client: client)
         end
+        alias_method :get_many, :find_by_project
 
         # Returns the project membership record.
         #
-        # project - [Id] Globally unique identifier for the project membership.
+        # id - [Gid] Globally unique identifier for the project membership.
         #
         # options - [Hash] the request I/O options.
-        def get_single(client, project: required("project"), options: {})
+        def find_by_id(client, id, options: {})
 
-          Resource.new(parse(client.get("/project_memberships/#{project}", options: options)).first, client: client)
+          self.new(parse(client.get("/project_memberships/#{id}", options: options)).first, client: client)
         end
+        alias_method :get_single, :find_by_id
       end
 
     end

data/lib/asana/resources/project_status.rb

@@ -14,10 +14,16 @@ module Asana
 
       attr_reader :id
 
+      attr_reader :gid
+
+      attr_reader :resource_type
+
       attr_reader :title
 
       attr_reader :text
 
+      attr_reader :html_text
+
       attr_reader :color
 
       attr_reader :created_by
@@ -34,21 +40,22 @@ module Asana
         #
         # Returns the full record of the newly created project status update.
         #
-        # project - [Id] The project on which to create a status update.
+        # project - [Gid] The project on which to create a status update.
         # text - [String] The text of the project status update.
         #
         # color - [String] The color to associate with the status update. Must be one of `"red"`, `"yellow"`, or `"green"`.
         #
         # options - [Hash] the request I/O options.
         # data - [Hash] the attributes to post.
-        def create(client, project: required("project"), text: required("text"), color: required("color"), options: {}, **data)
+        def create_in_project(client, project: required("project"), text: required("text"), color: required("color"), options: {}, **data)
           with_params = data.merge(text: text, color: color).reject { |_,v| v.nil? || Array(v).empty? }
           Resource.new(parse(client.post("/projects/#{project}/project_statuses", body: with_params, options: options)).first, client: client)
         end
+        alias_method :create, :create_in_project
 
         # Returns the compact project status update records for all updates on the project.
         #
-        # project - [Id] The project to find status updates for.
+        # project - [Gid] The project to find status updates for.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
         def find_by_project(client, project: required("project"), per_page: 20, options: {})
@@ -58,7 +65,7 @@ module Asana
 
         # Returns the complete record for a single status update.
         #
-        # id - [Id] The project status update to get.
+        # id - [Gid] The project status update to get.
         # options - [Hash] the request I/O options.
         def find_by_id(client, id, options: {})
 
@@ -71,7 +78,7 @@ module Asana
       # Returns an empty data record.
       def delete()
 
-        client.delete("/project_statuses/#{id}") && true
+        client.delete("/project_statuses/#{gid}") && true
       end
 
     end

data/lib/asana/resources/section.rb

@@ -11,6 +11,10 @@ module Asana
 
       attr_reader :id
 
+      attr_reader :gid
+
+      attr_reader :resource_type
+
       attr_reader :name
 
       attr_reader :project
@@ -27,7 +31,7 @@ module Asana
         #
         # Returns the full record of the newly created section.
         #
-        # project - [Id] The project to create the section in
+        # project - [Gid] The project to create the section in
         # name - [String] The text to be displayed as the section name. This cannot be an empty string.
         # options - [Hash] the request I/O options.
         # data - [Hash] the attributes to post.
@@ -38,7 +42,7 @@ module Asana
 
         # Returns the compact records for all sections in the specified project.
         #
-        # project - [Id] The project to get sections from.
+        # project - [Gid] The project to get sections from.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
         def find_by_project(client, project: required("project"), per_page: 20, options: {})
@@ -48,12 +52,28 @@ module Asana
 
         # Returns the complete record for a single section.
         #
-        # id - [Id] The section to get.
+        # id - [Gid] The section to get.
         # options - [Hash] the request I/O options.
         def find_by_id(client, id, options: {})
 
           self.new(parse(client.get("/sections/#{id}", options: options)).first, client: client)
         end
+
+        # Add a task to a specific, existing section. This will remove the task from other sections of the project.
+        #
+        # The task will be inserted at the top of a section unless an `insert_before` or `insert_after` parameter is declared.
+        #
+        # This does not work for separators (tasks with the `resource_subtype` of section).
+        #
+        # task - [Gid] The task to add to this section
+        # insert_before - [Gid] Insert the given task immediately before the task specified by this parameter. Cannot be provided together with `insert_after`.
+        # insert_after - [Gid] Insert the given task immediately after the task specified by this parameter. Cannot be provided together with `insert_before`.
+        # options - [Hash] the request I/O options.
+        # data - [Hash] the attributes to post.
+        def add_task(client, task: required("task"), insert_before: nil, insert_after: nil, options: {}, **data)
+          with_params = data.merge(insert_before: insert_before, insert_after: insert_after).reject { |_,v| v.nil? || Array(v).empty? }
+          Task.new(parse(client.post("/sections/#{task}/addTask", body: with_params, options: options)).first, client: client)
+        end
       end
 
       # A specific, existing section can be updated by making a PUT request on
@@ -71,7 +91,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def update(options: {}, **data)
 
-        refresh_with(parse(client.put("/sections/#{id}", body: data, options: options)).first)
+        refresh_with(parse(client.put("/sections/#{gid}", body: data, options: options)).first)
       end
 
       # A specific, existing section can be deleted by making a DELETE request
@@ -84,7 +104,7 @@ module Asana
       # Returns an empty data block.
       def delete()
 
-        client.delete("/sections/#{id}") && true
+        client.delete("/sections/#{gid}") && true
       end
 
       # Move sections relative to each other in a board view. One of
@@ -96,9 +116,9 @@ module Asana
       #
       # Returns an empty data block.
       #
-      # project - [Id] The project in which to reorder the given section
-      # before_section - [Id] Insert the given section immediately before the section specified by this parameter.
-      # after_section - [Id] Insert the given section immediately after the section specified by this parameter.
+      # project - [Gid] The project in which to reorder the given section
+      # before_section - [Gid] Insert the given section immediately before the section specified by this parameter.
+      # after_section - [Gid] Insert the given section immediately after the section specified by this parameter.
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
       def insert_in_project(project: required("project"), before_section: nil, after_section: nil, options: {}, **data)

data/lib/asana/resources/story.rb

@@ -7,30 +7,26 @@ module Asana
     # system. Stories are generated by the system whenever users take actions such
     # as creating or assigning tasks, or moving tasks between projects. _Comments_
     # are also a form of user-generated story.
-    #
-    # Stories are a form of history in the system, and as such they are read-only.
-    # Once generated, it is not possible to modify a story.
     class Story < Resource
 
 
       attr_reader :id
 
-      attr_reader :created_at
+      attr_reader :gid
 
-      attr_reader :created_by
+      attr_reader :resource_type
 
-      # DEPRECATED: prefer "liked"
-      attr_reader :hearted
+      attr_reader :resource_subtype
 
-      # DEPRECATED: prefer "likes"
-      attr_reader :hearts
+      attr_reader :created_at
 
-      # DEPRECATED: prefer "num_likes"
-      attr_reader :num_hearts
+      attr_reader :created_by
 
       attr_reader :liked
+      alias_method :hearted, :liked
 
       attr_reader :likes
+      alias_method :hearts, :likes
 
       attr_reader :num_likes
 
@@ -56,7 +52,7 @@ module Asana
 
         # Returns the compact records for all stories on the task.
         #
-        # task - [Id] Globally unique identifier for the task.
+        # task - [Gid] Globally unique identifier for the task.
         #
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
@@ -67,7 +63,7 @@ module Asana
 
         # Returns the full record for a single story.
         #
-        # id - [Id] Globally unique identifier for the story.
+        # id - [Gid] Globally unique identifier for the story.
         #
         # options - [Hash] the request I/O options.
         def find_by_id(client, id, options: {})
@@ -104,13 +100,13 @@ module Asana
       # data - [Hash] the attributes to post.
       def update(text: nil, html_text: nil, is_pinned: nil, options: {}, **data)
         with_params = data.merge(text: text, html_text: html_text, is_pinned: is_pinned).reject { |_,v| v.nil? || Array(v).empty? }
-        refresh_with(parse(client.put("/stories/#{id}", body: with_params, options: options)).first)
+        refresh_with(parse(client.put("/stories/#{gid}", body: with_params, options: options)).first)
       end
 
       # Deletes a story. A user can only delete stories they have created. Returns an empty data record.
       def delete()
 
-        client.delete("/stories/#{id}") && true
+        client.delete("/stories/#{gid}") && true
       end
 
     end

data/lib/asana/resources/tag.rb

@@ -15,6 +15,10 @@ module Asana
 
       attr_reader :id
 
+      attr_reader :gid
+
+      attr_reader :resource_type
+
       attr_reader :created_at
 
       attr_reader :followers
@@ -40,7 +44,7 @@ module Asana
         #
         # Returns the full record of the newly created tag.
         #
-        # workspace - [Id] The workspace or organization to create the tag in.
+        # workspace - [Gid] The workspace or organization to create the tag in.
         # options - [Hash] the request I/O options.
         # data - [Hash] the attributes to post.
         def create(client, workspace: required("workspace"), options: {}, **data)
@@ -57,7 +61,7 @@ module Asana
         #
         # Returns the full record of the newly created tag.
         #
-        # workspace - [Id] The workspace or organization to create the tag in.
+        # workspace - [Gid] The workspace or organization to create the tag in.
         # options - [Hash] the request I/O options.
         # data - [Hash] the attributes to post.
         def create_in_workspace(client, workspace: required("workspace"), options: {}, **data)
@@ -67,7 +71,7 @@ module Asana
 
         # Returns the complete tag record for a single tag.
         #
-        # id - [Id] The tag to get.
+        # id - [Gid] The tag to get.
         # options - [Hash] the request I/O options.
         def find_by_id(client, id, options: {})
 
@@ -77,8 +81,8 @@ module Asana
         # Returns the compact tag records for some filtered set of tags.
         # Use one or more of the parameters provided to filter the tags returned.
         #
-        # workspace - [Id] The workspace or organization to filter tags on.
-        # team - [Id] The team to filter tags on.
+        # workspace - [Gid] The workspace or organization to filter tags on.
+        # team - [Gid] The team to filter tags on.
         # archived - [Boolean] Only return tags whose `archived` field takes on the value of
         # this parameter.
         #
@@ -91,7 +95,7 @@ module Asana
 
         # Returns the compact tag records for all tags in the workspace.
         #
-        # workspace - [Id] The workspace or organization to find tags in.
+        # workspace - [Gid] The workspace or organization to find tags in.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
         def find_by_workspace(client, workspace: required("workspace"), per_page: 20, options: {})
@@ -113,7 +117,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def update(options: {}, **data)
 
-        refresh_with(parse(client.put("/tags/#{id}", body: data, options: options)).first)
+        refresh_with(parse(client.put("/tags/#{gid}", body: data, options: options)).first)
       end
 
       # A specific, existing tag can be deleted by making a DELETE request
@@ -122,7 +126,7 @@ module Asana
       # Returns an empty data record.
       def delete()
 
-        client.delete("/tags/#{id}") && true
+        client.delete("/tags/#{gid}") && true
       end
 
       # Returns the compact task records for all tasks with the given tag.
@@ -132,7 +136,7 @@ module Asana
       # options - [Hash] the request I/O options.
       def get_tasks_with_tag(per_page: 20, options: {})
         params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-        Collection.new(parse(client.get("/tags/#{id}/tasks", params: params, options: options)), type: Task, client: client)
+        Collection.new(parse(client.get("/tags/#{gid}/tasks", params: params, options: options)), type: Task, client: client)
       end
 
     end

data/lib/asana/resources/task.rb

@@ -16,6 +16,12 @@ module Asana
 
       attr_reader :id
 
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :resource_subtype
+
       attr_reader :assignee
 
       attr_reader :assignee_status
@@ -40,37 +46,34 @@ module Asana
 
       attr_reader :followers
 
-      # DEPRECATED: prefer "liked"
-      attr_reader :hearted
-
-      # DEPRECATED: prefer "likes"
-      attr_reader :hearts
+      attr_reader :is_rendered_as_separator
 
       attr_reader :liked
 
       attr_reader :likes
 
+      attr_reader :memberships
+
       attr_reader :modified_at
 
       attr_reader :name
 
       attr_reader :notes
 
-      # DEPRECATED: prefer "num_likes"
-      attr_reader :num_hearts
+      attr_reader :html_notes
 
       attr_reader :num_likes
 
-      attr_reader :projects
+      attr_reader :num_subtasks
 
       attr_reader :parent
 
+      attr_reader :projects
+
       attr_reader :start_on
 
       attr_reader :workspace
 
-      attr_reader :memberships
-
       attr_reader :tags
 
       class << self
@@ -90,7 +93,7 @@ module Asana
         # `projects` can be a comma separated list of projects, or just a single
         # project the task should belong to.
         #
-        # workspace - [Id] The workspace to create a task in.
+        # workspace - [Gid] The workspace to create a task in.
         # options - [Hash] the request I/O options.
         # data - [Hash] the attributes to post.
         def create(client, workspace: nil, options: {}, **data)
@@ -106,7 +109,7 @@ module Asana
         # workspace cannot be changed once set. The workspace need not be set
         # explicitly if you specify a `project` or a `parent` task instead.
         #
-        # workspace - [Id] The workspace to create a task in.
+        # workspace - [Gid] The workspace to create a task in.
         # options - [Hash] the request I/O options.
         # data - [Hash] the attributes to post.
         def create_in_workspace(client, workspace: required("workspace"), options: {}, **data)
@@ -116,7 +119,7 @@ module Asana
 
         # Returns the complete task record for a single task.
         #
-        # id - [Id] The task to get.
+        # id - [Gid] The task to get.
         # options - [Hash] the request I/O options.
         def find_by_id(client, id, options: {})
 
@@ -126,17 +129,17 @@ module Asana
         # Returns the compact task records for all tasks within the given project,
         # ordered by their priority within the project.
         #
-        # projectId - [Id] The project in which to search for tasks.
+        # project - [Gid] The project in which to search for tasks.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
-        def find_by_project(client, projectId: required("projectId"), per_page: 20, options: {})
+        def find_by_project(client, project: nil, projectId: nil, per_page: 20, options: {})
           params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-          Collection.new(parse(client.get("/projects/#{projectId}/tasks", params: params, options: options)), type: self, client: client)
+          Collection.new(parse(client.get("/projects/#{project != nil ? project : projectId}/tasks", params: params, options: options)), type: self, client: client)
         end
 
         # Returns the compact task records for all tasks with the given tag.
         #
-        # tag - [Id] The tag in which to search for tasks.
+        # tag - [Gid] The tag in which to search for tasks.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
         def find_by_tag(client, tag: required("tag"), per_page: 20, options: {})
@@ -146,7 +149,7 @@ module Asana
 
         # <b>Board view only:</b> Returns the compact section records for all tasks within the given section.
         #
-        # section - [Id] The section in which to search for tasks.
+        # section - [Gid] The section in which to search for tasks.
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
         def find_by_section(client, section: required("section"), per_page: 20, options: {})
@@ -154,14 +157,46 @@ module Asana
           Collection.new(parse(client.get("/sections/#{section}/tasks", params: params, options: options)), type: self, client: client)
         end
 
+        # Returns the compact list of tasks in a user's My Tasks list. The returned
+        # tasks will be in order within each assignee status group of `Inbox`,
+        # `Today`, and `Upcoming`.
+        #
+        # **Note:** tasks in `Later` have a different ordering in the Asana web app
+        # than the other assignee status groups; this endpoint will still return
+        # them in list order in `Later` (differently than they show up in Asana,
+        # but the same order as in Asana's mobile apps).
+        #
+        # **Note:** Access control is enforced for this endpoint as with all Asana
+        # API endpoints, meaning a user's private tasks will be filtered out if the
+        # API-authenticated user does not have access to them.
+        #
+        # **Note:** Both complete and incomplete tasks are returned by default
+        # unless they are filtered out (for example, setting `completed_since=now`
+        # will return only incomplete tasks, which is the default view for "My
+        # Tasks" in Asana.)
+        #
+        # user_task_list - [Gid] The user task list in which to search for tasks.
+        # completed_since - [String] Only return tasks that are either incomplete or that have been
+        # completed since this time.
+        #
+        # per_page - [Integer] the number of records to fetch per page.
+        # options - [Hash] the request I/O options.
+        def find_by_user_task_list(client, user_task_list: required("user_task_list"), completed_since: nil, per_page: 20, options: {})
+          params = { completed_since: completed_since, limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+          Collection.new(parse(client.get("/user_task_lists/#{user_task_list}/tasks", params: params, options: options)), type: self, client: client)
+        end
+
         # Returns the compact task records for some filtered set of tasks. Use one
         # or more of the parameters provided to filter the tasks returned. You must
-        # specify a `project` or `tag` if you do not specify `assignee` and `workspace`.
+        # specify a `project`, `section`, `tag`, or `user_task_list` if you do not
+        # specify `assignee` and `workspace`.
         #
         # assignee - [String] The assignee to filter tasks on.
-        # project - [Id] The project to filter tasks on.
-        # section - [Id] The section to filter tasks on.
-        # workspace - [Id] The workspace or organization to filter tasks on.
+        # workspace - [Gid] The workspace or organization to filter tasks on.
+        # project - [Gid] The project to filter tasks on.
+        # section - [Gid] The section to filter tasks on.
+        # tag - [Gid] The tag to filter tasks on.
+        # user_task_list - [Gid] The user task list to filter tasks on.
         # completed_since - [String] Only return tasks that are either incomplete or that have been
         # completed since this time.
         #
@@ -173,30 +208,33 @@ module Asana
         #
         # If you specify `assignee`, you must also specify the `workspace` to filter on.
         #
-        # Currently, this is only supported in board views.
-        #
         # If you specify `workspace`, you must also specify the `assignee` to filter on.
         #
+        # Currently, this is only supported in board views.
+        #
         # A task is considered "modified" if any of its properties change,
         # or associations between it and other objects are modified (e.g.
         # a task being added to a project). A task is not considered modified
         # just because another object it is associated with (e.g. a subtask)
         # is modified. Actions that count as modifying the task include
         # assigning, renaming, completing, and adding stories.
-        def find_all(client, assignee: nil, project: nil, section: nil, workspace: nil, completed_since: nil, modified_since: nil, per_page: 20, options: {})
-          params = { assignee: assignee, project: project, section: section, workspace: workspace, completed_since: completed_since, modified_since: modified_since, limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+        def find_all(client, assignee: nil, workspace: nil, project: nil, section: nil, tag: nil, user_task_list: nil, completed_since: nil, modified_since: nil, per_page: 20, options: {})
+          params = { assignee: assignee, workspace: workspace, project: project, section: section, tag: tag, user_task_list: user_task_list, completed_since: completed_since, modified_since: modified_since, limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
           Collection.new(parse(client.get("/tasks", params: params, options: options)), type: self, client: client)
         end
 
         # The search endpoint allows you to build complex queries to find and fetch exactly the data you need from Asana. For a more comprehensive description of all the query parameters and limitations of this endpoint, see our [long-form documentation](/developers/documentation/getting-started/search-api) for this feature.
         #
-        # workspace - [Id] The workspace or organization in which to search for tasks.
+        # workspace - [Gid] The workspace or organization in which to search for tasks.
+        # resource_subtype - [Enum] Filters results by the task's resource_subtype.
+        #
         # per_page - [Integer] the number of records to fetch per page.
         # options - [Hash] the request I/O options.
-        def search(client, workspace: required("workspace"), per_page: 20, options: {})
-          params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+        def search_in_workspace(client, workspace: required("workspace"), resource_subtype: nil, per_page: 20, options: {})
+          params = { resource_subtype: resource_subtype, limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
           Collection.new(parse(client.get("/workspaces/#{workspace}/tasks/search", params: params, options: options)), type: Resource, client: client)
         end
+        alias_method :search, :search_in_workspace
       end
 
       # A specific, existing task can be updated by making a PUT request on the
@@ -213,7 +251,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def update(options: {}, **data)
 
-        refresh_with(parse(client.put("/tasks/#{id}", body: data, options: options)).first)
+        refresh_with(parse(client.put("/tasks/#{gid}", body: data, options: options)).first)
       end
 
       # A specific, existing task can be deleted by making a DELETE request on the
@@ -224,7 +262,19 @@ module Asana
       # Returns an empty data record.
       def delete()
 
-        client.delete("/tasks/#{id}") && true
+        client.delete("/tasks/#{gid}") && true
+      end
+
+      # Creates and returns a job that will asynchronously handle the duplication.
+      #
+      # name - [String] The name of the new task.
+      # include - [Array] The fields that will be duplicated to the new task.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def duplicate_task(name: required("name"), include: nil, options: {}, **data)
+        with_params = data.merge(name: name, include: include).reject { |_,v| v.nil? || Array(v).empty? }
+        Resource.new(parse(client.post("/tasks/#{gid}/duplicate", body: with_params, options: options)).first, client: client)
       end
 
       # Returns the compact representations of all of the dependencies of a task.
@@ -232,7 +282,7 @@ module Asana
       # options - [Hash] the request I/O options.
       def dependencies(options: {})
 
-        Resource.new(parse(client.get("/tasks/#{id}/dependencies", options: options)).first, client: client)
+        Collection.new(parse(client.get("/tasks/#{gid}/dependencies", options: options)), type: self.class, client: client)
       end
 
       # Returns the compact representations of all of the dependents of a task.
@@ -240,7 +290,7 @@ module Asana
       # options - [Hash] the request I/O options.
       def dependents(options: {})
 
-        Resource.new(parse(client.get("/tasks/#{id}/dependents", options: options)).first, client: client)
+        Collection.new(parse(client.get("/tasks/#{gid}/dependents", options: options)), type: self.class, client: client)
       end
 
       # Marks a set of tasks as dependencies of this task, if they are not
@@ -251,7 +301,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def add_dependencies(dependencies: required("dependencies"), options: {}, **data)
         with_params = data.merge(dependencies: dependencies).reject { |_,v| v.nil? || Array(v).empty? }
-        Resource.new(parse(client.post("/tasks/#{id}/addDependencies", body: with_params, options: options)).first, client: client)
+        Collection.new(parse(client.post("/tasks/#{gid}/addDependencies", body: with_params, options: options)), type: self.class, client: client)
       end
 
       # Marks a set of tasks as dependents of this task, if they are not already
@@ -262,7 +312,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def add_dependents(dependents: required("dependents"), options: {}, **data)
         with_params = data.merge(dependents: dependents).reject { |_,v| v.nil? || Array(v).empty? }
-        Resource.new(parse(client.post("/tasks/#{id}/addDependents", body: with_params, options: options)).first, client: client)
+        Collection.new(parse(client.post("/tasks/#{gid}/addDependents", body: with_params, options: options)), type: self.class, client: client)
       end
 
       # Unlinks a set of dependencies from this task.
@@ -272,7 +322,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def remove_dependencies(dependencies: required("dependencies"), options: {}, **data)
         with_params = data.merge(dependencies: dependencies).reject { |_,v| v.nil? || Array(v).empty? }
-        Resource.new(parse(client.post("/tasks/#{id}/removeDependencies", body: with_params, options: options)).first, client: client)
+        Collection.new(parse(client.post("/tasks/#{gid}/removeDependencies", body: with_params, options: options)), type: self.class, client: client)
       end
 
       # Unlinks a set of dependents from this task.
@@ -282,7 +332,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def remove_dependents(dependents: required("dependents"), options: {}, **data)
         with_params = data.merge(dependents: dependents).reject { |_,v| v.nil? || Array(v).empty? }
-        Resource.new(parse(client.post("/tasks/#{id}/removeDependents", body: with_params, options: options)).first, client: client)
+        Collection.new(parse(client.post("/tasks/#{gid}/removeDependents", body: with_params, options: options)), type: self.class, client: client)
       end
 
       # Adds each of the specified followers to the task, if they are not already
@@ -293,7 +343,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def add_followers(followers: required("followers"), options: {}, **data)
         with_params = data.merge(followers: followers).reject { |_,v| v.nil? || Array(v).empty? }
-        refresh_with(parse(client.post("/tasks/#{id}/addFollowers", body: with_params, options: options)).first)
+        refresh_with(parse(client.post("/tasks/#{gid}/addFollowers", body: with_params, options: options)).first)
       end
 
       # Removes each of the specified followers from the task if they are
@@ -304,7 +354,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def remove_followers(followers: required("followers"), options: {}, **data)
         with_params = data.merge(followers: followers).reject { |_,v| v.nil? || Array(v).empty? }
-        refresh_with(parse(client.post("/tasks/#{id}/removeFollowers", body: with_params, options: options)).first)
+        refresh_with(parse(client.post("/tasks/#{gid}/removeFollowers", body: with_params, options: options)).first)
       end
 
       # Returns a compact representation of all of the projects the task is in.
@@ -313,7 +363,7 @@ module Asana
       # options - [Hash] the request I/O options.
       def projects(per_page: 20, options: {})
         params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-        Collection.new(parse(client.get("/tasks/#{id}/projects", params: params, options: options)), type: Project, client: client)
+        Collection.new(parse(client.get("/tasks/#{gid}/projects", params: params, options: options)), type: Project, client: client)
       end
 
       # Adds the task to the specified project, in the optional location
@@ -331,21 +381,21 @@ module Asana
       #
       # Returns an empty data block.
       #
-      # project - [Id] The project to add the task to.
-      # insert_after - [Id] A task in the project to insert the task after, or `null` to
+      # project - [Gid] The project to add the task to.
+      # insert_after - [Gid] A task in the project to insert the task after, or `null` to
       # insert at the beginning of the list.
       #
-      # insert_before - [Id] A task in the project to insert the task before, or `null` to
+      # insert_before - [Gid] A task in the project to insert the task before, or `null` to
       # insert at the end of the list.
       #
-      # section - [Id] A section in the project to insert the task into. The task will be
+      # section - [Gid] A section in the project to insert the task into. The task will be
       # inserted at the bottom of the section.
       #
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
       def add_project(project: required("project"), insert_after: nil, insert_before: nil, section: nil, options: {}, **data)
         with_params = data.merge(project: project, insert_after: insert_after, insert_before: insert_before, section: section).reject { |_,v| v.nil? || Array(v).empty? }
-        client.post("/tasks/#{id}/addProject", body: with_params, options: options) && true
+        client.post("/tasks/#{gid}/addProject", body: with_params, options: options) && true
       end
 
       # Removes the task from the specified project. The task will still exist
@@ -353,12 +403,12 @@ module Asana
       #
       # Returns an empty data block.
       #
-      # project - [Id] The project to remove the task from.
+      # project - [Gid] The project to remove the task from.
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
       def remove_project(project: required("project"), options: {}, **data)
         with_params = data.merge(project: project).reject { |_,v| v.nil? || Array(v).empty? }
-        client.post("/tasks/#{id}/removeProject", body: with_params, options: options) && true
+        client.post("/tasks/#{gid}/removeProject", body: with_params, options: options) && true
       end
 
       # Returns a compact representation of all of the tags the task has.
@@ -367,27 +417,27 @@ module Asana
       # options - [Hash] the request I/O options.
       def tags(per_page: 20, options: {})
         params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-        Collection.new(parse(client.get("/tasks/#{id}/tags", params: params, options: options)), type: Tag, client: client)
+        Collection.new(parse(client.get("/tasks/#{gid}/tags", params: params, options: options)), type: Tag, client: client)
       end
 
       # Adds a tag to a task. Returns an empty data block.
       #
-      # tag - [Id] The tag to add to the task.
+      # tag - [Gid] The tag to add to the task.
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
       def add_tag(tag: required("tag"), options: {}, **data)
         with_params = data.merge(tag: tag).reject { |_,v| v.nil? || Array(v).empty? }
-        client.post("/tasks/#{id}/addTag", body: with_params, options: options) && true
+        client.post("/tasks/#{gid}/addTag", body: with_params, options: options) && true
       end
 
       # Removes a tag from the task. Returns an empty data block.
       #
-      # tag - [Id] The tag to remove from the task.
+      # tag - [Gid] The tag to remove from the task.
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
       def remove_tag(tag: required("tag"), options: {}, **data)
         with_params = data.merge(tag: tag).reject { |_,v| v.nil? || Array(v).empty? }
-        client.post("/tasks/#{id}/removeTag", body: with_params, options: options) && true
+        client.post("/tasks/#{gid}/removeTag", body: with_params, options: options) && true
       end
 
       # Returns a compact representation of all of the subtasks of a task.
@@ -396,7 +446,7 @@ module Asana
       # options - [Hash] the request I/O options.
       def subtasks(per_page: 20, options: {})
         params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-        Collection.new(parse(client.get("/tasks/#{id}/subtasks", params: params, options: options)), type: self.class, client: client)
+        Collection.new(parse(client.get("/tasks/#{gid}/subtasks", params: params, options: options)), type: self.class, client: client)
       end
 
       # Creates a new subtask and adds it to the parent task. Returns the full record
@@ -406,7 +456,7 @@ module Asana
       # data - [Hash] the attributes to post.
       def add_subtask(options: {}, **data)
 
-        self.class.new(parse(client.post("/tasks/#{id}/subtasks", body: data, options: options)).first, client: client)
+        self.class.new(parse(client.post("/tasks/#{gid}/subtasks", body: data, options: options)).first, client: client)
       end
 
       # Changes the parent of a task. Each task may only be a subtask of a single
@@ -414,18 +464,18 @@ module Asana
       # at most one of those two options can be specified, and they must already be subtasks
       # of the parent.
       #
-      # parent - [Id] The new parent of the task, or `null` for no parent.
-      # insert_after - [Id] A subtask of the parent to insert the task after, or `null` to
+      # parent - [Gid] The new parent of the task, or `null` for no parent.
+      # insert_after - [Gid] A subtask of the parent to insert the task after, or `null` to
       # insert at the beginning of the list.
       #
-      # insert_before - [Id] A subtask of the parent to insert the task before, or `null` to
+      # insert_before - [Gid] A subtask of the parent to insert the task before, or `null` to
       # insert at the end of the list.
       #
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
       def set_parent(parent: required("parent"), insert_after: nil, insert_before: nil, options: {}, **data)
         with_params = data.merge(parent: parent, insert_after: insert_after, insert_before: insert_before).reject { |_,v| v.nil? || Array(v).empty? }
-        client.post("/tasks/#{id}/setParent", body: with_params, options: options) && true
+        client.post("/tasks/#{gid}/setParent", body: with_params, options: options) && true
       end
 
       # Returns a compact representation of all of the stories on the task.
@@ -434,7 +484,7 @@ module Asana
       # options - [Hash] the request I/O options.
       def stories(per_page: 20, options: {})
         params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-        Collection.new(parse(client.get("/tasks/#{id}/stories", params: params, options: options)), type: Story, client: client)
+        Collection.new(parse(client.get("/tasks/#{gid}/stories", params: params, options: options)), type: Story, client: client)
       end
 
       # Adds a comment to a task. The comment will be authored by the
@@ -448,7 +498,32 @@ module Asana
       # data - [Hash] the attributes to post.
       def add_comment(text: required("text"), options: {}, **data)
         with_params = data.merge(text: text).reject { |_,v| v.nil? || Array(v).empty? }
-        Story.new(parse(client.post("/tasks/#{id}/stories", body: with_params, options: options)).first, client: client)
+        Story.new(parse(client.post("/tasks/#{gid}/stories", body: with_params, options: options)).first, client: client)
+      end
+
+      # Insert or reorder tasks in a user's My Tasks list. If the task was not
+      # assigned to the owner of the user task list it will be reassigned when
+      # this endpoint is called. If neither `insert_before` nor `insert_after`
+      # are provided the task will be inserted at the top of the assignee's
+      # inbox.
+      #
+      # Returns an empty data block.
+      #
+      # user_task_list - [Gid] Globally unique identifier for the user task list.
+      #
+      # insert_before - [Gid] Insert the task before the task specified by this field. The inserted
+      # task will inherit the `assignee_status` of this task. `insert_before`
+      # and `insert_after` parameters cannot both be specified.
+      #
+      # insert_after - [Gid] Insert the task after the task specified by this field. The inserted
+      # task will inherit the `assignee_status` of this task. `insert_before`
+      # and `insert_after` parameters cannot both be specified.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def insert_in_user_task_list(user_task_list: required("user_task_list"), insert_before: nil, insert_after: nil, options: {}, **data)
+        with_params = data.merge(insert_before: insert_before, insert_after: insert_after).reject { |_,v| v.nil? || Array(v).empty? }
+        client.post("/user_task_lists/#{user_task_list}/tasks/insert", body: with_params, options: options) && true
       end
 
     end