asana 0.6.3 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a918da44ed24274296db1a40bda628d24e48ca40ea53622ba13f4309784a3b0
-  data.tar.gz: 1c0b2ffaee3b5bc3dc207c60122da6dd97f97009f538163037cf8e135fad29b8
+  metadata.gz: 7d310a2dce08f1a0d3184d739bca9be4cd8ad88368337595f1ec7ac31330d745
+  data.tar.gz: eef90d3cc06cf5a93725f20ab4b67e6b369c97a20952c6d50ed249f1c08dc666
 SHA512:
-  metadata.gz: d73d39ad30a783c5849a6e7d3bdb4fccf69c27837f8def2cefa3ef93b0e7b14e721eda1b4e05251887b5347837b1de03d084cc45ec3cf17c07323b3071f73017
-  data.tar.gz: 9bbca4c1b400bbac20484c473288aff9d867d76544b6552ee807050ac0ea4ed9f85fb2b2a33397ac848f6d7fbad3c1fd1c637fa748797cff9669aa15fd8877d6
+  metadata.gz: 44a15f43e827a51b5f215d892248d9304dd1fc5c584d8a0b6b15a197f550f5ce61b7f7a8c6181eb14581b2a2ff99d60403e7e71b82a342d111fe5e47bfae6f7e
+  data.tar.gz: 707eb76c9827419e3b89188680bf979cc6007b81eb090b56c319f9b2cf8b4b90712f68796459f95bcda296c6d6df2d6ac27b5b99fc14708a1820f0539085daef

data/examples/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    asana (0.6.3)
+    asana (0.8.0)
       faraday (~> 0.9)
       faraday_middleware (~> 0.9)
       faraday_middleware-multi_json (~> 0.0)

data/lib/asana/errors.rb

@@ -19,7 +19,7 @@ module Asana
     # user could not be authenticated.
     NotAuthorized = Class.new(APIError) do
       def to_s
-        'A valid API key was not provided with the request, so the API could '\
+        'Valid credentials were not provided with the request, so the API could '\
         'not associate a user with the request.'
       end
     end
@@ -37,7 +37,7 @@ module Asana
     # access the requested resource or to perform the requested action on it.
     Forbidden = Class.new(APIError) do
       def to_s
-        'The API key and request syntax was valid but the server is refusing '\
+        'The authorization and request syntax was valid but the server is refusing '\
         'to complete the request. This can happen if you try to read or write '\
         'to objects or properties that the user does not have access to.'
       end

data/lib/asana/http_client/error_handling.rb

@@ -11,7 +11,7 @@ module Asana
 
       module_function
 
-      PREMIUM_ONLY_STR = 'not available for free'.freeze
+      MAX_TIMEOUTS = 5
 
       # Public: Perform a request handling any API errors correspondingly.
       #
@@ -28,7 +28,7 @@ module Asana
       # Raises [Asana::Errors::APIError] when the API returns an unknown error.
       #
       # rubocop:disable all
-      def handle(&request)
+      def handle(num_timeouts=0, &request)
         request.call
       rescue Faraday::ClientError => e
         raise e unless e.response
@@ -36,25 +36,19 @@ module Asana
           when 400 then raise invalid_request(e.response)
           when 401 then raise not_authorized(e.response)
           when 402 then raise payment_required(e.response)
-          when 403
-            begin
-              body = body(e.response)
-              errors_str = body['errors'].collect {
-                |err| err['message']
-              }.join('; ')
-              if errors_str.include? PREMIUM_ONLY_STR
-                raise payment_required(e.response)
-              end
-            rescue
-              raise forbidden(e.response)
-            end
-            raise forbidden(e.response)
+          when 403 then raise forbidden(e.response)
           when 404 then raise not_found(e.response)
           when 412 then recover_response(e.response)
           when 429 then raise rate_limit_enforced(e.response)
           when 500 then raise server_error(e.response)
           else raise api_error(e.response)
         end
+      rescue Net::ReadTimeout => e
+        if num_timeouts < MAX_TIMEOUTS
+          handle(num_timeouts + 1, &request)
+        else
+          raise e
+        end
       end
       # rubocop:enable all
 

data/lib/asana/resources/attachment.rb

@@ -53,4 +53,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/custom_field_settings.rb

