nationbuilder-rb 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 83841921d09006469ddc14f13acb12e99ba87277
+  data.tar.gz: 35766c21dbb833903cd33d27ebdd1b4ecebbcf1d
+SHA512:
+  metadata.gz: 92dbc9527dbb3162b1c6303e21248e7d708bb53508e62e70b8c6a53e272cd87f81b9878315c77e3bd71a3d55b425c4772bc5daf7aeaf21f9b9b27e7fa1aaf894
+  data.tar.gz: 4ebd640859fa7673ed3f129de176600af1fcaff2c3ce62ebd5b10396fe567d7a84178c8d75205622b4de972ef85ab9366e40ffec7ad0e3ce692c310f5fdd16bb

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/.ruby-gemset

@@ -0,0 +1 @@
+nationbuilder-rb

data/Gemfile

@@ -0,0 +1,11 @@
+source 'http://rubygems.org'
+
+gem 'httpclient', '~> 2.4.0'
+
+group :development do
+  gem 'jeweler', '~> 2.0.1'
+  gem 'rspec', '~> 2.8.0'
+  gem 'simplecov', '~> 0.8.2'
+  gem 'vcr', '~> 2.9.2'
+  gem 'webmock', '~> 1.18.0'
+end

data/Gemfile.lock

@@ -0,0 +1,82 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.3.6)
+    builder (3.2.2)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.1.3)
+    docile (1.1.5)
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    git (1.2.7)
+    github_api (0.11.3)
+      addressable (~> 2.3)
+      descendants_tracker (~> 0.0.1)
+      faraday (~> 0.8, < 0.10)
+      hashie (>= 1.2)
+      multi_json (>= 1.7.5, < 2.0)
+      nokogiri (~> 1.6.0)
+      oauth2
+    hashie (3.1.0)
+    highline (1.6.21)
+    httpclient (2.4.0)
+    jeweler (2.0.1)
+      builder
+      bundler (>= 1.0)
+      git (>= 1.2.5)
+      github_api
+      highline (>= 1.6.15)
+      nokogiri (>= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (1.0.0)
+    mini_portile (0.6.0)
+    multi_json (1.10.1)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    nokogiri (1.6.2.1)
+      mini_portile (= 0.6.0)
+    oauth2 (0.9.4)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.3.2)
+    rdoc (4.1.1)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    safe_yaml (1.0.3)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    thread_safe (0.3.4)
+    vcr (2.9.2)
+    webmock (1.18.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  httpclient (~> 2.4.0)
+  jeweler (~> 2.0.1)
+  rspec (~> 2.8.0)
+  simplecov (~> 0.8.2)
+  vcr (~> 2.9.2)
+  webmock (~> 1.18.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2014 NationBuilder.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,103 @@
+# nationbuilder-rb
+
+A Ruby client for the NationBuilder API.
+
+## Installing
+
+To install this gem to your current gemset, run:
+
+```shell
+$ gem install nationbuilder-rb
+```
+
+Or, add this to your gemfile:
+
+```ruby
+gem 'nationbuilder-rb'
+```
+
+## Creating a client
+
+Require the gem:
+
+```ruby
+require 'nationbuilder'
+```
+
+Then, create a client by specifying the name of your nation and
+your API token:
+
+```ruby
+client = NationBuilder::Client.new('my_nation_name', 'my_api_token')
+```
+
+## Calling the API
+
+There is only a single method for calling the NationBuilder API in
+`nationbuilder-rb`, and that's the `#call` method on a client. The
+`#call` method takes three parameters: the name of the endpoint,
+the name of the method, and an optional hash containing arguments
+for the method.
+
+## Examples
+
+### Fetching a person
+
+```ruby
+client.call(:people, :show, id: 15)
+```
+
+### Creating a person
+
+```ruby
+params = {
+  person: {
+    email: "bob@example.com",
+    last_name: "Smith",
+    first_name: "Bob"
+  }
+}
+
+client.call(:people, :create, params)
+```
+
+### Destroying a person
+
+```ruby
+client.call(:people, :destroy, id: 15)
+```
+
+## Documentation
+
+This gem includes a command line utility that prints out
+all covered endpoints, methods, and parameters. To see
+documentation for a single endpoint, run:
+
+```shell
+$ nbdoc ENDPOINT_NAME
+```
+
+To see all documentation, don't provide a endpoint name:
+
+```shell
+$ nbdoc
+```
+
+### Example
+
+```
+$ nbdoc basic_pages
+
+=====================
+Endpoint: basic_pages
+=====================
+
+  Method: :index
+  Description: Shows a list of the basic pages in the system
+  Required parameters: :site_slug
+
+  Method: :create
+  Description: Creates a basic page for a site
+  Required parameters: :site_slug
+...
+```

data/Rakefile

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'rake'
+require 'jeweler'
+
+Jeweler::Tasks.new do |gem|
+  gem.name = 'nationbuilder-rb'
+  gem.homepage = 'http://github.com/3dna/nationbuilder-rb'
+  gem.license = 'MIT'
+  gem.summary = 'A Ruby client to the NationBuilder API'
+  gem.description = 'A Ruby client to the NationBuilder API'
+  gem.email = 'david@nationbuilder.com'
+  gem.authors = ['David Huie']
+end
+
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+desc 'Code coverage detail'
+task :simplecov do
+  ENV['COVERAGE'] = '1'
+  Rake::Task['spec'].execute
+end
+
+task default: :spec

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/nbdoc

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+# Prints out a description of all NationBuilder API endpoints.
+
+require 'nationbuilder'
+
+endpoint = ARGV.shift
+client = NationBuilder::Client.new('test-nation', 'test-key')
+
+if endpoint
+  client.print_description(endpoint)
+else
+  client.print_all_descriptions
+end

data/lib/nationbuilder.rb

@@ -0,0 +1,24 @@
+require 'httpclient'
+require 'json'
+require 'set'
+require 'uri'
+
+module NationBuilder
+
+  URL_TEMPLATE = 'https://:nation_name.nationbuilder.com'
+
+  def self.generate_url(base_url, extension, parameters)
+    url = URI.join(base_url, '/api/v1' + extension).to_s
+    parameters.each do |name, value|
+      url.gsub!(name.inspect, value.to_s)
+    end
+    url
+  end
+
+end
+
+require 'nationbuilder/client'
+require 'nationbuilder/endpoint'
+require 'nationbuilder/method'
+require 'nationbuilder/parameter'
+require 'nationbuilder/spec_parser'

data/lib/nationbuilder/api_spec.json

@@ -0,0 +1,2151 @@
+{
+  "endpoints": [
+    {
+      "name": "Basic Pages",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Shows a list of the basic pages in the system",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/basic_pages",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the basic page"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a basic page for a site",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/basic_pages",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the basic page"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the new basic page"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates the attributes of a basic page",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/basic_pages/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the basic page"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the basic page"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "JSON containing updates"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes a basic page",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/basic_pages/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the basic page"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the basic page"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Blogs",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Shows a list of all blogs",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/blogs",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Show",
+          "Synopsis": "Show the details of a blog",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/blogs/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a new blog",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/blogs",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "json",
+              "Description": "a JSON representation of the new blog"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates the attributes of a blog",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/blogs/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "json",
+              "Description": "JSON containing updates"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes a blog",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/blogs/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Blog Posts",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Shows a list of blog's posts",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/blogs/:id/posts",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Match",
+          "Synopsis": "Find a blog post by its external id",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/blogs/:id/match",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "external_id",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "the external id of the post"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a new blog post",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/blogs/:blog_id/posts",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "blog_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "json",
+              "Description": "a JSON representation of the new post"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates the attributes of a blog post",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/blogs/:blog_id/posts/:blog_post_id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "blog_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "blog_post_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "json",
+              "Description": "JSON containing updates"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes a blog post",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/blogs/:blog_id/posts/:blog_post_id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the blog"
+            },
+            {
+              "Name": "blog_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            },
+            {
+              "Name": "blog_post_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the blog"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Calendars",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Shows a list of calendars",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/calendars",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the calendars"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Show",
+          "Synopsis": "Show the details of a calendar",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/calendars/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the calendar"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the calendar"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a new calendar",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/calendars",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the calendar"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "json",
+              "Description": "a JSON representation of the new calendar"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates the attributes of a calendar",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/calendars/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the calendar"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the calendar"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "json",
+              "Description": "JSON containing updates"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes a calendar",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/calendars/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the calendar"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the calendar"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Campaign Data",
+      "methods": [
+        {
+          "MethodName": "Show",
+          "Synopsis": "Shows campaign metadata about the nation",
+          "HTTPMethod": "GET",
+          "URI": "/campaign_data",
+          "parameters": [
+
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Contacts",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "View a paginated list of a person's contacts",
+          "HTTPMethod": "GET",
+          "URI": "/people/:person_id/contacts",
+          "parameters": [
+            {
+              "Name": "person_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the person's ID"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Record a contact for a person",
+          "HTTPMethod": "POST",
+          "URI": "/people/:person_id/contacts",
+          "parameters": [
+            {
+              "Name": "person_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the person's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the new contact"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Contact Types",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns paginated list of nation-defined contact types",
+          "HTTPMethod": "GET",
+          "URI": "/settings/contact_types",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a new contact type",
+          "HTTPMethod": "POST",
+          "URI": "/settings/contact_types",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the new contact type"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates an existing contact type",
+          "HTTPMethod": "PUT",
+          "URI": "/settings/contact_types/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the existing contact type"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the updates to make"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Destroys a contact type",
+          "HTTPMethod": "DELETE",
+          "URI": "/settings/contact_types/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the existing contact type"
+            }
+          ]
+        },
+        {
+          "MethodName": "List Methods",
+          "Synopsis": "Lists all contact methods",
+          "HTTPMethod": "GET",
+          "URI": "/settings/contact_methods",
+          "parameters": [
+
+          ]
+        },
+        {
+          "MethodName": "List Statuses",
+          "Synopsis": "Lists all contact status types",
+          "HTTPMethod": "GET",
+          "URI": "/settings/contact_statuses",
+          "parameters": [
+
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Donations",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of donations",
+          "HTTPMethod": "GET",
+          "URI": "/donations",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a donation with the provided data",
+          "HTTPMethod": "POST",
+          "URI": "/donations",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON representation of a donation"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates a donation with the provided data",
+          "HTTPMethod": "PUT",
+          "URI": "/donations/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The donation's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON attributes for updating the donation"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes the donation with the matching ID",
+          "HTTPMethod": "DELETE",
+          "URI": "/donations/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The donation's ID"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Events",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of events",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/events",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            },
+            {
+              "Name": "tags",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": "tags that must be present on the event"
+            },
+            {
+              "Name": "starting",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": "earliest starting time"
+            },
+            {
+              "Name": "until",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": "latest ending time"
+            },
+            {
+              "Name": "calendar_id",
+              "Required": "N",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the calendar from which events should be scoped"
+            }
+          ]
+        },
+        {
+          "MethodName": "Show",
+          "Synopsis": "Returns an event",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/events/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the event"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a event with the provided data",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/events",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON representation of a event"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates a event with the provided data",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/events/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The event's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON attributes for updating the event"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes the event with the matching ID",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/events/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The event's ID"
+            }
+          ]
+        },
+        {
+          "MethodName": "RSVPs",
+          "Synopsis": "Lists all RSVPs for an event",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/events/:id/rsvps",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The event's ID"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "RSVP Create",
+          "Synopsis": "Creates an RSVP for an event",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/events/:id/rsvps",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The event's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "A JSON representation of the new post"
+            }
+          ]
+        },
+        {
+          "MethodName": "RSVP Update",
+          "Synopsis": "Updates an existing RSVP",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/events/:event_id/rsvps/:rsvp_id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the event"
+            },
+            {
+              "Name": "event_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The event's ID"
+            },
+            {
+              "Name": "rsvp_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The RSVP's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "JSON attributes for updating the RSVP"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Imports",
+      "methods": [
+        {
+          "MethodName": "Show",
+          "Synopsis": "Shows the status of an import",
+          "HTTPMethod": "GET",
+          "URI": "/imports/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the import"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a import with the provided data",
+          "HTTPMethod": "POST",
+          "URI": "/imports",
+          "parameters": [
+            {
+              "Name": "type",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "either \"voter_file\" or \"voting_history\""
+            },
+            {
+              "Name": "file",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "Base 64 (RFC 4648) encoded version of a CSV"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Lists",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of created custom lists",
+          "HTTPMethod": "GET",
+          "URI": "/lists",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "People",
+          "Synopsis": "Returns people stored in a list",
+          "HTTPMethod": "GET",
+          "URI": "/lists/:id/people",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The list's ID"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a list with the provided data",
+          "HTTPMethod": "POST",
+          "URI": "/lists",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON representation of the list to create"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates a list with the provided data",
+          "HTTPMethod": "PUT",
+          "URI": "/lists/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The list's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON attributes for updating the list"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes the list with the matching ID",
+          "HTTPMethod": "DELETE",
+          "URI": "/lists/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The list's ID"
+            }
+          ]
+        },
+        {
+          "MethodName": "Listing Create",
+          "Synopsis": "Adds a person to a list",
+          "HTTPMethod": "POST",
+          "URI": "/lists/:list_id/listings",
+          "parameters": [
+            {
+              "Name": "list_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the list"
+            },
+            {
+              "Name": "person_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the person to add to the list"
+            }
+          ]
+        },
+        {
+          "MethodName": "Listing Deletion",
+          "Synopsis": "Drops a person from a list",
+          "HTTPMethod": "DELETE",
+          "URI": "/lists/:list_id/listings/:person_id",
+          "parameters": [
+            {
+              "Name": "list_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the list"
+            },
+            {
+              "Name": "person_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the person to drop from the list"
+            }
+          ]
+        },
+        {
+          "MethodName": "Add tag",
+          "Synopsis": "Adds a tag to all of the list members",
+          "HTTPMethod": "POST",
+          "URI": "/lists/:list_id/tag/:tag",
+          "parameters": [
+            {
+              "Name": "list_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the list"
+            },
+            {
+              "Name": "tag",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "The name of the tag to use"
+            }
+          ]
+        },
+        {
+          "MethodName": "Delete tag",
+          "Synopsis": "Deletes the tag from all of the list members",
+          "HTTPMethod": "DELETE",
+          "URI": "/lists/:list_id/tag/:tag",
+          "parameters": [
+            {
+              "Name": "list_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the list"
+            },
+            {
+              "Name": "tag",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "The name of the tag to use"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Page Attachments",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of a page's file attachments",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/:page_slug/attachments",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "The slug of the site the page lives on"
+            },
+            {
+              "Name": "page_slug",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "string",
+              "Description": "The page's slug"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Show",
+          "Synopsis": "Creates a new file attachment for a page",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/:page_slug/attachments/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "The slug of the site the page lives on"
+            },
+            {
+              "Name": "page_slug",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "string",
+              "Description": "The page's slug"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the page attachment"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a new file attachment for a page",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/:page_slug/attachments",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "The slug of the site the page lives on"
+            },
+            {
+              "Name": "page_slug",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "string",
+              "Description": "The page's slug"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "A JSON representation of the attachment"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Destroys a file attachment for a page",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/:page_slug/attachments/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "The slug of the site the page lives on"
+            },
+            {
+              "Name": "page_slug",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "string",
+              "Description": "The page's slug"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The ID of the page attachment"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "People",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of people",
+          "HTTPMethod": "GET",
+          "URI": "/people",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Show",
+          "Synopsis": "Returns a full representation of the person",
+          "HTTPMethod": "GET",
+          "URI": "/people/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": "1",
+              "Type": "int",
+              "Description": "the person's id"
+            }
+          ]
+        },
+        {
+          "MethodName": "Match",
+          "Synopsis": "Finds people that match certain attributes exactly",
+          "HTTPMethod": "GET",
+          "URI": "/people/match",
+          "parameters": [
+            {
+              "Name": "email",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "first_name",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "last_name",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "phone",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "mobile",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            }
+          ]
+        },
+        {
+          "MethodName": "Search",
+          "Synopsis": "Search for people using non-unique traits",
+          "HTTPMethod": "GET",
+          "URI": "/people/search",
+          "parameters": [
+            {
+              "Name": "first_name",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "last_name",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "city",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "state",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "sex",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "birthdate",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "updated_since",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "with_mobile",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "custom_values",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": null
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": null
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "100",
+              "Type": "int",
+              "Description": null
+            }
+          ]
+        },
+        {
+          "MethodName": "Nearby",
+          "Synopsis": "Searches for people near a location defined by latitude and longitude",
+          "HTTPMethod": "GET",
+          "URI": "/people/nearby",
+          "parameters": [
+            {
+              "Name": "location",
+              "Required": "Y",
+              "Default": "34.049031,-118.251399",
+              "Type": "string",
+              "Description": "origin of search in the format \"latitude,longitude\""
+            },
+            {
+              "Name": "distance",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "radius in miles for which to include results"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to show per page"
+            }
+          ]
+        },
+        {
+          "MethodName": "Me",
+          "Synopsis": "Returns the access token's resource owner's representation",
+          "HTTPMethod": "GET",
+          "URI": "/people/me",
+          "parameters": [
+
+          ]
+        },
+        {
+          "MethodName": "Register",
+          "Synopsis": "Starts user registration person for the given person",
+          "HTTPMethod": "GET",
+          "URI": "/people/:id/register",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The person's ID"
+            }
+          ]
+        },
+        {
+          "MethodName": "Taggings",
+          "Synopsis": "Returns all taggings for a given person",
+          "HTTPMethod": "GET",
+          "URI": "/people/:id/taggings",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the person"
+            }
+          ]
+        },
+        {
+          "MethodName": "Tag Person",
+          "Synopsis": "Tags a person",
+          "HTTPMethod": "PUT",
+          "URI": "/people/:id/taggings",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the person"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "JSON with tagging information"
+            }
+          ]
+        },
+        {
+          "MethodName": "Tag Removal",
+          "Synopsis": "Removes a tag from a person",
+          "HTTPMethod": "DELETE",
+          "URI": "/people/:id/taggings/:tag",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the person"
+            },
+            {
+              "Name": "tag",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the name of the tag"
+            }
+          ]
+        },
+        {
+          "MethodName": "Political Capital",
+          "Synopsis": "Returns a paginated list of a person's capitals",
+          "HTTPMethod": "GET",
+          "URI": "/people/:id/capitals",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the person"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to show per page"
+            }
+          ]
+        },
+        {
+          "MethodName": "Political Capital Create",
+          "Synopsis": "Creates capital for the given person",
+          "HTTPMethod": "POST",
+          "URI": "/people/:id/capitals",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the person"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "JSON representation of the capital to create"
+            }
+          ]
+        },
+        {
+          "MethodName": "Political Capital Destroy",
+          "Synopsis": "Destroys capital for a person",
+          "HTTPMethod": "DELETE",
+          "URI": "/people/:person_id/capitals/:capital_id",
+          "parameters": [
+            {
+              "Name": "person_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the person"
+            },
+            {
+              "Name": "capital_id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the capital to destroy"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a person with the provided data",
+          "HTTPMethod": "POST",
+          "URI": "/people",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON representation of the person to create"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates a person with the provided data",
+          "HTTPMethod": "PUT",
+          "URI": "/people/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The person's ID"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON attributes for updating the person"
+            }
+          ]
+        },
+        {
+          "MethodName": "Push",
+          "Synopsis": "Updates a matched person or creates a new one if the person doesn't exist",
+          "HTTPMethod": "PUT",
+          "URI": "/people/push",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": "{}",
+              "Type": "json",
+              "Description": "JSON attributes for updating/matching the person"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes the person with the matching ID",
+          "HTTPMethod": "DELETE",
+          "URI": "/people/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "The person's ID"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "People Tags",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of previously used tags",
+          "HTTPMethod": "GET",
+          "URI": "/tags",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "People",
+          "Synopsis": "Searches for people with the given tag",
+          "HTTPMethod": "GET",
+          "URI": "/tags/:tag/people",
+          "parameters": [
+            {
+              "Name": "tag",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the name of the tag"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Sites",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Returns a list of all sites",
+          "HTTPMethod": "GET",
+          "URI": "/sites",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Surveys",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Shows a list of all surveys for the a site",
+          "HTTPMethod": "GET",
+          "URI": "/sites/:site_slug/pages/surveys",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the survey"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a survey for a site",
+          "HTTPMethod": "POST",
+          "URI": "/sites/:site_slug/pages/surveys",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the survey"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the new survey"
+            }
+          ]
+        },
+        {
+          "MethodName": "Update",
+          "Synopsis": "Updates the attributes of a survey",
+          "HTTPMethod": "PUT",
+          "URI": "/sites/:site_slug/pages/surveys/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the survey"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the survey"
+            },
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "JSON containing updates"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Removes a survey",
+          "HTTPMethod": "DELETE",
+          "URI": "/sites/:site_slug/pages/surveys/:id",
+          "parameters": [
+            {
+              "Name": "site_slug",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the site holding the survey"
+            },
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "int",
+              "Description": "the ID of the survey"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Survey Responses",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Lists all survey responses",
+          "HTTPMethod": "GET",
+          "URI": "/survey_responses",
+          "parameters": [
+            {
+              "Name": "start_time",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": "the starting time for results"
+            },
+            {
+              "Name": "end_time",
+              "Required": "N",
+              "Default": null,
+              "Type": "string",
+              "Description": "the ending time for results"
+            },
+            {
+              "Name": "survey_id",
+              "Required": "N",
+              "Default": null,
+              "Type": "int",
+              "Description": "the id for a parent survey"
+            },
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates responses for a survey",
+          "HTTPMethod": "POST",
+          "URI": "/survey_responses",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the survey responses"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "Webhooks",
+      "methods": [
+        {
+          "MethodName": "Index",
+          "Synopsis": "Lists all webhooks",
+          "HTTPMethod": "GET",
+          "URI": "/webhooks",
+          "parameters": [
+            {
+              "Name": "page",
+              "Required": "N",
+              "Default": "1",
+              "Type": "int",
+              "Description": "result page number"
+            },
+            {
+              "Name": "per_page",
+              "Required": "N",
+              "Default": "10",
+              "Type": "int",
+              "Description": "number of results to return"
+            }
+          ]
+        },
+        {
+          "MethodName": "Show",
+          "Synopsis": "Shows the details of an individual webhook",
+          "HTTPMethod": "GET",
+          "URI": "/webhooks/:id",
+          "parameters": [
+            {
+              "Name": "id",
+              "Required": "Y",
+              "Default": null,
+              "Type": "string",
+              "Description": "the ID of the webhook to display"
+            }
+          ]
+        },
+        {
+          "MethodName": "Create",
+          "Synopsis": "Creates a new webhook",
+          "HTTPMethod": "POST",
+          "URI": "/webhooks",
+          "parameters": [
+            {
+              "Name": "body",
+              "Required": "Y",
+              "Default": null,
+              "Type": "json",
+              "Description": "a JSON representation of the new webhook"
+            }
+          ]
+        },
+        {
+          "MethodName": "Destroy",
+          "Synopsis": "Destroys a webhook",
+          "HTTPMethod": "DELETE",
+          "URI": "/webhooks/:id",
+          "parameters": [
+
+          ]
+        }
+      ]
+    }
+  ]
+}