insightly2 0.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4042e33e70605bd4800030d09a4fce688cfb66fe
+  data.tar.gz: de8a94d18de1cfb5b3cbdd687cee6e22e83ac26d
+SHA512:
+  metadata.gz: b9bc887e4711454f4740e04da84a8132be583a6148ce539e561cd6f5c3554ee63e89478845c500f621f656dba9c60fdeb9915b49eac0cb7ee5f882703cb9e5eb
+  data.tar.gz: 73beb7c63bd6af0ae1ad06f9063c84c2927d7ca6d3634afead77eec2664e5b882448089a5c7794917050ab3570c4d89c5286cb2587cbe56b7580a5288c5f2580

data/.gitignore

@@ -0,0 +1,17 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.idea/
+*.bundle
+*.so
+*.o
+*.a
+*.gem
+mkmf.log
+/config/gem_secret.yml

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3-p547
+  - 2.1.2
+  - 2.0.0-p481

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in insightly.gemspec
+gemspec

data/README.md

@@ -0,0 +1,113 @@
+# Insightly2
+
+Ruby Library for the Insightly REST API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'insightly2'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install insightly2
+    
+The gem requires Ruby 2.0.0 and above.    
+
+## Sample Code
+
+Set client the API key.
+```ruby
+Insightly2.api_key = <your API key>
+```
+
+Get contacts.
+```ruby
+contacts = Insightly2.client.get_contacts
+```
+
+Get a contact.
+```ruby
+contact = Insightly2.client.get_contact(id: 1)
+```
+
+Create a contact.
+
+```ruby
+# Build JSON serialized attributes.
+# The gem won't do this for you. You need to build a serializer that meets your needs."
+contact_attributes = {
+  "first_name"=>"Tyler", 
+  "last_name"=>"Durden", 
+  "image_url"=>"https://fakedomain.imgix.net/user_photos/man.jpg?crop=faces&fit=crop&h=96&w=96", 
+  "contactinfos"=>[{"contact_id"=>0, "type"=>"Email", "subtype"=>"", "label"=>"Work", "detail"=>"tylerdurden@ucsv.edu"}], 
+  "links"=>[], 
+  "tags"=>[], 
+  "date_created_utc"=>"2014-10-11 23:20:04", 
+  "date_updated_utc"=>"2014-10-23 17:27:25", 
+  "contact_id"=>81126408
+}
+
+# Create the contact.
+contact = Insightly2.client.create_contact(contact: contact_attributes)
+```
+
+Update a contact.
+```ruby
+# Build JSON serialized attributes.
+# The gem won't do this for you. You need to build a serializer that meets your needs."
+# contact_attributes = <same as create>
+
+# Update the contact.
+contact = Insightly2.client.update_contact(contact: contact_attributes)
+```
+
+Delete a contact.
+```ruby
+Insightly2.client.delete_contact(id: 1)
+```
+
+## Error handling
+
+The client will raise an ```Insightly2::Errors::ClientError``` if the action failed or
+an ```Insightly2::Errors::ResourceNotFoundError``` if the target resource cannot be found in the API.
+
+Depending on your implementation you may want to rescue these errors as follows:
+
+```ruby
+begin
+  Insightly2.client.delete_contact(id: 1)
+rescue Insightly2::Errors::ResourceNotFoundError => e
+  Rails.logger.error "Insightly contact not found: #{e.response}"
+rescue Insightly2::Errors::ClientError => e
+  Rails.logger.error "Insightly contact delete failed: #{e.response}"
+end
+```    
+If you don't care whether or not the resource is found you can simply do the following:
+
+```ruby
+begin
+  Insightly2.client.delete_contact(id: 1)
+rescue Insightly2::Errors::ClientError => e
+  Rails.logger.error "Insightly contact delete failed: #{e.response}"
+end
+```
+This will also catch ```Insightly2::Errors::ResourceNotFoundError``` but is less specific.
+
+## API docs
+
+[Insightly API Documentation](https://api.insight.ly/v2.1/Help)
+
+## Contributing
+
+1. Fork it ( https://github.com/insightly/ruby/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/config/gem_secret.yml.example

@@ -0,0 +1 @@
+insightly_api_key: 'YOUR TESTING API KEY GOES HERE'

data/insightly2.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'insightly2/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'insightly2'
+  spec.version       = Insightly2::VERSION
+  spec.authors       = ['Alexander Semyonov', 'Michael Kompanets', 'David Iorns']
+  spec.email         = ['al@semyonov.us', 'michael@scienceexchange.com', 'david@scienceexchange.com']
+  spec.summary       = 'A Ruby wrapper for the Insightly v2.1 API https://api.insight.ly/v2.1/Help'
+  spec.homepage      = 'https://github.com/insightly/ruby'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_dependency 'faraday'
+  spec.add_dependency 'activesupport'
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0.0'
+  spec.add_development_dependency 'webmock', '~> 1.18.0'
+  spec.add_development_dependency 'vcr'
+end

data/lib/insightly2/client.rb

@@ -0,0 +1,54 @@
+require 'faraday'
+require 'json'
+require 'openssl'
+require 'active_support/all'
+require 'insightly2/dsl'
+require 'insightly2/errors'
+
+module Insightly2
+  class Client
+    include DSL
+    include Errors
+
+    URL = 'https://api.insight.ly/v2.1/'
+    REQUESTS = [:get, :post, :put, :delete]
+    HEADERS = {'Accept' => 'application/json', 'Content-Type' => 'application/json'}
+
+    # @param [String] api_key
+    def initialize(api_key = Insightly2.api_key)
+      @api_key = api_key
+
+      # Setup HTTP request connection to insightly.
+      @connection ||= Faraday.new do |builder|
+        builder.basic_auth @api_key, ''
+        builder.request :url_encoded
+        builder.response :logger if Insightly2.logger
+        builder.adapter Faraday.default_adapter
+      end
+    end
+
+    # @param [:get, :post, :put, :delete] method.
+    # @param [String] path.
+    # @param [Hash] query (optional).
+    # @param [Hash] headers request headers (optional).
+    # @raise [ArgumentError] If the response is blank.
+    # @raise [ResourceNotFoundError] If the response code is 404.
+    # @raise [ClientError] If the response code is not in the success range.
+    # @return [Faraday::Response] server response.
+    def request(method, path, query = {}, headers = HEADERS)
+      raise ArgumentError, "Unsupported method #{method.inspect}. Only :get, :post, :put, :delete are allowed" unless REQUESTS.include?(method)
+
+      payload = !query.empty? ? JSON.generate(query) : ''
+      response = @connection.run_request(method, "#{URL}#{path}", payload, headers)
+
+      case response.status.to_i
+        when 200..299
+          return response
+        when 404
+          raise ResourceNotFoundError.new(response: response)
+        else
+          raise ClientError.new(response: response)
+      end
+    end
+  end
+end

data/lib/insightly2/dsl/comments.rb

@@ -0,0 +1,47 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::Comments
+    # GET /v2.1/Comments/{id}
+    # Get a comment.
+    # @param [String, Fixnum] id A comment's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Comment, nil].
+    def get_comment(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Comment.parse(request(:get, "Comments/#{id}"))
+    end
+
+    # POST /v2.1/Comments?c_id={c_id}&filename={filename}
+    # Adds a file attachment to a comment.
+    # @param [String, Fixnum] id A comment's ID.
+    # @param [String] filename The name of the attachment.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def create_comment_attachment(id:, filename:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      raise ArgumentError, "Filename cannot be blank" if filename.blank?
+      request(:post, "Comments/?c_id=#{id}&filename=#{filename}")
+    end
+
+    # PUT /v2.1/Comments
+    # Updates a comment.
+    # @param [Hash] comment The comment to update.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Comment, nil].
+    def update_comment(comment:)
+      raise ArgumentError, "Comment cannot be blank" if comment.blank?
+      Resources::Comment.parse(request(:put, "Comments", comment))
+    end
+
+    # DELETE /v2.1/Comments/{id}
+    # Deletes a comment.
+    # @param [String, Fixnum] id A comment's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def delete_comment(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:delete, "Comments/#{id}")
+    end
+  end
+end

data/lib/insightly2/dsl/contacts.rb

@@ -0,0 +1,130 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::Contacts
+    # GET /v2.1/Contacts/{id}
+    # Gets a contact by id.
+    # @param [String, Fixnum] id The ID of the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Contact, nil].
+    def get_contact(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Contact.parse(request(:get, "Contacts/#{id}"))
+    end
+
+    # GET /v2.1/Contacts/{c_id}/Emails
+    # Gets a contact's emails.
+    # @param [id:] id of the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Array, nil].
+    def get_contact_emails(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Email.parse(request(:get, "Contacts/#{id}/Emails"))
+    end
+
+    # GET /v2.1/Contacts/{c_id}/Image
+    # Gets a contact's image.
+    # @param [String, Fixnum] id The ID of the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def get_contact_image(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:get, "Contacts/#{id}/Image")
+    end
+
+    # GET /v2.1/Contacts/{c_id}/Notes
+    # Gets a contact's notes.
+    # @param [String, Fixnum] id The ID of the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Array, nil].
+    def get_contact_notes(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Note.parse(request(:get, "Contacts/#{id}/Notes"))
+    end
+
+    # GET /v2.1/Contacts/{c_id}/Tasks
+    # Gets a contact's tasks.
+    # @param [String, Fixnum] id The ID of the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Array, nil].
+    def get_contact_tasks(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Task.parse(request(:get, "Contacts/#{id}/Tasks"))
+    end
+
+    # GET /v2.1/Contacts?ids={ids}&email={email}&tag={tag}
+    # Get a list of contacts.
+    # @param [Array] ids The contact ids of the contacts to return (optional).
+    # @param [String] email The email address of the contact to return (optional).
+    # @param [String] tag The tag that has been applied to contacts (optional).
+    # @return [Array, nil].
+    def get_contacts(ids: [], email: '', tag: '')
+      url = Utils::UrlHelper.build_url(path: "Contacts", params: {ids: ids.join(','), email: email, tag: tag})
+      Resources::Contact.parse(request(:get, url))
+    end
+
+    # POST /v2.1/Contacts
+    # Creates a contact.
+    # @param [Hash] contact The contact to create.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Contact, nil].
+    def create_contact(contact:)
+      raise ArgumentError, "Contact cannot be blank" if contact.blank?
+      Resources::Contact.parse(request(:post, "Contacts", contact))
+    end
+
+    # POST /v2.1/Contacts/{c_id}/Image/{filename}
+    # Adds a contact's image.
+    # @param [String, Fixnum] id The ID of the contact.
+    # @param [String] filename The name of image file to be attached to the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def create_contact_image(id:, filename:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      raise ArgumentError, "Filename cannot be blank" if filename.blank?
+      request(:post, "Contacts/#{id}/Image/#{filename}")
+    end
+
+    # PUT /v2.1/Contacts
+    # Updates a contact.
+    # @param [Hash] contact The contact to update.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Contact, nil].
+    def update_contact(contact:)
+      raise ArgumentError, "Contact cannot be blank" if contact.blank?
+      Resources::Contact.parse(request(:put, "Contacts", contact))
+    end
+
+    # PUT /v2.1/Contacts/{c_id}/Image/{filename}
+    # Updates a contact's image.
+    # @param [String, Fixnum] id The ID of the contact.
+    # @param [String] filename The name of image file to be attached to the contact.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def update_contact_image(id:, filename:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      raise ArgumentError, "Filename cannot be blank" if filename.blank?
+      request(:put, "Contacts/#{id}/Image/#{filename}")
+    end
+
+    # DELETE /v2.1/Contacts/{id}
+    # Deletes a contact.
+    # @param [String, Fixnum] id The ID of the contact to delete.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def delete_contact(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:delete, "Contacts/#{id}")
+    end
+
+    # DELETE /v2.1/Contacts/{c_id}/Image
+    # Deletes a contact's image.
+    # @param [String, Fixnum] id The ID of the contact with the image to delete.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def delete_contact_image(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:delete, "Contacts/#{id}/Image")
+    end
+  end
+end

data/lib/insightly2/dsl/countries.rb

@@ -0,0 +1,12 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::Countries
+    # GET /v2.1/Countries
+    # Get a list of countries.
+    # @return [Array, nil].
+    def get_countries
+      Resources::Country.parse(request(:get, "Countries"))
+    end
+  end
+end

data/lib/insightly2/dsl/currencies.rb

@@ -0,0 +1,12 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::Currencies
+    # GET /v2.1/Currencies
+    # Get a list of currencies.
+    # @return [Array, nil].
+    def get_currencies
+      Resources::Currency.parse(request(:get, "Currencies"))
+    end
+  end
+end

data/lib/insightly2/dsl/custom_fields.rb

@@ -0,0 +1,22 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::CustomFields
+    # GET /v2.1/CustomFields/{id}
+    # Get a custom field.
+    # @param [String, Fixnum] id A CustomField's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::CustomField, nil].
+    def get_custom_field(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::CustomField.parse(request(:get, "CustomFields/#{id}"))
+    end
+
+    # GET /v2.1/CustomFields
+    # Get a list of custom fields.
+    # @return [Array, nil].
+    def get_custom_fields
+      Resources::CustomField.parse(request(:get, "CustomFields"))
+    end
+  end
+end

data/lib/insightly2/dsl/emails.rb

@@ -0,0 +1,57 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::Emails
+    # GET /v2.1/Emails/{id}
+    # Gets an email.
+    # @param [String, Fixnum] id The ID of the email.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Email, nil]
+    def get_email(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Email.parse(request(:get, "Emails/#{id}"))
+    end
+
+    # GET /v2.1/Emails/{c_id}/Comments
+    # Gets an email's comments.
+    # @param [String, Fixnum] id The ID of the email.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Array, nil].
+    def get_email_comments(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Comment.parse(request(:get, "Emails/#{id}/Comments"))
+    end
+
+    # GET /v2.1/Emails?ids={ids}&tag={tag}
+    # Gets a list of Emails.
+    # @param [Array] ids The list of email IDs (optional).
+    # @param [String] tag Emails tagged with this tag (optional).
+    # @return [Array, nil].
+    def get_emails(ids: [], tag: '')
+      url = Utils::UrlHelper.build_url(path: "Emails", params: {ids: ids.join(','), tag: tag})
+      Resources::Email.parse(request(:get, url))
+    end
+
+    # POST /v2.1/Emails/{c_id}/Comments
+    # Create a comment for a task.
+    # @param [String, Fixnum] id A task's ID.
+    # @param [Hash] comment The comment to create.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def create_email_comment(id:, comment:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      raise ArgumentError, "Comment cannot be blank" if comment.blank?
+      request(:post, "Emails/#{id}/Comments", comment)
+    end
+
+    # DELETE /v2.1/Emails/{id}
+    # Deletes an email.
+    # @param [String, Fixnum] id The ID of the email to delete.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def delete_email(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:delete, "Emails/#{id}")
+    end
+  end
+end

data/lib/insightly2/dsl/events.rb

@@ -0,0 +1,52 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::Events
+    # GET /v2.1/Events/{id}
+    # Get an event.
+    # @param [String, Fixnum] id An event's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Event, nil].
+    def get_event(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::Event.parse(request(:get, "Events/#{id}"))
+    end
+
+    # GET /v2.1/Events
+    # Get a list of events.
+    # @return [Insightly2::Resources::Event, nil]
+    def get_events
+      Resources::Event.parse(request(:get, "Events"))
+    end
+
+    # POST /v2.1/Events
+    # Create an event.
+    # @param [Hash] event The event to create.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Event, nil]
+    def create_event(event:)
+      raise ArgumentError, "Event cannot be blank" if event.blank?
+      Resources::Event.parse(request(:post, "Events", event))
+    end
+
+    # PUT /v2.1/Events
+    # Update an event.
+    # @param [Hash] event The event to update.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::Event, nil]
+    def update_event(event:)
+      raise ArgumentError, "Event cannot be blank" if event.blank?
+      Resources::Event.parse(request(:put, "Events", event))
+    end
+
+    # DELETE /v2.1/Events/{id}
+    # Delete an event.
+    # @param [String, Fixnum] id An event's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def delete_event(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:delete, "Events/#{id}")
+    end
+  end
+end

data/lib/insightly2/dsl/file_attachments.rb

@@ -0,0 +1,14 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::FileAttachments
+    # GET /v2.1/FileAttachments/{id}
+    # @param [String, Fixnum] id A file attachment's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def get_file_attachment(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:get, "FileAttachments/#{id}")
+    end
+  end
+end

data/lib/insightly2/dsl/file_categories.rb

@@ -0,0 +1,52 @@
+require 'insightly2/dsl'
+
+module Insightly2
+  module DSL::FileCategories
+    # GET /v2.1/FileCategories/{id}
+    # Get a file category.
+    # @param [String, Fixnum] id: A file category's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::FileCategory, nil].
+    def get_file_category(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      Resources::FileCategory.parse(request(:get, "FileCategories/#{id}"))
+    end
+
+    # GET /v2.1/FileCategories
+    # Get a list of file categories.
+    # @return [Array, nil].
+    def get_file_categories
+      Resources::FileCategory.parse(request(:get, "FileCategories"))
+    end
+
+    # POST /v2.1/FileCategories
+    # Create a file category.
+    # @param [Hash] category: File Category attributes.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::FileCategory, nil].
+    def create_file_category(category:)
+      raise ArgumentError, "Category cannot be blank" if category.blank?
+      Resources::FileCategory.parse(request(:post, "FileCategories", category))
+    end
+
+    # PUT /v2.1/FileCategories
+    # Update a file category.
+    # @param [Hash] category: File Category attributes.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Insightly2::Resources::FileCategory].
+    def update_file_category(category:)
+      raise ArgumentError, "Category cannot be blank" if category.blank?
+      Resources::FileCategory.parse(request(:put, "FileCategories", category))
+    end
+
+    # DELETE /v2.1/FileCategories/{id}
+    # Delete a file category.
+    # @param [String, Fixnum] id: A file category's ID.
+    # @raise [ArgumentError] If the method arguments are blank.
+    # @return [Faraday::Response].
+    def delete_file_category(id:)
+      raise ArgumentError, "ID cannot be blank" if id.blank?
+      request(:delete, "FileCategories/#{id}")
+    end
+  end
+end