@@ -30,13 +30,14 @@ module Asana
         # Returns a list of all of the custom fields settings on a project, in compact form. Note that, as in all queries to collections which return compact representation, `opt_fields` and `opt_expand` can be used to include more data than is returned in the compact representation. See the getting started guide on [input/output options](/developers/documentation/getting-started/input-output-options) for more information.
         #
         # project - [Id] The ID of the project for which to list custom field settings
+        # 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"), options: {})
-
-          Resource.new(parse(client.get("/projects/#{project}/custom_field_settings", options: options)).first, client: client)
+        def find_by_project(client, project: required("project"), per_page: 20, options: {})
+          params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+          Collection.new(parse(client.get("/projects/#{project}/custom_field_settings", params: params, options: options)), type: Resource, client: client)
         end
       end
 
     end
   end
-end
+end

data/lib/asana/resources/custom_fields.rb

@@ -13,10 +13,10 @@ module Asana
 
       attr_reader :id
 
-      attr_reader :created_at
-
       attr_reader :name
 
+      attr_reader :description
+
       attr_reader :type
 
       attr_reader :enum_options
@@ -29,6 +29,25 @@ module Asana
           'custom_fields'
         end
 
+        # Creates a new custom field in a workspace. Every custom field is required to be created in a specific workspace, and this workspace cannot be changed once set.
+        #
+        # A custom field's `name` must be unique within a workspace and not conflict with names of existing task properties such as 'Due Date' or 'Assignee'. A custom field's `type` must be one of  'text', 'enum', or 'number'.
+        #
+        # Returns the full record of the newly created custom field.
+        #
+        # workspace - [Id] The workspace to create a custom field in.
+        # type - [String] The type of the custom field.
+        # name - [String] The name of the custom field.
+        # description - [String] The description of the custom field.
+        # precision - [Integer] The number of decimal places for the numerical values. Required if the custom field is of type 'number'.
+        # enum_options - [String] The discrete values the custom field can assume. Required if the custom field is of type 'enum'.
+        # options - [Hash] the request I/O options.
+        # data - [Hash] the attributes to post.
+        def create(client, workspace: required("workspace"), type: required("type"), name: required("name"), description: nil, precision: nil, enum_options: nil, options: {}, **data)
+          with_params = data.merge(workspace: workspace, type: type, name: name, description: description, precision: precision, enum_options: enum_options).reject { |_,v| v.nil? || Array(v).empty? }
+          Resource.new(parse(client.post("/custom_fields", body: with_params, options: options)).first, client: client)
+        end
+
         # Returns the complete definition of a custom field's metadata.
         #
         # id - [Id] Globally unique identifier for the custom field.
@@ -42,13 +61,88 @@ module Asana
         # Returns a list of the compact representation of all of the custom fields in a workspace.
         #
         # workspace - [Id] The workspace or organization to find custom field definitions 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: {})
+          params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+          Collection.new(parse(client.get("/workspaces/#{workspace}/custom_fields", params: params, options: options)), type: Resource, client: client)
+        end
+
+        # Creates an enum option and adds it to this custom field's list of enum options. A custom field can have at most 50 enum options (including disabled options). By default new enum options are inserted at the end of a custom field's list.
+        #
+        # Returns the full record of the newly created enum option.
+        #
+        # custom_field - [Id] Globally unique identifier for the custom field.
+        #
+        # name - [String] The name of the enum option.
+        # color - [String] The color of the enum option. Defaults to 'none'.
+        # insert_before - [Id] An existing enum option within this custom field before which the new enum option should be inserted. Cannot be provided together with after_enum_option.
+        # insert_after - [Id] An existing enum option within this custom field after which the new enum option should be inserted. Cannot be provided together with before_enum_option.
         # options - [Hash] the request I/O options.
-        def find_by_workspace(client, workspace: required("workspace"), options: {})
+        # data - [Hash] the attributes to post.
+        def add_enum_option(client, custom_field: required("custom_field"), name: required("name"), color: nil, insert_before: nil, insert_after: nil, options: {}, **data)
+          with_params = data.merge(name: name, color: color, insert_before: insert_before, insert_after: insert_after).reject { |_,v| v.nil? || Array(v).empty? }
+          Resource.new(parse(client.post("/custom_fields/#{custom_field}/enum_options", body: with_params, options: options)).first, client: client)
+        end
 
