Merge lp:~benji/launchpad/check-in-wadl into lp:launchpad

[Benji York]

The first time make is run in a new Launchpad branch the webservice's
WADL and HTML documentation is built which takes a while. This branch
checks in the generated WADL and HTML.

Storing the generated files introduces the risk that the content of the
files can drift from what would have been generated. To mitigate that
risk tests were added to compare the generated data to that on disk and
fail if they differ.

The utility that generates the files was also modified to not regenerate
the files if they already exist as well as support a --force switch to
make regenerating the files easy.

The tests can be run with

    bin/test -ct checked_in_wadl

There were a few small lint items fixed in this branch but not so many
as to interfere with efficient review.

Suggested music for reviewing this branch:
http://www.youtube.com/watch/?v=U-lt3vVA-4I

[Jelmer Vernooij (jelmer)]

Looks good, looking forward to being able to not having to wait for wadl generation anymore. :-)

Can you make create-lp-wadl-and-api use the generate_wadl() function, perhaps moving to somewhere outside of ftests? Apart from code duplication being bad in general, as far as I can tell create-lp-wadl-and-api doesn't have any tests itself.

Please use optparse in create-lp-wadl-and-api for consistency with the other utilities and in case of possible future additional options.

review: Needs Fixing (code)

[Benji York (benji)]

On Wed, Aug 25, 2010 at 1:07 PM, Jelmer Vernooij <email address hidden> wrote:
> Review: Needs Fixing code
> Looks good, looking forward to being able to not having to wait for wadl generation anymore. :-)
>
> Can you make create-lp-wadl-and-api use the generate_wadl() function, perhaps moving to somewhere outside of ftests? Apart from code duplication being bad in general, as far as I can tell create-lp-wadl-and-api doesn't have any tests itself.

Done.

> Please use optparse in create-lp-wadl-and-api for consistency with the other utilities and in case of possible future additional options.

Done.
--
Benji York

[Jelmer Vernooij (jelmer)]

Thanks. r=me, but can you please fix the following two issues:

The copyright header in the new file you've added has a copyright for 2009.
The imports are still formatted according to the old style, they should now each have their own line.

review: Approve (code)

[Benji York (benji)]

On Wed, Aug 25, 2010 at 8:02 PM, Jelmer Vernooij <email address hidden> wrote:
> Review: Approve code
> Thanks. r=me, but can you please fix the following two issues:
>
> The copyright header in the new file you've added has a copyright for 2009.
> The imports are still formatted according to the old style, they should now each have their own line.

Both of the above have been fixed.
--
Benji York

=== modified file '.bzrignore'
--- .bzrignore	2010-08-26 02:00:51 +0000
+++ .bzrignore	2010-09-03 17:37:48 +0000
@@ -30,9 +30,8 @@
 database/sampledata/newsampledata-dev.sql
 database/sampledata/lintdata.sql
 database/sampledata/lintdata-dev.sql