-          Resource.new(parse(client.get("/workspaces/#{workspace}/custom_fields", options: options)).first, client: client)
+        # Moves a particular enum option to be either before or after another specified enum option in the custom field.
+        #
+        # custom_field - [Id] Globally unique identifier for the custom field.
+        #
+        # enum_option - [Id] The ID of the enum option to relocate.
+        # name - [String] The name of the enum option.
+        # color - [String] The color of the enum option. Defaults to 'none'.
+        # before_enum_option - [Id] An existing enum option within this custom field before which the new enum option should be inserted. Cannot be provided together with after_enum_option.
+        # after_enum_option - [Id] An existing enum option within this custom field after which the new enum option should be inserted. Cannot be provided together with before_enum_option.
+        # options - [Hash] the request I/O options.
+        # data - [Hash] the attributes to post.
+        def reorder_enum_option(client, custom_field: required("custom_field"), enum_option: required("enum_option"), name: required("name"), color: nil, before_enum_option: nil, after_enum_option: nil, options: {}, **data)
+          with_params = data.merge(enum_option: enum_option, name: name, color: color, before_enum_option: before_enum_option, after_enum_option: after_enum_option).reject { |_,v| v.nil? || Array(v).empty? }
+          Resource.new(parse(client.post("/custom_fields/#{custom_field}/enum_options/insert", body: with_params, options: options)).first, client: client)
         end
       end
 
+      # A specific, existing custom field can be updated by making a PUT request on the URL for that custom field. Only the fields provided in the `data` block will be updated; any unspecified fields will remain unchanged
+      #
+      # When using this method, it is best to specify only those fields you wish to change, or else you may overwrite changes made by another user since you last retrieved the custom field.
+      #
+      # A custom field's `type` cannot be updated.
+      #
+      # An enum custom field's `enum_options` cannot be updated with this endpoint. Instead see "Work With Enum Options" for information on how to update `enum_options`.
+      #
+      # Returns the complete updated custom field record.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def update(options: {}, **data)
+
+        refresh_with(parse(client.put("/custom_fields/#{id}", body: data, options: options)).first)
+      end
+
+      # A specific, existing custom field can be deleted by making a DELETE request on the URL for that custom field.
+      #
+      # Returns an empty data record.
+      def delete()
+
+        client.delete("/custom_fields/#{id}") && true
+      end
+
+      # Updates an existing enum option. Enum custom fields require at least one enabled enum option.
+      #
+      # Returns the full record of the updated enum option.
+      #
+      # enum_option - [Id] Globally unique identifier for the enum option.
+      #
+      # name - [String] The name of the enum option.
+      # color - [String] The color of the enum option. Defaults to 'none'.
+      # enabled - [Boolean] Whether or not the enum option is a selectable value for the custom field.
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def update_enum_option(enum_option: required("enum_option"), name: required("name"), color: nil, enabled: nil, options: {}, **data)
+        with_params = data.merge(name: name, color: color, enabled: enabled).reject { |_,v| v.nil? || Array(v).empty? }
+        refresh_with(parse(client.put("/enum_options/#{enum_option}", body: with_params, options: options)).first)
+      end
+
     end
   end
-end
+end

data/lib/asana/resources/organization_export.rb

@@ -0,0 +1,63 @@
+### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
+### edit it manually.
+
+module Asana
+  module Resources
+    # An _organization_export_ object represents a request to export the complete data of an Organization
+    # in JSON format.
+    #
+    # To export an Organization using this API:
+    #
+    # * Create an `organization_export` [request](#create) and store the id that is returned.\
+    # * Request the `organization_export` every few minutes, until the `state` field contains 'finished'.\
+    # * Download the file located at the URL in the `download_url` field.
+    #
+    # Exports can take a long time, from several minutes to a few hours for large Organizations.
+    #
+    # **Note:** These endpoints are only available to [Service Accounts](/guide/help/premium/service-accounts)
+    # of an [Enterprise](/enterprise) Organization.
+    class OrganizationExport < Resource
+
+
+      attr_reader :id
+
+      attr_reader :created_at
+
+      attr_reader :download_url
+
+      attr_reader :state
+
+      attr_reader :organization
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'organization_exports'
+        end
+
+        # Returns details of a previously-requested Organization export.
+        #
+        # id - [Id] Globally unique identifier for the Organization export.
+        #
+        # options - [Hash] the request I/O options.
+        def find_by_id(client, id, options: {})
+
+          self.new(parse(client.get("/organization_exports/#{id}", options: options)).first, client: client)
+        end
+
+        # This method creates a request to export an Organization. Asana will complete the export at some
+        # point after you create the request.
+        #
+        # organization - [Id] Globally unique identifier for the workspace or organization.
+        #
+        # options - [Hash] the request I/O options.
+        # data - [Hash] the attributes to post.
+        def create(client, organization: required("organization"), options: {}, **data)
+          with_params = data.merge(organization: organization).reject { |_,v| v.nil? || Array(v).empty? }
+          Resource.new(parse(client.post("/organization_exports", body: with_params, options: options)).first, client: client)
+        end
+      end
+
+    end
+  end
+end

data/lib/asana/resources/project.rb

@@ -3,14 +3,15 @@
 
 module Asana
   module Resources
-    # A _project_ represents a prioritized list of tasks in Asana. It exists in a
-    # single workspace or organization and is accessible to a subset of users in
-    # that workspace or organization, depending on its permissions.
+    # A _project_ represents a prioritized list of tasks in Asana or a board with
+    # columns of tasks represented as cards. It exists in a single workspace or
+    # organization and is accessible to a subset of users in that workspace or
+    # organization, depending on its permissions.
     #
     # Projects in organizations are shared with a single team. You cannot currently
     # change the team of a project via the API. Non-organization workspaces do not
-    # have teams and so you should not specify the team of project in a
-    # regular workspace.
+    # have teams and so you should not specify the team of project in a regular
+    # workspace.
     class Project < Resource
 
       include EventSubscription
@@ -26,6 +27,8 @@ module Asana
 
       attr_reader :due_date
 
+      attr_reader :start_on
+
       attr_reader :created_at
 
       attr_reader :modified_at
@@ -48,6 +51,8 @@ module Asana
 
       attr_reader :team
 
+      attr_reader :layout
+
       class << self
         # Returns the plural name of the resource.
         def plural_name
@@ -179,15 +184,6 @@ module Asana
         client.delete("/projects/#{id}") && true
       end
 
-      # Returns compact records for all sections in the specified project.
-      #
-      # per_page - [Integer] the number of records to fetch per page.
-      # options - [Hash] the request I/O options.
-      def sections(per_page: 20, options: {})
-        params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
-        Collection.new(parse(client.get("/projects/#{id}/sections", params: params, options: options)), type: Resource, client: client)
-      end
-
       # Returns the compact task records for all tasks within the given project,
       # ordered by their priority within the project. Tasks can exist in more than one project at a time.
       #
@@ -271,4 +267,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/project_membership.rb

@@ -0,0 +1,51 @@
+### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
+### edit it manually.
+
+module Asana
+  module Resources
+    # With the introduction of "comment-only" projects in Asana, a user's membership
+    # in a project comes with associated permissions. These permissions (whether a
+    # user has full access to the project or comment-only access) are accessible
+    # through the project memberships endpoints described here.
+    class ProjectMembership < Resource
+
+
+      attr_reader :id
+
+      attr_reader :user
+
+      attr_reader :project
+
+      attr_reader :write_access
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'project_memberships'
+        end
+
+        # Returns the compact project membership records for the project.
+        #
+        # project - [Id] 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: {})
+          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
+
+        # Returns the project membership record.
+        #
+        # project - [Id] Globally unique identifier for the project membership.
+        #
+        # options - [Hash] the request I/O options.
+        def get_single(client, project: required("project"), options: {})
+
+          Resource.new(parse(client.get("/project_memberships/#{project}", options: options)).first, client: client)
+        end
+      end
+
+    end
+  end
+end

data/lib/asana/resources/project_status.rb