-lib/canonical/launchpad/apidoc/*.html
+lib/canonical/launchpad/apidoc/index.html
 xxx-report.*
-lib/canonical/launchpad/apidoc/wadl-development-*.xml
 lib/canonical/launchpad/apidoc/wadl-test-playground.xml
 lib/canonical/launchpad/icing/build/*
 lib/canonical/launchpad/icing/combo.css
@@ -59,7 +58,6 @@
 .testrepository
 .memcache.pid
 ./pipes
-lib/canonical/launchpad/apidoc/wadl-development-*.xml
 tags.new
 lp-clustered.dot
 lp-clustered.sfood
@@ -67,7 +65,6 @@
 lp.sfood
 apidocs
 twistd.pid
-lib/canonical/launchpad/apidoc
 *.prof
 lib/canonical/launchpad-buildd_*.dsc
 lib/canonical/launchpad-buildd_*.tar.gz

=== modified file 'Makefile'
--- Makefile	2010-08-31 21:22:27 +0000
+++ Makefile	2010-09-03 17:37:48 +0000
@@ -28,7 +28,7 @@
 BZR_VERSION_INFO = bzr-version-info.py
 
 APIDOC_DIR = lib/canonical/launchpad/apidoc
-WADL_TEMPLATE = $(APIDOC_DIR).tmp/wadl-$(LPCONFIG)-%(version)s.xml
+WADL_TEMPLATE = $(APIDOC_DIR)/wadl-$(LPCONFIG)-%(version)s.xml
 API_INDEX = $(APIDOC_DIR)/index.html
 
 # Do not add bin/buildout to this list.
@@ -59,9 +59,7 @@
 	$(PY) ./utilities/make-dummy-hosted-branches
 
 $(API_INDEX): $(BZR_VERSION_INFO)
-	mkdir -p $(APIDOC_DIR).tmp
 	LPCONFIG=$(LPCONFIG) $(PY) ./utilities/create-lp-wadl-and-apidoc.py "$(WADL_TEMPLATE)"
-	mv $(APIDOC_DIR).tmp $(APIDOC_DIR)
 
 apidoc: compile $(API_INDEX)
 
@@ -343,8 +341,6 @@
 	$(RM) -r lib/mailman
 	$(RM) -rf lib/canonical/launchpad/icing/build/*
 	$(RM) -r $(CODEHOSTING_ROOT)
-	$(RM) -rf $(APIDOC_DIR)
-	$(RM) -rf $(APIDOC_DIR).tmp
 	$(RM) $(BZR_VERSION_INFO)
 	$(RM) +config-overrides.zcml
 	$(RM) -rf \

=== added directory 'lib/canonical/launchpad/apidoc'
=== added file 'lib/canonical/launchpad/apidoc/1.0.html'
--- lib/canonical/launchpad/apidoc/1.0.html	1970-01-01 00:00:00 +0000
+++ lib/canonical/launchpad/apidoc/1.0.html	2010-09-03 17:37:48 +0000
@@ -0,0 +1,33070 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>About this service</title>
+    <style type="text/css">
+            body {
+                font-family: sans-serif;
+                font-size: 0.85em;
+                margin: 2em 8em;
+            }
+            .methods {
+                background-color: #eef;
+                padding: 1em;
+                margin-bottom: 0.5em;
+            }
+            .method {
+                padding-left: 4em;
+            }
+            h1 {
+                font-size: 2.5em;
+            }
+            h2 {
+                border-bottom: 1px solid black;
+                margin-top: 1em;
+                margin-bottom: 0.5em;
+                font-size: 2em;
+               }
+            h3 {
+                color: orange;
+                font-size: 1.75em;
+                margin-top: 1.25em;
+                margin-bottom: 0em;
+            }
+            h4 {
+                font-size: 1.50em;
+                margin: 0em;
+                padding: 0em;
+                border-bottom: 2px solid white;
+            }
+            h5 {
+                font-size: 1.25em;
+                margin-left: -3em;
+            }
+            h6 {
+                font-size: 1.1em;
+                color: #99a;
+                margin: 0.5em 0em 0.25em 0em;
+            }
+            dd {
+                margin-left: 1em;
+            }
+            tt, code {
+                font-size: 1.2em;
+            }
+            table {
+                margin-bottom: 0.5em;
+            }
+            th {
+                text-align: left;
+                font-weight: normal;
+                color: black;
+                border-bottom: 1px solid black;
+                padding: 3px 6px;
+            }
+            td {
+                padding: 3px 6px;
+                vertical-align: top;
+                background-color: #f6f6ff;
+                font-size: 0.85em;
+            }
+            td p {
+                margin: 0px;
+            }
+            ul {
+                padding-left: 1.75em;
+            }
+            p + ul, p + ol, p + dl {
+                margin-top: 0em;
+            }
+            label {
+                font-weight: bold;
+            }
+            .optional {
+                font-weight: normal;
+                opacity: 0.75;
+            }
+            .toc-link {
+                font-size: 0.85em;
+            }
+        </style>
+  </head>
+  <body>
+    <h1>About this service</h1>
+    <p>The Launchpad web service allows automated
+        clients to access most of the functionality available on the
+        Launchpad web site. For help getting started, see
+        <a href="https://help.launchpad.net/API/">the help wiki.</a></p>
+    <p>This version of the web service removes unnecessary
+        named operations. It was introduced in March 2010, and its
+        end-of-life date is April 2015, the same as the server version
+        of the Ubuntu release "Lucid Lynx".</p>
+    <div id="toc" title="toc">
+      <h2>Table of Contents</h2>
+      <h3>Top-level objects</h3>
+      <ul>
+        <li>
+          <a href="#branches">branches</a>
+        </li>
+        <li>
+          <a href="#bug_trackers">bug_trackers</a>
+        </li>
+        <li>
+          <a href="#bugs">bugs</a>
+        </li>
+        <li>
+          <a href="#countries">countries</a>
+        </li>
+        <li>
+          <a href="#cves">cves</a>
+        </li>
+        <li>
+          <a href="#distributions">distributions</a>
+        </li>
+        <li>
+          <a href="#languages">languages</a>
+        </li>
+        <li>
+          <a href="#person">me</a>
+        </li>
+        <li>
+          <a href="#packagesets">packagesets</a>
+        </li>
+        <li>
+          <a href="#people">people</a>
+        </li>
+        <li>
+          <a href="#pillars">pillars</a>
+        </li>
+        <li>
+          <a href="#project_groups">project_groups</a>
+        </li>
+        <li>
+          <a href="#projects">projects</a>
+        </li>
+        <li>
+          <a href="#temporary_blobs">temporary_blobs</a>
+        </li>
+        <li>
+          <a href="#translation_import_queue_entries">translation_import_queue_entries</a>
+        </li>
+      </ul>
+      <h3>Entry types</h3>
+      <ul>
+        <li>
+          <a href="#ScalarValue">ScalarValue</a>
+        </li>
+        <li>
+          <a href="#archive">archive</a>
+        </li>
+        <li>
+          <a href="#archive_dependency">archive_dependency</a>
+        </li>
+        <li>
+          <a href="#archive_permission">archive_permission</a>
+        </li>
+        <li>
+          <a href="#archive_subscriber">archive_subscriber</a>
+        </li>
+        <li>
+          <a href="#binary_package_publishing_history">binary_package_publishing_history</a>
+        </li>
+        <li>
+          <a href="#binary_package_release_download_count">binary_package_release_download_count</a>
+        </li>
+        <li>
+          <a href="#branch">branch</a>
+        </li>
+        <li>
+          <a href="#branch_merge_proposal">branch_merge_proposal</a>
+        </li>
+        <li>
+          <a href="#branch_subscription">branch_subscription</a>
+        </li>
+        <li>
+          <a href="#bug">bug</a>
+        </li>
+        <li>
+          <a href="#bug_attachment">bug_attachment</a>
+        </li>
+        <li>
+          <a href="#bug_branch">bug_branch</a>
+        </li>
+        <li>
+          <a href="#bug_nomination">bug_nomination</a>
+        </li>
+        <li>
+          <a href="#bug_subscription">bug_subscription</a>
+        </li>
+        <li>
+          <a href="#bug_target">bug_target</a>
+        </li>
+        <li>
+          <a href="#bug_task">bug_task</a>
+        </li>
+        <li>
+          <a href="#bug_tracker">bug_tracker</a>
+        </li>
+        <li>
+          <a href="#bug_watch">bug_watch</a>
+        </li>
+        <li>
+          <a href="#build">build</a>
+        </li>
+        <li>
+          <a href="#code_import">code_import</a>
+        </li>
+        <li>
+          <a href="#code_review_comment">code_review_comment</a>
+        </li>
+        <li>
+          <a href="#code_review_vote_reference">code_review_vote_reference</a>
+        </li>
+        <li>
+          <a href="#commercial_subscription">commercial_subscription</a>
+        </li>
+        <li>
+          <a href="#country">country</a>
+        </li>
+        <li>
+          <a href="#cve">cve</a>
+        </li>
+        <li>
+          <a href="#distribution">distribution</a>
+        </li>
+        <li>
+          <a href="#distribution_mirror">distribution_mirror</a>
+        </li>
+        <li>
+          <a href="#distribution_source_package">distribution_source_package</a>
+        </li>
+        <li>
+          <a href="#distro_arch_series">distro_arch_series</a>
+        </li>
+        <li>
+          <a href="#distro_series">distro_series</a>
+        </li>
+        <li>
+          <a href="#email_address">email_address</a>
+        </li>
+        <li>
+          <a href="#gpg_key">gpg_key</a>
+        </li>
+        <li>
+          <a href="#h_w_device">h_w_device</a>
+        </li>
+        <li>
+          <a href="#h_w_device_class">h_w_device_class</a>
+        </li>
+        <li>
+          <a href="#h_w_driver">h_w_driver</a>
+        </li>
+        <li>
+          <a href="#h_w_driver_name">h_w_driver_name</a>
+        </li>
+        <li>
+          <a href="#h_w_driver_package_name">h_w_driver_package_name</a>
+        </li>
+        <li>
+          <a href="#h_w_submission">h_w_submission</a>
+        </li>
+        <li>
+          <a href="#h_w_submission_device">h_w_submission_device</a>
+        </li>
+        <li>
+          <a href="#h_w_vendor_i_d">h_w_vendor_i_d</a>
+        </li>
+        <li>
+          <a href="#has_bugs">has_bugs</a>
+        </li>
+        <li>
+          <a href="#has_milestones">has_milestones</a>
+        </li>
+        <li>
+          <a href="#hwdb">hwdb</a>
+        </li>
+        <li>
+          <a href="#irc_id">irc_id</a>
+        </li>
+        <li>
+          <a href="#jabber_id">jabber_id</a>
+        </li>
+        <li>
+          <a href="#language">language</a>
+        </li>
+        <li>
+          <a href="#message">message</a>
+        </li>
+        <li>
+          <a href="#milestone">milestone</a>
+        </li>
+        <li>
+          <a href="#object_with_translation_imports">object_with_translation_imports</a>
+        </li>
+        <li>
+          <a href="#package_upload">package_upload</a>
+        </li>
+        <li>
+          <a href="#packageset">packageset</a>
+        </li>
+        <li>
+          <a href="#pillar">pillar</a>
+        </li>
+        <li>
+          <a href="#preview_diff">preview_diff</a>
+        </li>
+        <li>
+          <a href="#project">project</a>
+        </li>
+        <li>
+          <a href="#project_group">project_group</a>
+        </li>
+        <li>
+          <a href="#project_release">project_release</a>
+        </li>
+        <li>
+          <a href="#project_release_file">project_release_file</a>
+        </li>
+        <li>
+          <a href="#project_series">project_series</a>
+        </li>
+        <li>
+          <a href="#source_package">source_package</a>
+        </li>
+        <li>
+          <a href="#source_package_publishing_history">source_package_publishing_history</a>
+        </li>
+        <li>
+          <a href="#source_package_recipe">source_package_recipe</a>
+        </li>
+        <li>
+          <a href="#source_package_recipe_build">source_package_recipe_build</a>
+        </li>
+        <li>
+          <a href="#specification">specification</a>
+        </li>
+        <li>
+          <a href="#specification_branch">specification_branch</a>
+        </li>
+        <li>
+          <a href="#ssh_key">ssh_key</a>
+        </li>
+        <li>
+          <a href="#structural_subscription">structural_subscription</a>
+        </li>
+        <li>
+          <a href="#structural_subscription_target">structural_subscription_target</a>
+        </li>
+        <li>
+          <a href="#team">team</a>
+        </li>
+        <li>
+          <a href="#team_membership">team_membership</a>
+        </li>
+        <li>
+          <a href="#temporary_blob">temporary_blob</a>
+        </li>
+        <li>
+          <a href="#translation_file">translation_file</a>
+        </li>
+        <li>
+          <a href="#translation_import_queue_entry">translation_import_queue_entry</a>
+        </li>
+        <li>
+          <a href="#translation_template">translation_template</a>
+        </li>
+        <li>
+          <a href="#wiki_name">wiki_name</a>
+        </li>
+      </ul>
+    </div>
+    <div id="top-level-objects" title="top-level-objects">
+      <h2>Top-level objects</h2>
+      <div id="branches" title="branches" class="top-level-object">
+        <h3>branches</h3>
+        <p>
+Interface representing the set of branches.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/branches</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#branch">branch</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="branches-custom-GETs" title="branches-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="branches-getByUniqueName" title="branches-getByUniqueName">getByUniqueName</h5><p>
+<p>Find a branch by its ~owner/product/name unique name.</p>
+<p>Return None if no match was found.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByUniqueName</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>unique_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Branch unique name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#branch">branch</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="branches-getByUrl" title="branches-getByUrl">getByUrl</h5><p>
+<p>Find a branch by URL.</p>
+<p>Either from the external specified in Branch.url, from the URL on
+<a class="rst-reference external" href="http://bazaar.launchpad.net/" target="_top">http://bazaar.launchpad.net/</a> or the lp: URL.</p>
+<p>This is a frontend shim to IBranchLookup.getByUrl to allow it to be
+exported over the API. If you want to call this from within the
+Launchpad app, use the IBranchLookup version instead.</p>
+<p>Return None if no match was found.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByUrl</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>url</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Branch URL
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#branch">branch</a>.
+        </p>
+        </div>
+          <div class="method">
+            <h5 id="branches-getByUrls" title="branches-getByUrls">getByUrls</h5>
+            <p>
+<p>Finds branches by URL.</p>
+<p>Either from the external specified in Branch.url, from the URL on
+<a class="rst-reference external" href="http://bazaar.launchpad.net/" target="_top">http://bazaar.launchpad.net/</a>, or from the lp: URL.</p>
+<p>This is a frontend shim to IBranchLookup.getByUrls to allow it to be
+exported over the API. If you want to call this from within the
+Launchpad app, use the IBranchLookup version instead.</p>
+
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>getByUrls</var></p>
+                </td>
+                <td>
+                  <p>The name of the operation being invoked.</p>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>urls</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td>
+                  <p>
+<p>A list of URLs of branches</p>
+<p>These can be URLs external to Launchpad, lp: URLs, or <a class="rst-reference external" href="http://bazaar.launchpad.net/" target="_top">http://bazaar.launchpad.net/</a> URLs, or any mix of all these different kinds.</p>
+
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="bug_trackers" title="bug_trackers" class="top-level-object">
+        <h3>bug_trackers</h3>
+        <p>
+<p>A set of IBugTracker's.</p>
+<p>Each BugTracker is a distinct instance of a bug tracking tool. For
+example, bugzilla.mozilla.org is distinct from bugzilla.gnome.org.</p>
+
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/bug_trackers</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#bug_tracker">bug_tracker</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="bug_trackers-custom-GETs" title="bug_trackers-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="bug_trackers-getByName" title="bug_trackers-getByName">getByName</h5><p>
+<p>Get a BugTracker by its name.</p>
+<p>If no tracker with the given name exists, return default.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByName</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+The bug tracker name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#bug_tracker">bug_tracker</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="bug_trackers-queryByBaseURL" title="bug_trackers-queryByBaseURL">queryByBaseURL</h5><p>
+Return one or None BugTracker's by baseurl
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>queryByBaseURL</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>base_url</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+The base URL of the bug tracker
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#bug_tracker">bug_tracker</a>.
+        </p>
+        </div>
+        </div>
+        <div id="bug_trackers-custom-POSTs" title="bug_trackers-custom-POSTs" class="methods POSTs">
+          <h4>Custom POST methods</h4>
+          <div class="method"><h5 id="bug_trackers-ensureBugTracker" title="bug_trackers-ensureBugTracker">ensureBugTracker</h5><p>
+<p>Make sure that there is a bugtracker for the given base url.</p>
+<p>If not, create one using the given attributes.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>ensureBugTracker</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>base_url</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Location</p>
+<p>The top-level URL for the bug tracker, or an upstream email address. This must be accurate so that Launchpad can link to external bug reports.</p>
+
+</p></td></tr><tr><td><p><strong>bug_tracker_type</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Bugzilla</tt></li><li><tt>Debbugs</tt></li><li><tt>Roundup</tt></li><li><tt>Trac</tt></li><li><tt>SourceForge or SourceForge derivative</tt></li><li><tt>Mantis</tt></li><li><tt>Request Tracker (RT)</tt></li><li><tt>Email Address</tt></li><li><tt>Savane</tt></li><li><tt>PHP Project Bugtracker</tt></li><li><tt>Google Code</tt></li></ul></td><td><p>
+Bug Tracker Type
+</p></td></tr><tr><td><p><strong>contact_details</strong></p></td><td><p></p></td><td><p>
+<p>Contact details</p>
+<p>The contact details for the external bug tracker (so that, for example, its administrators can be contacted about a security breach).</p>
+
+</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p></p></td><td><p>
+<p>Name</p>
+<p>A URL-friendly name for the bug tracker, such as "mozilla-bugs".</p>
+
+</p></td></tr><tr><td><p><strong>summary</strong></p></td><td><p></p></td><td><p>
+<p>Summary</p>
+<p>A brief introduction or overview of this bug tracker instance.</p>
+
+</p></td></tr><tr><td><p><strong>title</strong></p></td><td><p></p></td><td><p>
+<p>Title</p>
+<p>A descriptive label for this tracker to show in listings.</p>
+
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#bug_tracker">bug_tracker</a>.
+        </p>
+          
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="bugs" title="bugs" class="top-level-object">
+        <h3>bugs</h3>
+        <p>
+Application root for malone.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/bugs</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#bug">bug</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="bugs-custom-POSTs" title="bugs-custom-POSTs" class="methods POSTs">
+          <h4>Custom POST methods</h4>
+          <div class="method"><h5 id="bugs-createBug" title="bugs-createBug">createBug</h5><p>
+<p>Create a bug (with an appropriate bugtask) and return it.</p>
+
+<p>Things to note when using this factory:</p>
+<blockquote>
+<ul class="rst-simple">
+<li>the owner will be subscribed to the bug</li>
+<li>distribution, product and package contacts (whichever ones are
+applicable based on the bug report target) will be subscribed to
+all <em>public bugs only</em></li>
+<li>for public upstreams bugs where there is no upstream bug contact,
+the product owner will be subscribed instead</li>
+</ul>
+</blockquote>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>createBug</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>description</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Description</p>
+<dl class="rst-docutils">
+<dt>A detailed description of the problem,</dt>
+<dd>including the steps required to reproduce it.</dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>private</strong></p></td><td><p></p></td><td><p>
+<p>This bug report should be private</p>
+<p>Private bug reports are visible only to their subscribers.</p>
+
+</p></td></tr><tr><td><p><strong>security_related</strong></p></td><td><p></p></td><td><p>
+This bug is a security vulnerability.
+</p></td></tr><tr><td><p><strong>tags</strong></p></td><td><p></p></td><td><p>
+<p>Tags</p>
+<p>Separated by whitespace.</p>
+
+</p></td></tr><tr><td><p><strong>target</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#bug_target">bug_target</a>.
+            </td><td><p>
+The project, distribution or source package that has this bug.
+</p></td></tr><tr><td><p><strong>title</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Summary</p>
+<p>A one-line summary of the problem.</p>
+
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#bug">bug</a>.
+        </p>
+          
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="countries" title="countries" class="top-level-object">
+        <h3>countries</h3>
+        <p>
+A container for countries.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/countries</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#country">country</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="countries-custom-GETs" title="countries-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="countries-getByCode" title="countries-getByCode">getByCode</h5><p>
+Return a country by its code.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByCode</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>code</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Code
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#country">country</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="countries-getByName" title="countries-getByName">getByName</h5><p>
+Return a country by its name.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByName</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#country">country</a>.
+        </p>
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="cves" title="cves" class="top-level-object">
+        <h3>cves</h3>
+        <p>
+The set of ICve objects.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/cves</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#cve">cve</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="distributions" title="distributions" class="top-level-object">
+        <h3>distributions</h3>
+        <p>
+Interface for DistrosSet
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/distributions</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#distribution">distribution</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="languages" title="languages" class="top-level-object">
+        <h3>languages</h3>
+        <p>
+<p>The collection of languages.</p>
+<p>The standard get method will return only the visible languages.
+If you want to access all languages known to Launchpad, use
+the getAllLanguages method.</p>
+
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/languages</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#language">language</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="languages-custom-GETs" title="languages-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="languages-getAllLanguages" title="languages-getAllLanguages">getAllLanguages</h5><p>
+Return a result set of all ILanguages from Launchpad.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getAllLanguages</var></p></td><td><p>The name of the operation being invoked.</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#language">language</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="person" title="person" class="top-level-object">
+        <h3>person</h3>
+        <p>
+A Person.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/person</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#"></a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="person-custom-GETs" title="person-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method">
+            <h5 id="person-getArchiveSubscriptionURLs" title="person-getArchiveSubscriptionURLs">getArchiveSubscriptionURLs</h5>
+            <p>
+<p>Return private archive URLs that this person can see.</p>
+<p>For each of the private archives (PPAs) that this person can see,
+return a URL that includes the HTTP basic auth data.  The URL
+returned is suitable for including in a sources.list file.</p>
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>getArchiveSubscriptionURLs</var></p>
+                </td>
+                <td></td>
+              </tr>
+            </table>
+          </div>
+          <div class="method"><h5 id="person-getBranches" title="person-getBranches">getBranches</h5><p>
+<p>Returns all branches with the given lifecycle status.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getBranches</var></p></td><td></td></tr><tr><td><p><strong>modified_since</strong></p></td><td><p></p></td><td><p>
+Limit the branches to those modified since this date.
+</p></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p></td><td><p>
+A list of branch lifecycle statuses to filter by.
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#branch">branch</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="person-getBugSubscriberPackages" title="person-getBugSubscriberPackages">getBugSubscriberPackages</h5><p>
+<p>Return the packages for which this person is a bug subscriber.</p>
+<p>Returns a list of IDistributionSourcePackage's, ordered alphabetically
+(A to Z) by name.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getBugSubscriberPackages</var></p></td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#distribution_source_package">distribution_source_package</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="person-getMembersByStatus" title="person-getMembersByStatus">getMembersByStatus</h5><p>
+<p>Return the people whose membership on this team match :status:.</p>
+<p>If no orderby is provided, Person.sortingColumns is used.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getMembersByStatus</var></p></td><td></td></tr><tr><td><p><strong>status</strong></p></td><td><p><small>(required)</small></p><p><em>One of:</em></p><ul><li><tt>Proposed</tt></li><li><tt>Approved</tt></li><li><tt>Administrator</tt></li><li><tt>Deactivated</tt></li><li><tt>Expired</tt></li><li><tt>Declined</tt></li><li><tt>Invited</tt></li><li><tt>Invitation declined</tt></li></ul></td><td><p>
+The state of this membership
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#person">person</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="person-getMergeProposals" title="person-getMergeProposals">getMergeProposals</h5><p>
+<p>Returns all merge proposals of a given status.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getMergeProposals</var></p></td><td></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p></td><td><p>
+A list of merge proposal statuses to filter by.
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#branch_merge_proposal">branch_merge_proposal</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="person-getPPAByName" title="person-getPPAByName">getPPAByName</h5><p>
+<p>Return a PPA with the given name if it exists.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPPAByName</var></p></td><td></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive">archive</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="person-getRecipe" title="person-getRecipe">getRecipe</h5><p>
+Return the person's recipe with the given name.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getRecipe</var></p></td><td></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#source_package_recipe">source_package_recipe</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="person-getRequestedReviews" title="person-getRequestedReviews">getRequestedReviews</h5><p>
+<p>Returns merge proposals where a person was asked to review.</p>
+<p>This does not include merge proposals that were requested from
+teams that the person is part of. If status is not passed then
+it will return proposals that are in the "Needs Review" state.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getRequestedReviews</var></p></td><td></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p></td><td><p>
+A list of merge proposal statuses to filter by.
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#branch_merge_proposal">branch_merge_proposal</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="person-searchTasks" title="person-searchTasks">searchTasks</h5><p>
+<p>Search the IBugTasks reported on this entity.</p>
+
+<p>Return an iterable of matching results.</p>
+<p>Note: milestone is currently ignored for all IBugTargets
+except IProduct.</p>
+<p>In order to search bugs that are related to a given hardware
+device, you must specify the bus, the vendor ID, the product
+ID of the device and set at least one of
+hardware_owner_is_bug_reporter,
+hardware_owner_is_affected_by_bug,
+hardware_owner_is_subscribed_to_bug,
+hardware_is_linked_to_bug to True.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>searchTasks</var></p></td><td></td></tr><tr><td><p><strong>affected_user</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>assignee</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>bug_commenter</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>bug_reporter</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>bug_subscriber</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>bug_supervisor</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>component</strong></p></td><td><p></p></td><td><p>
+<p>Component</p>
+<p>Distribution package archive grouping. E.g. main, universe, multiverse</p>
+
+</p></td></tr><tr><td><p><strong>hardware_bus</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>System</tt></li><li><tt>PCI</tt></li><li><tt>USB</tt></li><li><tt>IEEE1394</tt></li><li><tt>SCSI</tt></li><li><tt>Parallel Port</tt></li><li><tt>Serial port</tt></li><li><tt>IDE</tt></li><li><tt>ATA</tt></li><li><tt>Floppy</tt></li><li><tt>IPI</tt></li><li><tt>SATA</tt></li><li><tt>SAS</tt></li><li><tt>PC Card (32 bit)</tt></li><li><tt>PCMCIA (16 bit)</tt></li></ul></td><td><p>
+The bus of a hardware device related to a bug
+</p></td></tr><tr><td><p><strong>hardware_driver_name</strong></p></td><td><p></p></td><td><p>
+The driver controlling a hardware device related to a bug.
+</p></td></tr><tr><td><p><strong>hardware_driver_package_name</strong></p></td><td><p></p></td><td><p>
+The package of the driver which controls a hardware device related to a bug.
+</p></td></tr><tr><td><p><strong>hardware_is_linked_to_bug</strong></p></td><td><p></p></td><td><p>
+Search for bugs which are linked to hardware reports which contain the given device or whcih contain a devicecontrolled by the given driver.
+</p></td></tr><tr><td><p><strong>hardware_owner_is_affected_by_bug</strong></p></td><td><p></p></td><td><p>
+Search for bugs where people affected by a bug own the given device or use the given hardware driver.
+</p></td></tr><tr><td><p><strong>hardware_owner_is_bug_reporter</strong></p></td><td><p></p></td><td><p>
+Search for bugs reported by people who own the given device or who use the given hardware driver.
+</p></td></tr><tr><td><p><strong>hardware_owner_is_subscribed_to_bug</strong></p></td><td><p></p></td><td><p>
+Search for bugs where a bug subscriber owns the given device or uses the given hardware driver.
+</p></td></tr><tr><td><p><strong>hardware_product_id</strong></p></td><td><p></p></td><td><p>
+<p>The product ID of a hardware device related to a bug.</p>
+<p>Allowed values of the product ID depend on the bus of the device.</p>
+<p>Product IDs of PCI, PCCard and USB devices are hexadecimal string representations of 16 bit integers in the format '0x01ab': The prefix '0x', followed by exactly 4 digits; where a digit is one of the characters 0..9, a..f. The characters A..F are not allowed.</p>
+<p>SCSI product IDs are strings with exactly 16 characters. Shorter names are right-padded with space (0x20) characters.</p>
+<p>IDs for other buses may be arbitrary strings.</p>
+
+</p></td></tr><tr><td><p><strong>hardware_vendor_id</strong></p></td><td><p></p></td><td><p>
+<p>The vendor ID of a hardware device related to a bug.</p>
+<p>Allowed values of the vendor ID depend on the bus of the device.</p>
+<p>Vendor IDs of PCI, PCCard and USB devices are hexadecimal string representations of 16 bit integers in the format '0x01ab': The prefix '0x', followed by exactly 4 digits; where a digit is one of the characters 0..9, a..f. The characters A..F are not allowed.</p>
+<p>SCSI vendor IDs are strings with exactly 8 characters. Shorter names are right-padded with space (0x20) characters.</p>
+<p>IDs for other buses may be arbitrary strings.</p>
+
+</p></td></tr><tr><td><p><strong>has_cve</strong></p></td><td><p></p></td><td><p>
+Show only bugs associated with a CVE
+</p></td></tr><tr><td><p><strong>has_no_package</strong></p></td><td><p></p></td><td><p>
+Exclude bugs with packages specified
+</p></td></tr><tr><td><p><strong>has_patch</strong></p></td><td><p></p></td><td><p>
+Show only bugs with patches available.
+</p></td></tr><tr><td><p><strong>importance</strong></p></td><td><p></p></td><td><p>
+<p>Importance</p>
+<p>Show only bugs with the given importance or list of importances.</p>
+
+</p></td></tr><tr><td><p><strong>linked_branches</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Show all bugs</tt></li><li><tt>Show only Bugs with linked Branches</tt></li><li><tt>Show only Bugs without linked Branches</tt></li></ul></td><td><p>
+Search for bugs that are linked to branches or for bugs that are not linked to branches.
+</p></td></tr><tr><td><p><strong>milestone</strong></p></td><td><p></p></td><td><p>
+<p>Milestone</p>
+<p>Show only bug tasks targeted to this milestone.</p>
+
+</p></td></tr><tr><td><p><strong>milestone_assignment</strong></p></td><td><p></p></td><td><p>
+Target
+</p></td></tr><tr><td><p><strong>modified_since</strong></p></td><td><p></p></td><td><p>
+Search for bugs that have been modified since the given date.
+</p></td></tr><tr><td><p><strong>nominated_for</strong></p></td><td><p></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td><td></td></tr><tr><td><p><strong>omit_duplicates</strong></p></td><td><p></p></td><td><p>
+Omit bugs marked as duplicate,
+</p></td></tr><tr><td><p><strong>omit_targeted</strong></p></td><td><p></p></td><td><p>
+Omit bugs targeted to a series
+</p></td></tr><tr><td><p><strong>order_by</strong></p></td><td><p></p></td><td><p>
+List of fields by which the results are ordered.
+</p></td></tr><tr><td><p><strong>owner</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>search_text</strong></p></td><td><p></p></td><td><p>
+Bug ID or search text.
+</p></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p></td><td><p>
+<p>Status</p>
+<p>Show only bugs with the given status value or list of values.</p>
+
+</p></td></tr><tr><td><p><strong>status_upstream</strong></p></td><td><p></p></td><td><p>
+<p>Status upstream</p>
+<p>Indicates the status of any remote watches associated with the bug.  Possible values include: pending_bugwatch, hide_upstream, resolved_upstream, and open_upstream.</p>
+
+</p></td></tr><tr><td><p><strong>structural_subscriber</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>tags</strong></p></td><td><p></p></td><td><p>
+<p>Tags</p>
+<p>String or list of strings for tags to search. To exclude, prepend a '-', e.g. '-unwantedtag'</p>
+
+</p></td></tr><tr><td><p><strong>tags_combinator</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Any</tt></li><li><tt>All</tt></li></ul></td><td><p>
+<p>Tags combination</p>
+<p>Search for any or all of the tags specified.</p>
+
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#bug_task">bug_task</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <div id="person-custom-POSTs" title="person-custom-POSTs" class="methods POSTs">
+          <h4>Custom POST methods</h4>
+          <div class="method">
+            <h5 id="person-acceptInvitationToBeMemberOf" title="person-acceptInvitationToBeMemberOf">acceptInvitationToBeMemberOf</h5>
+            <p>
+<p>Accept an invitation to become a member of the given team.</p>
+<p>There must be a TeamMembership for this person and the given team with
+the INVITED status. The status of this TeamMembership will be changed
+to APPROVED.</p>
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>acceptInvitationToBeMemberOf</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>comment</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>team</strong>
+                  </p>
+                </td>
+                <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+                <td>
+                  <p>
+Team
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+          <div class="method">
+            <h5 id="person-addMember" title="person-addMember">addMember</h5>
+            <p>
+<p>Add the given person as a member of this team.</p>
+
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>addMember</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>comment</strong>
+                  </p>
+                </td>
+                <td>
+                  <p></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>person</strong>
+                  </p>
+                </td>
+                <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+                <td>
+                  <p>
+Member
+</p>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>status</strong>
+                  </p>
+                </td>
+                <td>
+                  <p></p>
+                  <p>
+                    <em>One of:</em>
+                  </p>
+                  <ul>
+                    <li>
+                      <tt>Proposed</tt>
+                    </li>
+                    <li>
+                      <tt>Approved</tt>
+                    </li>
+                    <li>
+                      <tt>Administrator</tt>
+                    </li>
+                    <li>
+                      <tt>Deactivated</tt>
+                    </li>
+                    <li>
+                      <tt>Expired</tt>
+                    </li>
+                    <li>
+                      <tt>Declined</tt>
+                    </li>
+                    <li>
+                      <tt>Invited</tt>
+                    </li>
+                    <li>
+                      <tt>Invitation declined</tt>
+                    </li>
+                  </ul>
+                </td>
+                <td>
+                  <p>
+The state of this membership
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+          <div class="method"><h5 id="person-createRecipe" title="person-createRecipe">createRecipe</h5><p>
+<p>Create a SourcePackageRecipe owned by this person.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>createRecipe</var></p></td><td></td></tr><tr><td><p><strong>build_daily</strong></p></td><td><p></p></td><td></td></tr><tr><td><p><strong>daily_build_archive</strong></p></td><td><p></p>
+                Link to a <a href="#archive">archive</a>.
+            </td><td></td></tr><tr><td><p><strong>description</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr><tr><td><p><strong>distroseries</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr><tr><td><p><strong>recipe_text</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#source_package_recipe">source_package_recipe</a>.
+        </p>
+          
+        </div>
+          <div class="method">
+            <h5 id="person-declineInvitationToBeMemberOf" title="person-declineInvitationToBeMemberOf">declineInvitationToBeMemberOf</h5>
+            <p>
+<p>Decline an invitation to become a member of the given team.</p>
+<p>There must be a TeamMembership for this person and the given team with
+the INVITED status. The status of this TeamMembership will be changed
+to INVITATION_DECLINED.</p>
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>declineInvitationToBeMemberOf</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>comment</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>team</strong>
+                  </p>
+                </td>
+                <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+                <td>
+                  <p>
+Team
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+          <div class="method">
+            <h5 id="person-getArchiveSubscriptionURL" title="person-getArchiveSubscriptionURL">getArchiveSubscriptionURL</h5>
+            <p>
+<p>Get a text line that is suitable to be used for a sources.list
+entry.</p>
+<p>It will create a new IArchiveAuthToken if one doesn't already exist.</p>
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>getArchiveSubscriptionURL</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>archive</strong>
+                  </p>
+                </td>
+                <td><p><small>(required)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+                <td></td>
+              </tr>
+            </table>
+          </div>
+          <div class="method">
+            <h5 id="person-join" title="person-join">join</h5>
+            <p>
+<p>Join the given team if its subscriptionpolicy is not RESTRICTED.</p>
+<p>Join the given team according to the policies and defaults of that
+team:</p>
+<ul class="rst-simple">
+<li>If the team subscriptionpolicy is OPEN, the user is added as
+an APPROVED member with a NULL TeamMembership.reviewer.</li>
+<li>If the team subscriptionpolicy is MODERATED, the user is added as
+a PROPOSED member and one of the team's administrators have to
+approve the membership.</li>
+</ul>
+<p>If may_subscribe_to_list is True, then also attempt to
+subscribe to the team's mailing list, depending on the list
+status and the person's auto-subscribe settings.</p>
+
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>join</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>team</strong>
+                  </p>
+                </td>
+                <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+                <td>
+                  <p>
+Team
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+          <div class="method">
+            <h5 id="person-leave" title="person-leave">leave</h5>
+            <p>
+<p>Leave the given team.</p>
+<p>If there's a membership entry for this person on the given team and
+its status is either APPROVED or ADMIN, we change the status to
+DEACTIVATED and remove the relevant entries in teamparticipation.</p>
+<p>Teams cannot call this method because they're not allowed to
+login and thus can't 'leave' another team. Instead, they have their
+subscription deactivated (using the setMembershipData() method) by
+a team administrator.</p>
+
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>leave</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>team</strong>
+                  </p>
+                </td>
+                <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+                <td>
+                  <p>
+Team
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+          <div class="method">
+            <h5 id="person-setLocation" title="person-setLocation">setLocation</h5>
+            <p>
+Specify the location and time zone of a person.
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>setLocation</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>latitude</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td>
+                  <p>
+The latitude of this object.
+</p>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>longitude</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td>
+                  <p>
+The longitude of this object.
+</p>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>time_zone</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td>
+                  <p>
+The time zone of this object.
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+          <div class="method">
+            <h5 id="person-setLocationVisibility" title="person-setLocationVisibility">setLocationVisibility</h5>
+            <p>
+Specify the visibility of a person's location and time zone.
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>setLocationVisibility</var></p>
+                </td>
+                <td></td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>visible</strong>
+                  </p>
+                </td>
+                <td>
+                  <p></p>
+                </td>
+                <td>
+                  <p>
+Is this location record visible?
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="packagesets" title="packagesets" class="top-level-object">
+        <h3>packagesets</h3>
+        <p>
+An interface for multiple package sets.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/packagesets</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#packageset">packageset</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="packagesets-custom-GETs" title="packagesets-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="packagesets-getByName" title="packagesets-getByName">getByName</h5><p>
+<p>Return the single package set with the given name (if any).</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByName</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>distroseries</strong></p></td><td><p></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td><td><p>
+<p>Distroseries</p>
+<p>The distribution series to which the packageset is related.</p>
+
+</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Package set name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#packageset">packageset</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="packagesets-setsIncludingSource" title="packagesets-setsIncludingSource">setsIncludingSource</h5><p>
+<p>Get the package sets that include this source package.</p>
+<p>Return all package sets that directly or indirectly include the
+given source package name.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>setsIncludingSource</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>direct_inclusion</strong></p></td><td><p></p></td><td></td></tr><tr><td><p><strong>distroseries</strong></p></td><td><p></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td><td><p>
+<p>Distribution series</p>
+<p>The distroseries to which this package set is related.</p>
+
+</p></td></tr><tr><td><p><strong>sourcepackagename</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Source package name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#packageset">packageset</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <div id="packagesets-custom-POSTs" title="packagesets-custom-POSTs" class="methods POSTs">
+          <h4>Custom POST methods</h4>
+          <div class="method"><h5 id="packagesets-new" title="packagesets-new">new</h5><p>
+<p>Create a new package set.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>new</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>description</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Package set description
+</p></td></tr><tr><td><p><strong>distroseries</strong></p></td><td><p></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td><td><p>
+<p>Distroseries</p>
+<p>The distribution series to which the packageset is related.</p>
+
+</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Valid package set name
+</p></td></tr><tr><td><p><strong>owner</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td><p>
+<p>Person</p>
+<p>The person who owns this package set.</p>
+
+</p></td></tr><tr><td><p><strong>related_set</strong></p></td><td><p></p>
+                Link to a <a href="#packageset">packageset</a>.
+            </td><td><p>
+<p>Related package set</p>
+<p>The new package set will share the package set group with this one.</p>
+
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#packageset">packageset</a>.
+        </p>
+          
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="people" title="people" class="top-level-object">
+        <h3>people</h3>
+        <p>
+The set of Persons.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/people</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#person">person</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="people-custom-GETs" title="people-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="people-find" title="people-find">find</h5><p>
+<p>Return all non-merged Persons and Teams whose name, displayname or
+email address match &lt;text&gt;.</p>
+<p>The results will be ordered using the default ordering specified in
+Person._defaultOrder.</p>
+<p>While we don't have Full Text Indexes in the emailaddress table, we'll
+be trying to match the text only against the beginning of an email
+address.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>find</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>text</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Search text
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#person">person</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="people-findPerson" title="people-findPerson">findPerson</h5><p>
+<p>Return all non-merged Persons with at least one email address whose
+name, displayname or email address match &lt;text&gt;.</p>
+<p>If text is an empty string, all persons with at least one email
+address will be returned.</p>
+<p>The results will be ordered using the default ordering specified in
+Person._defaultOrder.</p>
+<p>If exclude_inactive_accounts is True, any accounts whose
+account_status is any of INACTIVE_ACCOUNT_STATUSES will not be in the
+returned set.</p>
+<p>If must_have_email is True, only people with one or more email
+addresses are returned.</p>
+<p>While we don't have Full Text Indexes in the emailaddress table, we'll
+be trying to match the text only against the beginning of an email
+address.</p>
+<p>If created_before or created_after are not None, they are used to
+restrict the search to the dates provided.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>findPerson</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>created_after</strong></p></td><td><p></p></td><td><p>
+Created after
+</p></td></tr><tr><td><p><strong>created_before</strong></p></td><td><p></p></td><td><p>
+Created before
+</p></td></tr><tr><td><p><strong>text</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Search text
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#person">person</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="people-findTeam" title="people-findTeam">findTeam</h5><p>
+<p>Return all Teams whose name, displayname or email address
+match &lt;text&gt;.</p>
+<p>The results will be ordered using the default ordering specified in
+Person._defaultOrder.</p>
+<p>While we don't have Full Text Indexes in the emailaddress table, we'll
+be trying to match the text only against the beginning of an email
+address.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>findTeam</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>text</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Search text
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#person">person</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="people-getByEmail" title="people-getByEmail">getByEmail</h5><p>
+<p>Return the person with the given email address.</p>
+<p>Return None if there is no person with the given email address.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getByEmail</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>email</strong></p></td><td><p><small>(required)</small></p></td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#person">person</a>.
+        </p>
+        </div>
+        </div>
+        <div id="people-custom-POSTs" title="people-custom-POSTs" class="methods POSTs">
+          <h4>Custom POST methods</h4>
+          <div class="method"><h5 id="people-newTeam" title="people-newTeam">newTeam</h5><p>
+Create and return a new Team with given arguments.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>newTeam</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>default_membership_period</strong></p></td><td><p></p></td><td><p>
+<p>Subscription period</p>
+<p>Number of days a new subscription lasts before expiring. You can customize the length of an individual subscription when approving it. Leave this empty or set to 0 for subscriptions to never expire.</p>
+
+</p></td></tr><tr><td><p><strong>default_renewal_period</strong></p></td><td><p></p></td><td><p>
+<p>Renewal period</p>
+<p>Number of days a subscription lasts after being renewed. You can customize the lengths of individual renewals, but this is what's used for auto-renewed and user-renewed memberships.</p>
+
+</p></td></tr><tr><td><p><strong>display_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Display Name</p>
+<p>Your name as you would like it displayed throughout Launchpad. Most people use their full name here.</p>
+
+</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Name</p>
+<p>A short unique name, beginning with a lower-case letter or number, and containing only letters, numbers, dots, hyphens, or plus signs.</p>
+
+</p></td></tr><tr><td><p><strong>subscription_policy</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Moderated Team</tt></li><li><tt>Open Team</tt></li><li><tt>Restricted Team</tt></li></ul></td><td><p>
+Subscription policy
+</p></td></tr><tr><td><p><strong>team_description</strong></p></td><td><p></p></td><td><p>
+<p>Team Description</p>
+<p>Details about the team's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages.</p>
+
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#team">team</a>.
+        </p>
+          
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="pillars" title="pillars" class="top-level-object">
+        <h3>pillars</h3>
+        <p>
+<p>An object for searching across projects, project groups, and distros.</p>
+<p>Projects, project groups, and distributions are collectively known as
+"pillars". This object lets you do a combined search across all
+types of pillars. It also gives you access to pillars that have
+been flagged by administrators as "featured" pillars.</p>
+
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/pillars</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#"></a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="pillars-custom-GETs" title="pillars-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="pillars-search" title="pillars-search">search</h5><p>
+<p>Return Projects/Project groups/Distros matching :text:.</p>
+<p>If :limit: is None, the default batch size will be used.</p>
+<p>The results are ordered descending by rank.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>search</var></p></td><td></td></tr><tr><td><p><strong>limit</strong></p></td><td><p></p></td><td><p>
+Maximum number of items to return. This is a hard limit: any pagination you request will happen within this limit.
+</p></td></tr><tr><td><p><strong>text</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Search text
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#pillar">pillar</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="project_groups" title="project_groups" class="top-level-object">
+        <h3>project_groups</h3>
+        <p>
+The collection of projects.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/project_groups</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#project_group">project_group</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="project_groups-custom-GETs" title="project_groups-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="project_groups-search" title="project_groups-search">search</h5><p>
+Search through the Registry database for projects that match the
+query terms. text is a piece of text in the title / summary /
+description fields of project (and possibly product). soyuz,
+bazaar, malone etc are hints as to whether the search should
+be limited to projects that are active in those Launchpad
+applications.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>search</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>text</strong></p></td><td><p></p></td><td><p>
+Search text
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#project_group">project_group</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="projects" title="projects" class="top-level-object">
+        <h3>projects</h3>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/projects</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#project">project</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="projects-custom-GETs" title="projects-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="projects-latest" title="projects-latest">latest</h5><p>
+<p>Return the latest projects registered in Launchpad.</p>
+<p>If the quantity is not specified or is a value that is not 'None'
+then the set of projects returned is limited to that value (the
+default quantity is 5).  If quantity is 'None' then all projects are
+returned.  For the web service it is not possible to specify the
+quantity, so all projects are returned, latest first.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>latest</var></p></td><td><p>The name of the operation being invoked.</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#project">project</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="projects-licensing_search" title="projects-licensing_search">licensing_search</h5><p>
+Return an iterator over products that need to be reviewed.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>licensing_search</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>active</strong></p></td><td><p></p></td><td><p>
+Is the project active
+</p></td></tr><tr><td><p><strong>created_after</strong></p></td><td><p></p></td><td><p>
+Created after date
+</p></td></tr><tr><td><p><strong>created_before</strong></p></td><td><p></p></td><td><p>
+Created before date
+</p></td></tr><tr><td><p><strong>has_zero_licenses</strong></p></td><td><p></p></td><td><p>
+Has zero licenses
+</p></td></tr><tr><td><p><strong>license_info_is_empty</strong></p></td><td><p></p></td><td><p>
+License info is empty
+</p></td></tr><tr><td><p><strong>license_reviewed</strong></p></td><td><p></p></td><td><p>
+Is the project license reviewed
+</p></td></tr><tr><td><p><strong>licenses</strong></p></td><td><p></p></td><td><p>
+Licenses
+</p></td></tr><tr><td><p><strong>search_text</strong></p></td><td><p></p></td><td><p>
+Search text
+</p></td></tr><tr><td><p><strong>subscription_expires_after</strong></p></td><td><p></p></td><td><p>
+Subscription expires after
+</p></td></tr><tr><td><p><strong>subscription_expires_before</strong></p></td><td><p></p></td><td><p>
+Subscription expired before
+</p></td></tr><tr><td><p><strong>subscription_modified_after</strong></p></td><td><p></p></td><td><p>
+Subscription modified after
+</p></td></tr><tr><td><p><strong>subscription_modified_before</strong></p></td><td><p></p></td><td><p>
+Subscription modified before
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#project">project</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="projects-search" title="projects-search">search</h5><p>
+Search through the Registry database for products that match the
+query terms. text is a piece of text in the title / summary /
+description fields of product. soyuz, bazaar, malone etc are
+hints as to whether the search should be limited to products
+that are active in those Launchpad applications.
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>search</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>text</strong></p></td><td><p></p></td><td><p>
+Search text
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#project">project</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <div id="projects-custom-POSTs" title="projects-custom-POSTs" class="methods POSTs">
+          <h4>Custom POST methods</h4>
+          <div class="method"><h5 id="projects-new_project" title="projects-new_project">new_project</h5><p>
+<p>Create and return a brand new Product.</p>
+<p>See IProduct for a description of the parameters.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>new_project</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>description</strong></p></td><td><p></p></td><td><p>
+<p>Description</p>
+<p>Details about the project's work, highlights, goals, and how to contribute. Use plain text, paragraphs are preserved and URLs are linked in pages. Don't repeat the Summary.</p>
+
+</p></td></tr><tr><td><p><strong>display_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Display Name</p>
+<dl class="rst-docutils">
+<dt>The name of the project as it would appear in a</dt>
+<dd>paragraph.</dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>download_url</strong></p></td><td><p></p></td><td><p>
+<p>Download URL</p>
+<dl class="rst-docutils">
+<dt>The full URL where downloads for this project</dt>
+<dd>are located, if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>freshmeat_project</strong></p></td><td><p></p></td><td><p>
+<p>Freshmeat Project</p>
+<dl class="rst-docutils">
+<dt>The Freshmeat project name for</dt>
+<dd>this project, if it is in freshmeat.</dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>home_page_url</strong></p></td><td><p></p></td><td><p>
+<p>Homepage URL</p>
+<dl class="rst-docutils">
+<dt>The project home page. Please include</dt>
+<dd>the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>license_info</strong></p></td><td><p></p></td><td><p>
+<p>Description of additional licenses</p>
+<p>Description of licenses that do not appear in the list above.</p>
+
+</p></td></tr><tr><td><p><strong>license_reviewed</strong></p></td><td><p></p></td><td><p>
+<p>Project reviewed</p>
+<p>Whether or not this project has been reviewed. If you looked at the project and how it uses Launchpad, you reviewed it.</p>
+
+</p></td></tr><tr><td><p><strong>licenses</strong></p></td><td><p></p></td><td><p>
+Licenses
+</p></td></tr><tr><td><p><strong>name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Name</p>
+<p>At least one lowercase letter or number, followed by letters, numbers, dots, hyphens or pluses. Keep this name short; it is used in URLs as shown above.</p>
+
+</p></td></tr><tr><td><p><strong>programming_lang</strong></p></td><td><p></p></td><td><p>
+<p>Programming Languages</p>
+<dl class="rst-docutils">
+<dt>A comma delimited list of programming</dt>
+<dd>languages used for this project.</dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>project_group</strong></p></td><td><p></p>
+                Link to a <a href="#project_group">project_group</a>.
+            </td><td><p>
+<p>Part of</p>
+<p>Project group. This is an overarching initiative that includes several related projects. For example, the Mozilla Project produces Firefox, Thunderbird and Gecko. This information is used to group those projects in a coherent way. If you make this project part of a group, the group preferences and decisions around bug tracking, translation and security policy will apply to this project.</p>
+
+</p></td></tr><tr><td><p><strong>registrant</strong></p></td><td><p></p>
+                Link to a <a href="#person">person</a>.
+            </td><td><p>
+<p>Registrant</p>
+<p>This person registered the project in Launchpad.</p>
+
+</p></td></tr><tr><td><p><strong>screenshots_url</strong></p></td><td><p></p></td><td><p>
+<p>Screenshots URL</p>
+<dl class="rst-docutils">
+<dt>The full URL for screenshots of this project,</dt>
+<dd>if available. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>sourceforge_project</strong></p></td><td><p></p></td><td><p>
+<p>Sourceforge Project</p>
+<dl class="rst-docutils">
+<dt>The SourceForge project name for</dt>
+<dd>this project, if it is in sourceforge.</dd>
+</dl>
+
+</p></td></tr><tr><td><p><strong>summary</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Summary</p>
+<p>A short paragraph to introduce the project's work.</p>
+
+</p></td></tr><tr><td><p><strong>title</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+<p>Title</p>
+<p>The project title. Should be just a few words.</p>
+
+</p></td></tr><tr><td><p><strong>wiki_url</strong></p></td><td><p></p></td><td><p>
+<p>Wiki URL</p>
+<dl class="rst-docutils">
+<dt>The full URL of this project's wiki, if it has</dt>
+<dd>one. Please include the <a class="rst-reference external" href="http://" target="_top">http://</a></dd>
+</dl>
+
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#project">project</a>.
+        </p>
+          
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="temporary_blobs" title="temporary_blobs" class="top-level-object">
+        <h3>temporary_blobs</h3>
+        <p>
+A tool to create temporary blobs.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/temporary_blobs</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#temporary_blob">temporary_blob</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="temporary_blobs-custom-GETs" title="temporary_blobs-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method">
+            <h5 id="temporary_blobs-fetch" title="temporary_blobs-fetch">fetch</h5>
+            <p>
+Retrieve a TemporaryBlobStorage by uuid.
+</p>
+            <h6>Parameters</h6>
+            <table>
+              <tr>
+                <th>Parameter</th>
+                <th>Value</th>
+                <th>Description</th>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>ws.op</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                  <p>
+                Fixed:
+                <var>fetch</var></p>
+                </td>
+                <td>
+                  <p>The name of the operation being invoked.</p>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <p>
+                    <strong>token</strong>
+                  </p>
+                </td>
+                <td>
+                  <p>
+                    <small>(required)</small>
+                  </p>
+                </td>
+                <td>
+                  <p>
+UUID
+</p>
+                </td>
+              </tr>
+            </table>
+          </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+      <div id="translation_import_queue_entries" title="translation_import_queue_entries" class="top-level-object">
+        <h3>translation_import_queue_entries</h3>
+        <p>
+A set of files to be imported into Rosetta.
+</p>
+        <p>
+          <label>URL:</label>
+          <code>https://api.launchpad.dev/1.0/translation_import_queue_entries</code>
+        </p>
+        <div class="methods standard">
+          <h4>Standard method</h4>
+          <dl>
+            <dt>GET</dt>
+            <dd>Response contains a <a href="#translation_import_queue_entry">translation_import_queue_entry</a>
+                    collection.</dd>
+          </dl>
+        </div>
+        <div id="translation_import_queue_entries-custom-GETs" title="translation_import_queue_entries-custom-GETs" class="methods GETs">
+          <h4>Custom GET methods</h4>
+          <div class="method"><h5 id="translation_import_queue_entries-getAllEntries" title="translation_import_queue_entries-getAllEntries">getAllEntries</h5><p>
+<p>Return all entries this import queue has.</p>
+
+<p>If any of target, status or file_extension are given, the returned
+entries are filtered based on those values.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getAllEntries</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>import_status</strong></p></td><td><p></p></td><td><p>
+The status of the import.
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#translation_import_queue_entry">translation_import_queue_entry</a>
+                    collection
+                .
+        </p>
+        </div>
+          <div class="method"><h5 id="translation_import_queue_entries-getFirstEntryToImport" title="translation_import_queue_entries-getFirstEntryToImport">getFirstEntryToImport</h5><p>
+<p>Return the first entry of the queue ready to be imported.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getFirstEntryToImport</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>target</strong></p></td><td><p></p>
+                Link to a <a href="#object_with_translation_imports">object_with_translation_imports</a>.
+            </td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#translation_import_queue_entry">translation_import_queue_entry</a>.
+        </p>
+        </div>
+          <div class="method"><h5 id="translation_import_queue_entries-getRequestTargets" title="translation_import_queue_entries-getRequestTargets">getRequestTargets</h5><p>
+<p>List Product`s and `DistroSeries with pending imports.</p>
+
+<p>All returned items will implement IHasTranslationImports.</p>
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getRequestTargets</var></p></td><td><p>The name of the operation being invoked.</p></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p></td><td><p>
+The status of the import.
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#object_with_translation_imports">object_with_translation_imports</a>
+                    collection
+                .
+        </p>
+        </div>
+        </div>
+        <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+      </div>
+    </div>
+    <h2 id="entry-types" title="entry-types">Entry types</h2>
+    <h3 id="ScalarValue" title="ScalarValue">ScalarValue</h3>
+    <p>
+      <label>URL:</label>
+      <code>https://api.launchpad.dev/1.0</code>
+    </p>
+    <div class="representation">
+      <h4>Default representation
+                ()</h4>
+      <table>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Description</th>
+        </tr>
+      </table>
+    </div>
+    <div id="ScalarValue-standard-methods" title="ScalarValue-standard-methods" class="methods standard">
+      <h4>Standard methods</h4>
+      <dl>
+        <dt>GET</dt>
+        <dd>Response contains the default
+             representation
+            for this entry.
+        </dd>
+      </dl>
+    </div>
+    <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+    <h3 id="archive" title="archive">archive</h3>
+    <p>
+Main Archive interface.
+</p>
+    <p>
+      <label>URL:</label>
+      <code>https://api.launchpad.dev/1.0/<var>&lt;distribution&gt;</var>/+archive/<var>&lt;archive.name&gt;</var></code>
+    </p>
+    <div class="representation">
+      <h4>Default representation
+                (application/json)</h4>
+      <table>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>commercial</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Commercial Archive</p>
+<p>Set if this archive is used for commercial purposes and should appear in the Software Center listings.  The archive must also be private if this is set.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>dependencies_collection_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#archive_dependency">archive_dependency</a> collection.
+            </td>
+          <td>
+            <p>
+Archive dependencies recorded for this archive.
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>description</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Archive contents description</p>
+<p>A short description of this archive's contents.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>displayname</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Displayname</p>
+<p>Displayname for this archive.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>distribution_link</strong>
+            </p>
+          </td>
+          <td><p><small>(writeable)</small></p>
+                Link to a <a href="#distribution">distribution</a>.
+            </td>
+          <td>
+            <p>
+The distribution that uses or is used by this archive.
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>http_etag</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The value of the HTTP ETag for this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Name</p>
+<p>The name of this archive.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>owner_link</strong>
+            </p>
+          </td>
+          <td><p><small>(writeable)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+          <td>
+            <p>
+<p>Owner</p>
+<p>The archive owner.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>private</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Private</p>
+<p>Whether the archive is private to the owner or not. This can only be changed by launchpad admins or launchpad commercial admins and only if the archive has not had any sources published.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>require_virtualized</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Require Virtualized Builder</p>
+<p>Whether this archive requires its packages to be built on a virtual builder.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>resource_type_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The link to the WADL description of this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>self_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>The canonical link to this resource.</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>signing_key_fingerprint</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Archive signing key fingerprint</p>
+<p>A OpenPGP signing key fingerprint (40 chars) for this PPA or None if there is no signing key available.</p>
+
+</p>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="archive-standard-methods" title="archive-standard-methods" class="methods standard">
+      <h4>Standard methods</h4>
+      <dl>
+        <dt>GET</dt>
+        <dd>Response contains the default
+            <code>application/json</code> representation
+            for this entry.
+        </dd>
+        <dt>PATCH</dt>
+        <dd>Entity body should contain a represention encoded using
+            <code>application/json</code> of the entry
+            fields to update. Any fields of the default representation marked
+            as writeable can be included.
+        </dd>
+        <dt>PUT</dt>
+        <dd>Entity body should contain a representation encoded using
+            <code>application/json</code> of the entry.
+            All fields of the default representation should be included. Only
+            fields marked as writeable in the default representation should be
+            modified.
+        </dd>
+      </dl>
+    </div>
+    <div id="archive-custom-GETs" title="archive-custom-GETs" class="methods GETs">
+      <h4>Custom GET methods</h4>
+      <div class="method">
+        <h5 id="archive-checkUpload" title="archive-checkUpload">checkUpload</h5>
+        <p>
+Wrapper around checkUpload for the web service API.
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>checkUpload</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>component</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Component
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>distroseries</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td>
+            <td>
+              <p>
+The distro series
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>person</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>pocket</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                <em>One of:</em>
+              </p>
+              <ul>
+                <li>
+                  <tt>Release</tt>
+                </li>
+                <li>
+                  <tt>Security</tt>
+                </li>
+                <li>
+                  <tt>Updates</tt>
+                </li>
+                <li>
+                  <tt>Proposed</tt>
+                </li>
+                <li>
+                  <tt>Backports</tt>
+                </li>
+              </ul>
+            </td>
+            <td>
+              <p>
+<p>Pocket</p>
+<p>The pocket into which this entry is published</p>
+
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>sourcepackagename</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Source package name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>strict_component</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+Strict component
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="method"><h5 id="archive-getArchiveDependency" title="archive-getArchiveDependency">getArchiveDependency</h5><p>
+<p>Return the IArchiveDependency object for the given dependency.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getArchiveDependency</var></p></td><td></td></tr><tr><td><p><strong>dependency</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_dependency">archive_dependency</a>.
+        </p>
+        </div>
+      <div class="method">
+        <h5 id="archive-getBuildCounters" title="archive-getBuildCounters">getBuildCounters</h5>
+        <p>
+<p>Return a dictionary containing the build counters for an archive.</p>
+<p>This is necessary currently because the IArchive.failed_builds etc.
+counters are not in use.</p>
+<p>The returned dictionary contains the follwoing keys and values:</p>
+<blockquote>
+<ul class="rst-simple">
+<li>'total': total number of builds (includes SUPERSEDED);</li>
+<li>'pending': number of builds in BUILDING or NEEDSBUILD state;</li>
+<li>'failed': number of builds in FAILEDTOBUILD, MANUALDEPWAIT,
+CHROOTWAIT and FAILEDTOUPLOAD state;</li>
+<li>'succeeded': number of SUCCESSFULLYBUILT builds.</li>
+<li>'superseded': number of SUPERSEDED builds.</li>
+</ul>
+</blockquote>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>getBuildCounters</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>include_needsbuild</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+Include builds with state NEEDSBUILD
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="method"><h5 id="archive-getBuildRecords" title="archive-getBuildRecords">getBuildRecords</h5><p>
+<p>Return build records in the context it is implemented.</p>
+<p>It excludes build records generated by Gina (imported from a external
+repository), where IBuild.datebuilt is null and IBuild.buildstate
+is BuildStatus.FULLYBUILT.</p>
+<p>The result is simply not filtered if the optional filters are omitted
+by call sites.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getBuildRecords</var></p></td><td></td></tr><tr><td><p><strong>build_state</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Needs building</tt></li><li><tt>Successfully built</tt></li><li><tt>Failed to build</tt></li><li><tt>Dependency wait</tt></li><li><tt>Chroot problem</tt></li><li><tt>Build for superseded Source</tt></li><li><tt>Currently building</tt></li><li><tt>Failed to upload</tt></li></ul></td><td><p>
+<p>Build status</p>
+<p>The status of this build record</p>
+
+</p></td></tr><tr><td><p><strong>pocket</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Release</tt></li><li><tt>Security</tt></li><li><tt>Updates</tt></li><li><tt>Proposed</tt></li><li><tt>Backports</tt></li></ul></td><td><p>
+<p>Pocket</p>
+<p>The pocket into which this entry is published</p>
+
+</p></td></tr><tr><td><p><strong>source_name</strong></p></td><td><p></p></td><td><p>
+Source package name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#build">build</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method">
+        <h5 id="archive-getBuildSummariesForSourceIds" title="archive-getBuildSummariesForSourceIds">getBuildSummariesForSourceIds</h5>
+        <p>
+<p>Return a dictionary containing a summary of the build statuses.</p>
+<p>Only information for sources belonging to the current archive will
+be returned. See
+IPublishingSet.getBuildStatusSummariesForSourceIdsAndArchive() for
+details.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>getBuildSummariesForSourceIds</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>source_ids</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+A list of source publishing history record ids.
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="method"><h5 id="archive-getComponentsForQueueAdmin" title="archive-getComponentsForQueueAdmin">getComponentsForQueueAdmin</h5><p>
+<p>Return IArchivePermission for the person's queue admin components</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getComponentsForQueueAdmin</var></p></td><td></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getPackagesetsForSource" title="archive-getPackagesetsForSource">getPackagesetsForSource</h5><p>
+<p>All package set based permissions for the given source.</p>
+<p>This method is meant to aid the process of "debugging" package set
+based archive permission since It allows the listing of permissions
+for the given source package in this archive (irrespective of the
+principal).</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPackagesetsForSource</var></p></td><td></td></tr><tr><td><p><strong>direct_permissions</strong></p></td><td><p></p></td><td><p>
+Ignore package set hierarchy
+</p></td></tr><tr><td><p><strong>sourcepackagename</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Source package name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getPackagesetsForSourceUploader" title="archive-getPackagesetsForSourceUploader">getPackagesetsForSourceUploader</h5><p>
+<p>The package set based permissions for a given source and uploader.</p>
+<dl class="rst-docutils">
+<dt>Return the IArchivePermission records that</dt>
+<dd><ul class="rst-first rst-last">
+<li><p class="rst-first">apply to this archive</p>
+</li>
+<li><dl class="rst-first rst-docutils">
+<dt>relate to</dt>
+<dd><ul class="rst-first rst-last rst-simple">
+<li>package sets that include the given source package name</li>
+<li>the given person</li>
+</ul>
+</dd>
+</dl>
+</li>
+</ul>
+</dd>
+</dl>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPackagesetsForSourceUploader</var></p></td><td></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>sourcepackagename</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Source package name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getPackagesetsForUploader" title="archive-getPackagesetsForUploader">getPackagesetsForUploader</h5><p>
+<p>The ArchivePermission records for the person's package sets.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPackagesetsForUploader</var></p></td><td></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getPermissionsForPerson" title="archive-getPermissionsForPerson">getPermissionsForPerson</h5><p>
+<p>Return the IArchivePermission records applicable to the person.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPermissionsForPerson</var></p></td><td></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getPublishedBinaries" title="archive-getPublishedBinaries">getPublishedBinaries</h5><p>
+<p>All IBinaryPackagePublishingHistory target to this archive.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPublishedBinaries</var></p></td><td></td></tr><tr><td><p><strong>binary_name</strong></p></td><td><p></p></td><td><p>
+Binary Package Name
+</p></td></tr><tr><td><p><strong>distro_arch_series</strong></p></td><td><p></p>
+                Link to a <a href="#distro_arch_series">distro_arch_series</a>.
+            </td><td><p>
+Distro Arch Series
+</p></td></tr><tr><td><p><strong>exact_match</strong></p></td><td><p></p></td><td><p>
+Whether or not to filter binary names by exact matching.
+</p></td></tr><tr><td><p><strong>pocket</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Release</tt></li><li><tt>Security</tt></li><li><tt>Updates</tt></li><li><tt>Proposed</tt></li><li><tt>Backports</tt></li></ul></td><td><p>
+<p>Pocket</p>
+<p>The pocket into which this entry is published</p>
+
+</p></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Pending</tt></li><li><tt>Published</tt></li><li><tt>Superseded</tt></li><li><tt>Deleted</tt></li><li><tt>Obsolete</tt></li></ul></td><td><p>
+<p>Package Publishing Status</p>
+<p>The status of this publishing record</p>
+
+</p></td></tr><tr><td><p><strong>version</strong></p></td><td><p></p></td><td><p>
+Version
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#binary_package_publishing_history">binary_package_publishing_history</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getPublishedSources" title="archive-getPublishedSources">getPublishedSources</h5><p>
+<p>All ISourcePackagePublishingHistory target to this archive.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getPublishedSources</var></p></td><td></td></tr><tr><td><p><strong>created_since_date</strong></p></td><td><p></p></td><td><p>
+<p>Created Since Date</p>
+<p>Return entries whose date_created is greater than or equal to this date.</p>
+
+</p></td></tr><tr><td><p><strong>distro_series</strong></p></td><td><p></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td><td><p>
+Distroseries name
+</p></td></tr><tr><td><p><strong>exact_match</strong></p></td><td><p></p></td><td><p>
+<p>Exact Match</p>
+<p>Whether or not to filter source names by exact matching.</p>
+
+</p></td></tr><tr><td><p><strong>pocket</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Release</tt></li><li><tt>Security</tt></li><li><tt>Updates</tt></li><li><tt>Proposed</tt></li><li><tt>Backports</tt></li></ul></td><td><p>
+<p>Pocket</p>
+<p>The pocket into which this entry is published</p>
+
+</p></td></tr><tr><td><p><strong>source_name</strong></p></td><td><p></p></td><td><p>
+Source package name
+</p></td></tr><tr><td><p><strong>status</strong></p></td><td><p></p><p><em>One of:</em></p><ul><li><tt>Pending</tt></li><li><tt>Published</tt></li><li><tt>Superseded</tt></li><li><tt>Deleted</tt></li><li><tt>Obsolete</tt></li></ul></td><td><p>
+<p>Package Publishing Status</p>
+<p>The status of this publishing record</p>
+
+</p></td></tr><tr><td><p><strong>version</strong></p></td><td><p></p></td><td><p>
+Version
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#source_package_publishing_history">source_package_publishing_history</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getQueueAdminsForComponent" title="archive-getQueueAdminsForComponent">getQueueAdminsForComponent</h5><p>
+<p>Return IArchivePermission records for authorised queue admins.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getQueueAdminsForComponent</var></p></td><td></td></tr><tr><td><p><strong>component_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Component Name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getUploadersForComponent" title="archive-getUploadersForComponent">getUploadersForComponent</h5><p>
+<p>Return IArchivePermission records for the component's uploaders.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getUploadersForComponent</var></p></td><td></td></tr><tr><td><p><strong>component_name</strong></p></td><td><p></p></td><td><p>
+Component Name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getUploadersForPackage" title="archive-getUploadersForPackage">getUploadersForPackage</h5><p>
+<p>Return IArchivePermission records for the package's uploaders.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getUploadersForPackage</var></p></td><td></td></tr><tr><td><p><strong>source_package_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Source Package Name
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method"><h5 id="archive-getUploadersForPackageset" title="archive-getUploadersForPackageset">getUploadersForPackageset</h5><p>
+<p>The ArchivePermission records for uploaders to the package set.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>getUploadersForPackageset</var></p></td><td></td></tr><tr><td><p><strong>direct_permissions</strong></p></td><td><p></p></td><td><p>
+Ignore package set hierarchy
+</p></td></tr><tr><td><p><strong>packageset</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#packageset">packageset</a>.
+            </td><td><p>
+Package set
+</p></td></tr></table>
+          
+          <p class="response">Response contains an
+            <code>application/json</code>
+            representation of a
+            <a href="#archive_permission">archive_permission</a>
+                    collection
+                .
+        </p>
+        </div>
+      <div class="method">
+        <h5 id="archive-isSourceUploadAllowed" title="archive-isSourceUploadAllowed">isSourceUploadAllowed</h5>
+        <p>
+<p>True if the person is allowed to upload the given source package.</p>
+<dl class="rst-docutils">
+<dt>Return True if there exists a permission that combines</dt>
+<dd><ul class="rst-first rst-last rst-simple">
+<li>this archive</li>
+<li>a package set that includes the given source package name</li>
+<li>the given person or a team he is a member of</li>
+</ul>
+</dd>
+</dl>
+<p>If the source package name is included by <em>any</em> package set with
+an explicit permission then only such explicit permissions will
+be considered.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>isSourceUploadAllowed</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>distroseries</strong>
+              </p>
+            </td>
+            <td><p></p>
+                Link to a <a href="#distro_series">distro_series</a>.
+            </td>
+            <td>
+              <p>
+The distro series
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>person</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>sourcepackagename</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Source package name
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+    </div>
+    <div id="archive-custom-POSTs" title="archive-custom-POSTs" class="methods POSTs">
+      <h4>Custom POST methods</h4>
+      <div class="method">
+        <h5 id="archive-deleteComponentUploader" title="archive-deleteComponentUploader">deleteComponentUploader</h5>
+        <p>
+<p>Revoke permission for the person to upload to the component.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>deleteComponentUploader</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>component_name</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Component Name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>person</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+            <td></td>
+          </tr>
+        </table>
+      </div>
+      <div class="method">
+        <h5 id="archive-deletePackageUploader" title="archive-deletePackageUploader">deletePackageUploader</h5>
+        <p>
+<p>Revoke permission for the person to upload the package.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>deletePackageUploader</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>person</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>source_package_name</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Source Package Name
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="method">
+        <h5 id="archive-deletePackagesetUploader" title="archive-deletePackagesetUploader">deletePackagesetUploader</h5>
+        <p>
+<p>Revoke upload permissions for a person.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>deletePackagesetUploader</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>explicit</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+Explicit
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>packageset</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#packageset">packageset</a>.
+            </td>
+            <td>
+              <p>
+Package set
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>person</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+            <td></td>
+          </tr>
+        </table>
+      </div>
+      <div class="method">
+        <h5 id="archive-deleteQueueAdmin" title="archive-deleteQueueAdmin">deleteQueueAdmin</h5>
+        <p>
+<p>Revoke permission for the person to administer distroseries queues.</p>
+<p>The supplied person will lose permission to administer the
+distroseries queue for packages in the supplied component.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>deleteQueueAdmin</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>component_name</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Component Name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>person</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+            <td></td>
+          </tr>
+        </table>
+      </div>
+      <div class="method"><h5 id="archive-newComponentUploader" title="archive-newComponentUploader">newComponentUploader</h5><p>
+<p>Add permission for a person to upload to a component.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>newComponentUploader</var></p></td><td></td></tr><tr><td><p><strong>component_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Component Name
+</p></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#archive_permission">archive_permission</a>.
+        </p>
+          
+        </div>
+      <div class="method"><h5 id="archive-newPackageUploader" title="archive-newPackageUploader">newPackageUploader</h5><p>
+<p>Add permisson for a person to upload a package to this archive.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>newPackageUploader</var></p></td><td></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr><tr><td><p><strong>source_package_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Source Package Name
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#archive_permission">archive_permission</a>.
+        </p>
+          
+        </div>
+      <div class="method"><h5 id="archive-newPackagesetUploader" title="archive-newPackagesetUploader">newPackagesetUploader</h5><p>
+<p>Add a package set based permission for a person.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>newPackagesetUploader</var></p></td><td></td></tr><tr><td><p><strong>explicit</strong></p></td><td><p></p></td><td><p>
+Explicit
+</p></td></tr><tr><td><p><strong>packageset</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#packageset">packageset</a>.
+            </td><td><p>
+Package set
+</p></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#archive_permission">archive_permission</a>.
+        </p>
+          
+        </div>
+      <div class="method"><h5 id="archive-newQueueAdmin" title="archive-newQueueAdmin">newQueueAdmin</h5><p>
+<p>Add permission for a person to administer a distroseries queue.</p>
+<p>The supplied person will gain permission to administer the
+distroseries queue for packages in the supplied component.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>newQueueAdmin</var></p></td><td></td></tr><tr><td><p><strong>component_name</strong></p></td><td><p><small>(required)</small></p></td><td><p>
+Component Name
+</p></td></tr><tr><td><p><strong>person</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#archive_permission">archive_permission</a>.
+        </p>
+          
+        </div>
+      <div class="method"><h5 id="archive-newSubscription" title="archive-newSubscription">newSubscription</h5><p>
+<p>Create a new subscribtion to this archive.</p>
+<p>Create an ArchiveSubscriber record which allows an IPerson to
+access a private repository.</p>
+
+
+</p><h6>Parameters</h6><table><tr><th>Parameter</th><th>Value</th><th>Description</th></tr><tr><td><p><strong>ws.op</strong></p></td><td><p><small>(required)</small></p><p>
+                Fixed:
+                <var>newSubscription</var></p></td><td></td></tr><tr><td><p><strong>date_expires</strong></p></td><td><p></p></td><td><p>
+<p>Date of Expiration</p>
+<p>The timestamp when the subscription will expire.</p>
+
+</p></td></tr><tr><td><p><strong>description</strong></p></td><td><p></p></td><td><p>
+<p>Description</p>
+<p>Free text describing this subscription.</p>
+
+</p></td></tr><tr><td><p><strong>subscriber</strong></p></td><td><p><small>(required)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td><td><p>
+<p>Subscriber</p>
+<p>The person who is subscribed.</p>
+
+</p></td></tr></table>
+          <p>On success, the response status will be 201 and the
+            <var>Location</var> header will contain the link to the newly
+            created <a href="#archive_subscriber">archive_subscriber</a>.
+        </p>
+          
+        </div>
+      <div class="method">
+        <h5 id="archive-syncSource" title="archive-syncSource">syncSource</h5>
+        <p>
+<p>Synchronise (copy) a single named source into this archive.</p>
+<p>Copy a specific version of a named source to the destination
+archive if necessary.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>syncSource</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>from_archive</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>include_binaries</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+<p>Include Binaries</p>
+<p>Whether or not to copy binaries already built for this source</p>
+
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>source_name</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Source package name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>to_pocket</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Pocket name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>to_series</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+Distroseries name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>version</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Version
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+      <div class="method">
+        <h5 id="archive-syncSources" title="archive-syncSources">syncSources</h5>
+        <p>
+<p>Synchronise (copy) named sources into this archive from another.</p>
+<p>It will copy the most recent PUBLISHED versions of the named
+sources to the destination archive if necessary.</p>
+<p>This operation will only succeeds when all requested packages
+are synchronised between the archives. If any of the requested
+copies cannot be performed, the whole operation will fail. There
+will be no partial changes of the destination archive.</p>
+
+
+</p>
+        <h6>Parameters</h6>
+        <table>
+          <tr>
+            <th>Parameter</th>
+            <th>Value</th>
+            <th>Description</th>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>ws.op</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+              <p>
+                Fixed:
+                <var>syncSources</var></p>
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>from_archive</strong>
+              </p>
+            </td>
+            <td><p><small>(required)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+            <td></td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>include_binaries</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+<p>Include Binaries</p>
+<p>Whether or not to copy binaries already built for this source</p>
+
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>source_names</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Source package names
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>to_pocket</strong>
+              </p>
+            </td>
+            <td>
+              <p>
+                <small>(required)</small>
+              </p>
+            </td>
+            <td>
+              <p>
+Pocket name
+</p>
+            </td>
+          </tr>
+          <tr>
+            <td>
+              <p>
+                <strong>to_series</strong>
+              </p>
+            </td>
+            <td>
+              <p></p>
+            </td>
+            <td>
+              <p>
+Distroseries name
+</p>
+            </td>
+          </tr>
+        </table>
+      </div>
+    </div>
+    <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+    <h3 id="archive_dependency" title="archive_dependency">archive_dependency</h3>
+    <p>
+ArchiveDependency interface.
+</p>
+    <p>
+      <label>URL:</label>
+      <code>https://api.launchpad.dev/1.0</code>
+    </p>
+    <div class="representation">
+      <h4>Default representation
+                (application/json)</h4>
+      <table>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>archive_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+          <td>
+            <p>
+<p>Target archive</p>
+<p>The archive affected by this dependecy.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>component_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Component name
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_created</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Instant when the dependency was created.
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>dependency_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+          <td>
+            <p>
+The archive set as a dependency.
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>http_etag</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The value of the HTTP ETag for this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>pocket</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+            <p>
+              <em>One of:</em>
+            </p>
+            <ul>
+              <li>
+                <tt>Release</tt>
+              </li>
+              <li>
+                <tt>Security</tt>
+              </li>
+              <li>
+                <tt>Updates</tt>
+              </li>
+              <li>
+                <tt>Proposed</tt>
+              </li>
+              <li>
+                <tt>Backports</tt>
+              </li>
+            </ul>
+          </td>
+          <td>
+            <p>
+Pocket
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>resource_type_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The link to the WADL description of this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>self_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>The canonical link to this resource.</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>title</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Archive dependency title.
+</p>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="archive_dependency-standard-methods" title="archive_dependency-standard-methods" class="methods standard">
+      <h4>Standard methods</h4>
+      <dl>
+        <dt>GET</dt>
+        <dd>Response contains the default
+            <code>application/json</code> representation
+            for this entry.
+        </dd>
+        <dt>PATCH</dt>
+        <dd>Entity body should contain a represention encoded using
+            <code>application/json</code> of the entry
+            fields to update. Any fields of the default representation marked
+            as writeable can be included.
+        </dd>
+        <dt>PUT</dt>
+        <dd>Entity body should contain a representation encoded using
+            <code>application/json</code> of the entry.
+            All fields of the default representation should be included. Only
+            fields marked as writeable in the default representation should be
+            modified.
+        </dd>
+      </dl>
+    </div>
+    <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+    <h3 id="archive_permission" title="archive_permission">archive_permission</h3>
+    <p>
+The interface for ArchivePermission.
+</p>
+    <p>
+      <label>URL:</label>
+      <code>https://api.launchpad.dev/1.0/<var>&lt;archive.distribution&gt;</var>/+archive/<var>&lt;archive.name&gt;</var>/+name/person.name.[component or source package].name</code>
+    </p>
+    <div class="representation">
+      <h4>Default representation
+                (application/json)</h4>
+      <table>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>archive_link</strong>
+            </p>
+          </td>
+          <td><p><small>(writeable)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+          <td>
+            <p>
+<p>Archive</p>
+<p>The archive that this permission is for.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>component_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Component Name
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_created</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Created</p>
+<p>The timestamp when the permission was created.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>distro_series_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+The name of the distro series associated with the package set.
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>explicit</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Explicit</p>
+<p>Set this flag for package sets with high-profile packages requiring specialist skills for proper handling.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>http_etag</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The value of the HTTP ETag for this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>package_set_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Package set name
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>permission</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+The permission type being granted.
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>person_link</strong>
+            </p>
+          </td>
+          <td><p><small>(writeable)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+          <td>
+            <p>
+<p>Person</p>
+<p>The person or team being granted the permission.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>resource_type_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The link to the WADL description of this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>self_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>The canonical link to this resource.</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>source_package_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Source Package Name
+</p>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="archive_permission-standard-methods" title="archive_permission-standard-methods" class="methods standard">
+      <h4>Standard methods</h4>
+      <dl>
+        <dt>GET</dt>
+        <dd>Response contains the default
+            <code>application/json</code> representation
+            for this entry.
+        </dd>
+        <dt>PATCH</dt>
+        <dd>Entity body should contain a represention encoded using
+            <code>application/json</code> of the entry
+            fields to update. Any fields of the default representation marked
+            as writeable can be included.
+        </dd>
+        <dt>PUT</dt>
+        <dd>Entity body should contain a representation encoded using
+            <code>application/json</code> of the entry.
+            All fields of the default representation should be included. Only
+            fields marked as writeable in the default representation should be
+            modified.
+        </dd>
+      </dl>
+    </div>
+    <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+    <h3 id="archive_subscriber" title="archive_subscriber">archive_subscriber</h3>
+    <p>
+An interface for archive subscribers.
+</p>
+    <p>
+      <label>URL:</label>
+      <code>https://api.launchpad.dev/1.0</code>
+    </p>
+    <div class="representation">
+      <h4>Default representation
+                (application/json)</h4>
+      <table>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>archive_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+          <td>
+            <p>
+<p>Archive</p>
+<p>The archive for this subscription.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_created</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Created</p>
+<p>The timestamp when the subscription was created.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_expires</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date of Expiration</p>
+<p>The timestamp when the subscription will expire.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>description</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Description</p>
+<p>Free text describing this subscription.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>http_etag</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The value of the HTTP ETag for this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>registrant_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+          <td>
+            <p>
+<p>Registrant</p>
+<p>The person who registered this subscription.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>resource_type_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The link to the WADL description of this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>self_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>The canonical link to this resource.</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>status</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+            <p>
+              <em>One of:</em>
+            </p>
+            <ul>
+              <li>
+                <tt>Active</tt>
+              </li>
+              <li>
+                <tt>Expired</tt>
+              </li>
+              <li>
+                <tt>Cancelled</tt>
+              </li>
+            </ul>
+          </td>
+          <td>
+            <p>
+<p>Status</p>
+<p>The status of this subscription.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>subscriber_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+          <td>
+            <p>
+<p>Subscriber</p>
+<p>The person who is subscribed.</p>
+
+</p>
+          </td>
+        </tr>
+      </table>
+    </div>
+    <div id="archive_subscriber-standard-methods" title="archive_subscriber-standard-methods" class="methods standard">
+      <h4>Standard methods</h4>
+      <dl>
+        <dt>GET</dt>
+        <dd>Response contains the default
+            <code>application/json</code> representation
+            for this entry.
+        </dd>
+        <dt>PATCH</dt>
+        <dd>Entity body should contain a represention encoded using
+            <code>application/json</code> of the entry
+            fields to update. Any fields of the default representation marked
+            as writeable can be included.
+        </dd>
+        <dt>PUT</dt>
+        <dd>Entity body should contain a representation encoded using
+            <code>application/json</code> of the entry.
+            All fields of the default representation should be included. Only
+            fields marked as writeable in the default representation should be
+            modified.
+        </dd>
+      </dl>
+    </div>
+    <a href="#toc" class="toc-link">(back to Table of Contents)</a>
+    <h3 id="binary_package_publishing_history" title="binary_package_publishing_history">binary_package_publishing_history</h3>
+    <p>
+A binary package publishing record.
+</p>
+    <p>
+      <label>URL:</label>
+      <code>https://api.launchpad.dev/1.0/<var>&lt;distribution.name&gt;</var>/+archive/<var>&lt;binary_package.name&gt;</var>/+binarypub/<var>&lt;id&gt;</var></code>
+    </p>
+    <div class="representation">
+      <h4>Default representation
+                (application/json)</h4>
+      <table>
+        <tr>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Description</th>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>archive_link</strong>
+            </p>
+          </td>
+          <td><p><small>(read-only)</small></p>
+                Link to a <a href="#archive">archive</a>.
+            </td>
+          <td>
+            <p>
+<p>Archive</p>
+<p>The context archive for this publication.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>binary_package_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Binary Package Name
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>binary_package_version</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Binary Package Version
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>component_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Component Name
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_created</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Created</p>
+<p>The date on which this record was created</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_made_pending</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Made Pending</p>
+<p>The date on which this record was set as pending removal</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_published</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Published</p>
+<p>The date on which this record was published</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_removed</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Removed</p>
+<p>The date on which this record was removed from the published set</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>date_superseded</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Date Superseded</p>
+<p>The date on which this record was marked superseded</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>display_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Display Name</p>
+<p>Text representation of the current record.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>distro_arch_series_link</strong>
+            </p>
+          </td>
+          <td><p><small>(writeable)</small></p>
+                Link to a <a href="#distro_arch_series">distro_arch_series</a>.
+            </td>
+          <td>
+            <p>
+<p>Distro Arch Series</p>
+<p>The distroarchseries being published into</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>http_etag</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The value of the HTTP ETag for this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>pocket</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+            <p>
+              <em>One of:</em>
+            </p>
+            <ul>
+              <li>
+                <tt>Release</tt>
+              </li>
+              <li>
+                <tt>Security</tt>
+              </li>
+              <li>
+                <tt>Updates</tt>
+              </li>
+              <li>
+                <tt>Proposed</tt>
+              </li>
+              <li>
+                <tt>Backports</tt>
+              </li>
+            </ul>
+          </td>
+          <td>
+            <p>
+<p>Pocket</p>
+<p>The pocket into which this entry is published</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>priority_name</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+Priority Name
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>removal_comment</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+<p>Removal Comment</p>
+<p>Reason why this publication is going to be removed.</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>removed_by_link</strong>
+            </p>
+          </td>
+          <td><p><small>(writeable)</small></p>
+                Link to a <a href="#person">person</a>.
+            </td>
+          <td>
+            <p>
+<p>Removed By</p>
+<p>The Person responsible for the removal</p>
+
+</p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>resource_type_link</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(read-only)</small>
+            </p>
+          </td>
+          <td>
+            <p>
+          The link to the WADL description of this resource.
+        </p>
+          </td>
+        </tr>
+        <tr>
+          <td>
+            <p>
+              <strong>scheduled_deletion_date</strong>
+            </p>
+          </td>
+          <td>
+            <p>
+              <small>(writeable)</small>