@@ -0,0 +1,79 @@
+### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
+### edit it manually.
+
+module Asana
+  module Resources
+    # A _project status_ is an update on the progress of a particular project, and is sent out to all project
+    # followers when created. These updates include both text describing the update and a color code intended to
+    # represent the overall state of the project: "green" for projects that are on track, "yellow" for projects
+    # at risk, and "red" for projects that are behind.
+    #
+    # Project statuses can be created and deleted, but not modified.
+    class ProjectStatus < Resource
+
+
+      attr_reader :id
+
+      attr_reader :title
+
+      attr_reader :text
+
+      attr_reader :color
+
+      attr_reader :created_by
+
+      attr_reader :created_at
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'project_statuses'
+        end
+
+        # Creates a new status update on the project.
+        #
+        # Returns the full record of the newly created project status update.
+        #
+        # project - [Id] 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)
+          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
+
+        # Returns the compact project status update records for all updates on the project.
+        #
+        # project - [Id] 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: {})
+          params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+          Collection.new(parse(client.get("/projects/#{project}/project_statuses", params: params, options: options)), type: Resource, client: client)
+        end
+
+        # Returns the complete record for a single status update.
+        #
+        # id - [Id] The project status update to get.
+        # options - [Hash] the request I/O options.
+        def find_by_id(client, id, options: {})
+
+          self.new(parse(client.get("/project_statuses/#{id}", options: options)).first, client: client)
+        end
+      end
+
+      # Deletes a specific, existing project status update.
+      #
+      # Returns an empty data record.
+      def delete()
+
+        client.delete("/project_statuses/#{id}") && true
+      end
+
+    end
+  end
+end

data/lib/asana/resources/section.rb

@@ -0,0 +1,110 @@
+### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
+### edit it manually.
+
+module Asana
+  module Resources
+    # A _section_ is a subdivision of a project that groups tasks together. It can
+    # either be a header above a list of tasks in a list view or a column in a
+    # board view of a project.
+    class Section < Resource
+
+
+      attr_reader :id
+
+      attr_reader :name
+
+      attr_reader :project
+
+      attr_reader :created_at
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'sections'
+        end
+
+        # Creates a new section in a project.
+        #
+        # Returns the full record of the newly created section.
+        #
+        # project - [Id] 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.
+        def create_in_project(client, project: required("project"), name: required("name"), options: {}, **data)
+          with_params = data.merge(name: name).reject { |_,v| v.nil? || Array(v).empty? }
+          self.new(parse(client.post("/projects/#{project}/sections", body: with_params, options: options)).first, client: client)
+        end
+
+        # Returns the compact records for all sections in the specified project.
+        #
+        # project - [Id] The project to get sections from.
+        # options - [Hash] the request I/O options.
+        def find_by_project(client, project: required("project"), options: {})
+
+          self.new(parse(client.get("/projects/#{project}/sections", options: options)).first, client: client)
+        end
+
+        # Returns the complete record for a single section.
+        #
+        # id - [Id] 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
+      end
+
+      # A specific, existing section can be updated by making a PUT request on
+      # the URL for that project. Only the fields provided in the `data` block
+      # will be updated; any unspecified fields will remain unchanged. (note that
+      # at this time, the only field that can be updated is the `name` field.)
+      #
+      # When using this method, it is best to specify only those fields you wish
+      # to change, or else you may overwrite changes made by another user since
+      # you last retrieved the task.
+      #
+      # Returns the complete updated section record.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def update(options: {}, **data)
+
+        refresh_with(parse(client.put("/sections/#{id}", body: data, options: options)).first)
+      end
+
+      # A specific, existing section can be deleted by making a DELETE request
+      # on the URL for that section.
+      #
+      # Note that sections must be empty to be deleted.
+      #
+      # The last remaining section in a board view cannot be deleted.
+      #
+      # Returns an empty data block.
+      def delete()
+
+        client.delete("/sections/#{id}") && true
+      end
+
+      # Move sections relative to each other in a board view. One of
+      # `before_section` or `after_section` is required.
+      #
+      # Sections cannot be moved between projects.
+      #
+      # At this point in time, moving sections is not supported in list views, only board views.
+      #
+      # 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.
+      # 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)
+        with_params = data.merge(before_section: before_section, after_section: after_section).reject { |_,v| v.nil? || Array(v).empty? }
+        client.post("/projects/#{project}/sections/insert", body: with_params, options: options) && true
+      end
+
+    end
+  end
+end

data/lib/asana/resources/story.rb

@@ -19,18 +19,31 @@ module Asana
 
       attr_reader :created_by
 
+      # DEPRECATED: prefer "liked"
       attr_reader :hearted
 
+      # DEPRECATED: prefer "likes"
       attr_reader :hearts
 
+      # DEPRECATED: prefer "num_likes"
       attr_reader :num_hearts
 
+      attr_reader :liked
+
+      attr_reader :likes
+
+      attr_reader :num_likes
+
       attr_reader :text
 
       attr_reader :html_text
 
       attr_reader :target
 
+      attr_reader :is_pinned
+
+      attr_reader :is_edited
+
       attr_reader :source
 
       attr_reader :type
@@ -79,6 +92,27 @@ module Asana
         end
       end
 
+      # Updates the story and returns the full record for the updated story.
+      # Only comment stories can have their text updated, and only comment stories and
+      # attachment stories can be pinned. Only one of `text` and `html_text` can be specified.
+      #
+      # text - [String] The plain text with which to update the comment.
+      #
+      # html_text - [String] The rich text with which to update the comment.
+      # is_pinned - [Boolean] Whether the story should be pinned on the resource.
+      # options - [Hash] the request I/O options.
+      # 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)
+      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
+      end
+
     end
   end
-end
+end

data/lib/asana/resources/tag.rb

@@ -23,8 +23,6 @@ module Asana
 
       attr_reader :color
 
-      attr_reader :notes
-
       attr_reader :workspace
 
       class << self
@@ -139,4 +137,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/task.rb

@@ -28,6 +28,10 @@ module Asana
 
       attr_reader :custom_fields
 
+      attr_reader :dependencies
+
+      attr_reader :dependents
+
       attr_reader :due_on
 
       attr_reader :due_at
@@ -36,22 +40,33 @@ module Asana
 
       attr_reader :followers
 
+      # DEPRECATED: prefer "liked"
       attr_reader :hearted
 
+      # DEPRECATED: prefer "likes"
       attr_reader :hearts
 
+      attr_reader :liked
+
+      attr_reader :likes
+
       attr_reader :modified_at
 
       attr_reader :name
 
       attr_reader :notes
 
+      # DEPRECATED: prefer "num_likes"
       attr_reader :num_hearts
 
+      attr_reader :num_likes
+
       attr_reader :projects
 
       attr_reader :parent
 
+      attr_reader :start_on
+
       attr_reader :workspace
 
       attr_reader :memberships
@@ -129,12 +144,23 @@ module Asana
           Collection.new(parse(client.get("/tags/#{tag}/tasks", params: params, options: options)), type: self, client: client)
         end
 
+        # <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.
+        # 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: {})
+          params = { limit: per_page }.reject { |_,v| v.nil? || Array(v).empty? }
+          Collection.new(parse(client.get("/sections/#{section}/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`.
         #
         # 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.
         # completed_since - [String] Only return tasks that are either incomplete or that have been
         # completed since this time.
@@ -147,6 +173,8 @@ 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.
         #
         # A task is considered "modified" if any of its properties change,
@@ -155,10 +183,20 @@ module Asana
         # 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, workspace: nil, completed_since: nil, modified_since: nil, per_page: 20, options: {})
-          params = { assignee: assignee, project: project, 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, 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? }
           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.
+        # 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? }
+          Collection.new(parse(client.get("/workspaces/#{workspace}/tasks/search", params: params, options: options)), type: Resource, client: client)
+        end
       end
 
       # A specific, existing task can be updated by making a PUT request on the
@@ -189,6 +227,64 @@ module Asana
         client.delete("/tasks/#{id}") && true
       end
 
+      # Returns the compact representations of all of the dependencies of a task.
+      #
+      # options - [Hash] the request I/O options.
+      def dependencies(options: {})
+
+        Resource.new(parse(client.get("/tasks/#{id}/dependencies", options: options)).first, client: client)
+      end
+
+      # Returns the compact representations of all of the dependents of a task.
+      #
+      # options - [Hash] the request I/O options.
+      def dependents(options: {})
+
+        Resource.new(parse(client.get("/tasks/#{id}/dependents", options: options)).first, client: client)
+      end
+
+      # Marks a set of tasks as dependencies of this task, if they are not
+      # already dependencies. *A task can have at most 15 dependencies.*
+      #
+      # dependencies - [Array] An array of task IDs that this task should depend on.
+      # options - [Hash] the request I/O options.
+      # 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)
+      end
+
+      # Marks a set of tasks as dependents of this task, if they are not already
+      # dependents. *A task can have at most 30 dependents.*
+      #
+      # dependents - [Array] An array of task IDs that should depend on this task.
+      # options - [Hash] the request I/O options.
+      # 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)
+      end
+
+      # Unlinks a set of dependencies from this task.
+      #
+      # dependencies - [Array] An array of task IDs to remove as dependencies.
+      # options - [Hash] the request I/O options.
+      # 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)
+      end
+
+      # Unlinks a set of dependents from this task.
+      #
+      # dependents - [Array] An array of task IDs to remove as dependents.
+      # options - [Hash] the request I/O options.
+      # 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)
+      end
+
       # Adds each of the specified followers to the task, if they are not already
       # following. Returns the complete, updated record for the affected task.
       #
@@ -222,11 +318,17 @@ module Asana
 
       # Adds the task to the specified project, in the optional location
       # specified. If no location arguments are given, the task will be added to
-      # the beginning of the project.
+      # the end of the project.
       #
-      # `addProject` can also be used to reorder a task within a project that
+      # `addProject` can also be used to reorder a task within a project or section that
       # already contains it.
       #
+      # At most one of `insert_before`, `insert_after`, or `section` should be
+      # specified. Inserting into a section in an non-order-dependent way can be
+      # done by specifying `section`, otherwise, to insert within a section in a
+      # particular place, specify `insert_before` or `insert_after` and a task
+      # within the section to anchor the position of this task.
+      #
       # Returns an empty data block.
       #
       # project - [Id] The project to add the task to.
@@ -237,7 +339,7 @@ module Asana
       # insert at the end of the list.
       #
       # section - [Id] A section in the project to insert the task into. The task will be
-      # inserted at the top of the section.
+      # inserted at the bottom of the section.
       #
       # options - [Hash] the request I/O options.
       # data - [Hash] the attributes to post.
@@ -308,13 +410,21 @@ module Asana
       end
 
       # Changes the parent of a task. Each task may only be a subtask of a single
-      # parent, or no parent task at all. Returns an empty data block.
+      # parent, or no parent task at all. Returns an empty data block. When using `insert_before` and `insert_after`,
+      # 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
+      # insert at the beginning of the list.
+      #
+      # insert_before - [Id] 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"), options: {}, **data)
-        with_params = data.merge(parent: parent).reject { |_,v| v.nil? || Array(v).empty? }
+      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
       end
 
@@ -343,4 +453,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/team.rb

@@ -96,4 +96,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/user.rb

@@ -74,4 +74,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/webhook.rb

@@ -134,4 +134,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/resources/workspace.rb

@@ -73,7 +73,8 @@ module Asana
       # result set is limited to a single page of results with a maximum size,
       # so you won't be able to fetch large numbers of results.
       #
-      # type - [Enum] The type of values the typeahead should return.
+      # type - [Enum] The type of values the typeahead should return. You can choose from
+      # one of the following: custom_field, project, tag, task, and user.
       # Note that unlike in the names of endpoints, the types listed here are
       # in singular form (e.g. `task`). Using multiple types is not yet supported.
       #
@@ -122,4 +123,4 @@ module Asana
 
     end
   end
-end
+end

data/lib/asana/version.rb

@@ -1,5 +1,5 @@
 #:nodoc:
 module Asana
   # Public: Version of the gem.
-  VERSION = '0.6.3'.freeze
+  VERSION = '0.8.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: asana
 version: !ruby/object:Gem::Version
-  version: 0.6.3
+  version: 0.8.0
 platform: ruby
 authors:
 - Txus
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-02-09 00:00:00.000000000 Z
+date: 2018-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth2
@@ -183,7 +183,11 @@ files:
 - lib/asana/resources/attachment.rb
 - lib/asana/resources/custom_field_settings.rb
 - lib/asana/resources/custom_fields.rb
+- lib/asana/resources/organization_export.rb
 - lib/asana/resources/project.rb
+- lib/asana/resources/project_membership.rb
+- lib/asana/resources/project_status.rb
+- lib/asana/resources/section.rb
 - lib/asana/resources/story.rb
 - lib/asana/resources/tag.rb
 - lib/asana/resources/task.rb
@@ -216,7 +220,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.5
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: Official Ruby client for the Asana API