jira-rest-plugin.wadl

<?xml version="1.0" encoding="UTF-8"?>
<ns2:application
        xmlns:ns2="http://research.sun.com/wadl/2006/10"><ns2:doc
        jersey:generatedBy="Jersey: 1.8 06/24/2011 12:17 PM"
        xmlns:jersey="http://jersey.java.net/"/><ns2:doc
        title="JIRA 6.1.7 REST API documentation"
        xml:lang="en"><![CDATA[
        This documents the current REST API provided by JIRA.
    ]]></ns2:doc><ns2:grammars/><ns2:resources
            base="http://example.com:8080/jira/rest/"><ns2:resource
                path="api/2/search"><ns2:doc><![CDATA[Resource for searches.]]></ns2:doc><ns2:method
                id="search"
                        name="GET"><ns2:doc><![CDATA[Searches for issues using JQL.

 <p><b>Sorting</b>
  the <code>jql</code> parameter is a full <a href="http://confluence.atlassian.com/display/JIRA/Advanced+Searching">JQL</a>
  expression, and includes an <code>ORDER BY</code> clause.
 </p>

 <p>
  The <code>fields</code> param (which can be specified multiple times) gives a comma-separated list of fields
  to include in the response. This can be used to retrieve a subset of fields.
  A particular field can be excluded by prefixing it with a minus.
  <p>
   By default, only navigable (<code>*navigable</code>) fields are returned in this search resource. Note: the default is different
   in the get-issue resource -- the default there all fields (<code>*all</code>).
  <ul>
      <li><code>*all</code> - include all fields</li>
      <li><code>*navigable</code> - include just navigable fields</li>
      <li><code>summary,comment</code> - include just the summary and comments</li>
      <li><code>-description</code> - include navigable fields except the description (the default is <code>*navigable</code> for search)</li>
      <li><code>*all,-comment</code> - include everything except comments</li>
  </ul>

 </p>
 <p><b>GET vs POST:</b>
  If the JQL query is too large to be encoded as a query param you should instead
  POST to this resource.
 </p>

 <p><b>Expanding Issues in the Search Result:</b>
  It is possible to expand the issues returned by directly specifying the expansion on the expand parameter passed
  in to this resources.
 </p>
 <p>
  For instance, to expand the &quot;changelog&quot; for all the issues on the search result, it is neccesary to
  specify &quot;changelog&quot; as one of the values to expand.
 </p>]]></ns2:doc><ns2:request><ns2:param
                        name="jql" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a JQL query string]]></ns2:doc></ns2:param><ns2:param
                        name="startAt" style="query" type="xs:int"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first issue to return (0-based)]]></ns2:doc></ns2:param><ns2:param
                        name="maxResults" style="query" type="xs:int"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of issues to return (defaults to 50). The maximum allowable value is
 dictated by the JIRA property 'jira.search.views.default.max'. If you specify a value that is higher than this
 number, your search results will be truncated.]]></ns2:doc></ns2:param><ns2:param
                        name="validateQuery" style="query"
                        type="xs:boolean" default="true"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[whether to validate the JQL query]]></ns2:doc></ns2:param><ns2:param
                        name="fields" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the list of fields to return for each issue. By default, all navigable fields are returned.]]></ns2:doc></ns2:param><ns2:param
                        name="expand" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A comma-separated list of the parameters to expand.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        element="searchResults" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"expand":"names,schema","startAt":0,"maxResults":50,"total":1,"issues":[{"expand":"","id":"10001","self":"http://www.example.com/jira/rest/api/2/issue/10001","key":"HSP-1"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of the search results.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if there is a problem with the JQL query.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="searchUsingSearchRequest"
                        name="POST"><ns2:doc><![CDATA[Performs a search using JQL.]]></ns2:doc><ns2:request><ns2:representation
                        element="searchRequest"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"jql":"project = HSP","startAt":0,"maxResults":15,"fields":["summary","status","assignee"]}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        element="searchResults" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"expand":"names,schema","startAt":0,"maxResults":50,"total":1,"issues":[{"expand":"","id":"10001","self":"http://www.example.com/jira/rest/api/2/issue/10001","key":"HSP-1"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of the search results.]]></ns2:doc></ns2:representation><ns2:representation
            status="400"><ns2:doc><![CDATA[Returned if there is a problem with the JQL query.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/issue/{issueIdOrKey}/attachments"><ns2:doc><![CDATA[Issue attachments]]></ns2:doc><ns2:param
                name="issueIdOrKey" style="template" type="xs:string"
                xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue that you want to add the attachments to]]></ns2:doc></ns2:param><ns2:method
                id="addAttachment"
                        name="POST"><ns2:doc><![CDATA[Add one or more attachments to an issue.
 <p>
 This resource expects a multipart post. The media-type multipart/form-data is defined in RFC 1867. Most client
 libraries have classes that make dealing with multipart posts simple. For instance, in Java the Apache HTTP Components
 library provides a
 <a href="http://hc.apache.org/httpcomponents-client-ga/httpmime/apidocs/org/apache/http/entity/mime/MultipartEntity.html">MultiPartEntity</a>
 that makes it simple to submit a multipart POST.
 <p>
 In order to protect against XSRF attacks, because this method accepts multipart/form-data, it has XSRF protection
 on it.  This means you must submit a header of X-Atlassian-Token: nocheck with the request, otherwise it will be
 blocked.
 <p>
     The name of the multipart/form-data parameter that contains attachments must be "file"
 <p>
     A simple example to upload a file called "myfile.txt" to issue REST-123:
     <pre>curl -D- -u admin:admin -X POST -H "X-Atlassian-Token: nocheck" -F "file=@myfile.txt" http://myhost/rest/api/2/issue/TEST-123/attachments</pre>]]></ns2:doc><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the requested issue is not found, the user does not have permission to view it, or if the
      attachments exceeds the maximum configured attachment size.]]></ns2:doc></ns2:representation><ns2:representation
                        status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2.0/attachments/10000","filename":"picture.jpg","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"created":"2014-01-28T14:29:00.005+0100","size":23123,"mimeType":"image/jpeg","content":"http://www.example.com/jira/attachments/10000","thumbnail":"http://www.example.com/jira/secure/thumbnail/10000"},{"self":"http://www.example.com/jira/rest/api/2.0/attachments/10001","filename":"dbeuglog.txt","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"created":"2014-01-28T14:29:00.005+0100","size":2460,"mimeType":"text/plain","content":"http://www.example.com/jira/attachments/10001","thumbnail":"http://www.example.com/jira/secure/thumbnail/10002"}]</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation><ns2:representation
            status="403"><ns2:doc><![CDATA[Returned if attachments is disabled or if you don't have permission to add attachments to this issue.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/project"><ns2:method id="getAllProjects"
                        name="GET"><ns2:doc><![CDATA[Returns all projects which are visible for the currently logged in user. If no user is logged in, it returns the
 list of projects that are visible when using anonymous access.]]></ns2:doc><ns2:response><ns2:representation
                        element="projects" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/project/EX","id":"10000","key":"EX","name":"Example","avatarUrls":{"24x24":"http://www.example.com/jira/secure/projectavatar?size=small&amp;pid=10000","16x16":"http://www.example.com/jira/secure/projectavatar?size=xsmall&amp;pid=10000","32x32":"http://www.example.com/jira/secure/projectavatar?size=medium&amp;pid=10000","48x48":"http://www.example.com/jira/secure/projectavatar?size=large&amp;pid=10000"}},{"self":"http://www.example.com/jira/rest/api/2/project/ABC","id":"10001","key":"ABC","name":"Alphabetical","avatarUrls":{"24x24":"http://www.example.com/jira/secure/projectavatar?size=small&amp;pid=10001","16x16":"http://www.example.com/jira/secure/projectavatar?size=xsmall&amp;pid=10001","32x32":"http://www.example.com/jira/secure/projectavatar?size=medium&amp;pid=10001","48x48":"http://www.example.com/jira/secure/projectavatar?size=large&amp;pid=10001"}}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a list of projects for which the user has the BROWSE, ADMINISTER or PROJECT_ADMIN project permission.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the list of projects.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{projectIdOrKey}"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="getProject"
                            name="GET"><ns2:doc><![CDATA[Contains a full representation of a project in JSON format.

 <p>
 All project keys associated with the project will only be returned if <code>expand=projectKeys</code>.
 <p>]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the project is not found, or the calling user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="project" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/project/EX","id":"10000","key":"EX","description":"This project was created as an example for REST.","lead":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"components":[{"self":"http://www.example.com/jira/rest/api/2/component/10000","id":"10000","name":"Component 1","description":"This is a JIRA component","lead":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"assigneeType":"PROJECT_LEAD","assignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"realAssigneeType":"PROJECT_LEAD","realAssignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"isAssigneeTypeValid":false}],"issueTypes":[{"self":"http://localhost:8090/jira/rest/api/2.0/issueType/3","id":"3","description":"A task that needs to be done.","iconUrl":"http://localhost:8090/jira/images/icons/issuetypes/task.png","name":"Task","subtask":false},{"self":"http://localhost:8090/jira/rest/api/2.0/issueType/1","id":"1","description":"A problem with the software.","iconUrl":"http://localhost:8090/jira/images/icons/issuetypes/bug.png","name":"Bug","subtask":false}],"url":"http://www.example.com/jira/browse/EX","email":"from-jira@example.com","assigneeType":"PROJECT_LEAD","versions":[],"name":"Example","roles":{"Developers":"http://www.example.com/jira/rest/api/2/project/EX/role/10000"},"avatarUrls":{"24x24":"http://www.example.com/jira/secure/projectavatar?size=small&amp;pid=10000","16x16":"http://www.example.com/jira/secure/projectavatar?size=xsmall&amp;pid=10000","32x32":"http://www.example.com/jira/secure/projectavatar?size=medium&amp;pid=10000","48x48":"http://www.example.com/jira/secure/projectavatar?size=large&amp;pid=10000"}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project exists and the user has permission to view it. Contains a full representation
      of a project in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/avatar/temporary"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[Project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="storeTemporaryAvatar"
                            name="POST"><ns2:doc><![CDATA[Creates temporary avatar]]></ns2:doc><ns2:request><ns2:param
                            name="filename" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[name of file being uploaded]]></ns2:doc></ns2:param><ns2:param
                            name="size" style="query" type="xs:long"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[size of file]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have EDIT PROJECT permission.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatar" status="201"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"url":"http://example.com/jira/secure/temporaryavatar?cropped=true","needsCropping":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[temporary avatar cropping instructions]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Validation failed. For example filesize is beyond max attachment size.]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the request does not contain a valid XSRF token]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="storeTemporaryAvatarUsingMultiPart"
                            name="POST"><ns2:doc><![CDATA[Creates temporary avatar using multipart. The response is sent back as JSON stored in a textarea. This is because
 the client uses remote iframing to submit avatars using multipart. So we must send them a valid HTML page back from
 which the client parses the JSON.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have EDIT PROJECT permission.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatar" status="201"
                                    mediaType="text/html"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"url":"http://example.com/jira/secure/temporaryavatar?cropped=true","needsCropping":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[temporary avatar cropping instructions embeded in HTML page. Error messages will also be embeded in the page.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/avatar"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:method
                    id="createAvatarFromTemporary"
                            name="POST"><ns2:doc><![CDATA[Converts temporary avatar into a real avatar]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"needsCropping":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have EDIT PROJECT permission.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatar" status="201"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"1000","owner":"fred","isSystemAvatar":true,"isSelected":true,"selected":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns created avatar]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the cropping coordinates are invalid]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to pick avatar]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateProjectAvatar"
                            name="PUT"><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                mediaType="application/json"/></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/versions"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="getProjectVersions"
                            name="GET"><ns2:doc><![CDATA[Contains a full representation of a the specified project's versions.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the project is not found, or the calling user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="versions" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/version/10000","id":"10000","description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","overdue":true,"userReleaseDate":"6/Jul/2010","projectId":10000},{"self":"http://www.example.com/jira/rest/api/2/version/10010","id":"10010","description":"Minor Bugfix version","name":"Next Version","archived":false,"released":false,"overdue":false,"projectId":10000}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project exists and the user has permission to view its versions. Contains a full
      representation of the project's versions in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/components"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="getProjectComponents"
                            name="GET"><ns2:doc><![CDATA[Contains a full representation of a the specified project's components.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the project is not found, or the calling user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="components" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/component/10000","id":"10000","name":"Component 1","description":"This is a JIRA component","lead":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"assigneeType":"PROJECT_LEAD","assignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"realAssigneeType":"PROJECT_LEAD","realAssignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"isAssigneeTypeValid":false},{"self":"http://www.example.com/jira/rest/api/2/component/10000","id":"10050","name":"PXA","description":"This is a another JIRA component","lead":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"assigneeType":"PROJECT_LEAD","assignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"realAssigneeType":"PROJECT_LEAD","realAssignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"isAssigneeTypeValid":false}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project exists and the user has permission to view its components. Contains a full
      representation of the project's components in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/avatars"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="getAllAvatars"
                            name="GET"><ns2:doc><![CDATA[Returns all avatars which are visible for the currently logged in user.  The avatars are grouped into
 system and custom.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have VIEW PROJECT permission.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatars" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"system":[{"id":"1000","owner":"fred","isSystemAvatar":true,"isSelected":true,"selected":true}],"custom":[{"id":"1010","owner":"andrew","isSystemAvatar":false,"isSelected":false,"selected":false}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a map containing a list of avatars for both custom an system avatars, which the user has the BROWSE project permission.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the list of avatars.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/avatar/{id}"><ns2:param
                    name="id" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[database id for avatar]]></ns2:doc></ns2:param><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[Project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="deleteAvatar"
                            name="DELETE"><ns2:doc><![CDATA[Deletes avatar]]></ns2:doc><ns2:response><ns2:representation
                            status="204"
                            mediaType="application/json"><ns2:doc><![CDATA[Returned if the avatar is successfully deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the avatar does not exist or the currently authenticated user does not have permission to
      delete it.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to delete the component.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{projectIdOrKey}/statuses"><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[Project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="getAllStatuses"
                            name="GET"><ns2:doc><![CDATA[Get all issue types with valid status values for a project]]></ns2:doc><ns2:response><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://localhost:8090/jira/rest/api/2.0/issueType/3","id":"3","name":"Task","subtask":false,"statuses":[{"self":"http://localhost:8090/jira/rest/api/2.0/status/10000","description":"The issue is currently being worked on.","iconUrl":"http://localhost:8090/jira/images/icons/progress.gif","name":"In Progress","id":"10000"},{"self":"http://localhost:8090/jira/rest/api/2.0/status/5","description":"The issue is closed.","iconUrl":"http://localhost:8090/jira/images/icons/closed.gif","name":"Closed","id":"5"}]}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project exists and the user has permission to view its components. Contains a full
      representation of issue types with status values which are valid for each issue type.]]></ns2:doc></ns2:representation><ns2:representation
            status="400"><ns2:doc><![CDATA[Returned if the project is not found, or the calling user does not have permission to view it.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/groupuserpicker"><ns2:method
                id="findUsersAndGroups"
                        name="GET"><ns2:doc><![CDATA[Returns a list of users and groups matching query with highlighting. This resource cannot be accessed
 anonymously.]]></ns2:doc><ns2:request><ns2:param
                        name="query" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A string used to search username, Name or e-mail address]]></ns2:doc></ns2:param><ns2:param
                        name="maxResults" style="query" type="xs:int"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000. If
 you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param><ns2:param
                        name="showAvatar" style="query"
                        type="xs:boolean"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:doc><![CDATA[An object containing list of matched user objects, with html representing highlighting.]]></ns2:doc><ns2:representation
            mediaType="application/json"/></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/resolution"><ns2:method id="getResolutions"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all resolutions.]]></ns2:doc><ns2:response><ns2:representation
                        element="list of resolutions" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/resolution/1","description":"A fix for this issue is checked into the tree and tested.","iconUrl":"http://www.example.com/jira/images/icons/statuses/resolved.png","name":"Fixed"},{"self":"http://www.example.com/jira/rest/api/2/resolution/3","description":"This is what it is supposed to do.","name":"Works as designed"}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the resolutions exists and the user has permission to view them. Contains a full representation of
      the resolution in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the resolution id]]></ns2:doc></ns2:param><ns2:method
                    id="getResolution"
                            name="GET"><ns2:doc><![CDATA[Returns a resolution.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the resolution does not exist or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="resolution" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/resolution/1","description":"A fix for this issue is checked into the tree and tested.","iconUrl":"http://www.example.com/jira/images/icons/statuses/resolved.png","name":"Fixed"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the resolution exists and the user has permission to view it. Contains a full representation of
      the resolution in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/field"><ns2:method id="getFields"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all fields, both System and Custom]]></ns2:doc><ns2:response><ns2:representation
                        element="List of field" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"id":"description","name":"Description","custom":false,"orderable":true,"navigable":true,"searchable":true,"schema":{"type":"string","system":"description"}},{"id":"summary","name":"Summary","custom":false,"schema":{"type":"string","system":"summary"}}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Contains a full representation of all visible fields in JSON.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="createCustomField"
                        name="POST"><ns2:doc><![CDATA[Creates a custom field using a definition (object encapsulating custom field data)]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"New custom field","description":"Custom field for picking groups","type":"com.atlassian.jira.plugin.system.customfieldtypes:grouppicker","searcherKey":"com.atlassian.jira.plugin.system.customfieldtypes:grouppickersearcher"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="201"><ns2:doc><![CDATA[Returned if custom field was created. {@link FieldBean#DOC_EXAMPLE_CF}]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. invalid values).]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[Returned if exception occured during custom field creation.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/project/{projectIdOrKey}/role"><ns2:param
                name="projectIdOrKey" style="template" type="xs:string"
                xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project id or project key]]></ns2:doc></ns2:param><ns2:method
                id="getProjectRoles"
                        name="GET"><ns2:doc><![CDATA[Contains a list of roles in this project with links to full details.]]></ns2:doc><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the project is not found, or the calling user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                        status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"Users":"http://www.example.com/jira/rest/api/2/project/MKY/role/10001","Administrators":"http://www.example.com/jira/rest/api/2/project/MKY/role/10002","Developers":"http://www.example.com/jira/rest/api/2/project/MKY/role/10000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project exists and the user has permission to view it. A maps of roles to URIs containing
      full details for that role.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project role id]]></ns2:doc></ns2:param><ns2:param
                    name="projectIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project id or project key]]></ns2:doc></ns2:param><ns2:method
                    id="getProjectRole"
                            name="GET"><ns2:doc><![CDATA[Details on a given project role.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the project or role is not found, or the calling user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/project/MKY/role/10360","name":"Developers","id":10360,"description":"A project role that represents developers in a project","actors":[{"id":10240,"displayName":"jira-developers","type":"atlassian-group-role-actor","name":"jira-developers"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project and role exists and the user has permission to view it. Contains the role name,
      description, and project actors.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setActors"
                            name="PUT"><ns2:doc><![CDATA[Updates a project role to contain the sent actors.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{ "user" : ["admin"] } or
{ "group" : ["jira-developers"] }</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the actor could not be added to the project role]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/project/MKY/role/10360","name":"Developers","id":10360,"description":"A project role that represents developers in a project","actors":[{"id":10240,"displayName":"jira-developers","type":"atlassian-group-role-actor","name":"jira-developers"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project and role exists and the user has permission to view it. Contains the role name,
      description, and project actors.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="addActorUsers"
                            name="POST"><ns2:doc><![CDATA[Add an actor to a project role.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{ "user" : ["admin"] }  or
{ "group" : ["jira-developers"] }</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the actor could not be added to the project role]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/project/MKY/role/10360","name":"Developers","id":10360,"description":"A project role that represents developers in a project","actors":[{"id":10240,"displayName":"jira-developers","type":"atlassian-group-role-actor","name":"jira-developers"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the project and role exists and the user has permission to view it. Contains the role name,
      description, and project actors.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteActor"
                            name="DELETE"><ns2:doc><![CDATA[Remove actors from a project role.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the actor was successfully removed from the project role.]]></ns2:doc></ns2:representation><ns2:representation
            status="404"><ns2:doc><![CDATA[Returned if the project or role is not found, the calling user does not have permission to view it, or does
      not have permission to modify the actors in the project role.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/version"><ns2:method id="createVersion"
                        name="POST"><ns2:doc><![CDATA[Create a version via POST.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","userReleaseDate":"6/Jul/2010","project":"PXA","projectId":10000}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                        status="201"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","userReleaseDate":"6/Jul/2010","project":"PXA","projectId":10000}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version is created successfully.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to edit the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:method
                    id="delete"
                            name="DELETE"><ns2:doc><![CDATA[Delete a project version.]]></ns2:doc><ns2:request><ns2:param
                            name="moveFixIssuesTo" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The version to set fixVersion to on issues where the deleted version is the fix version,
 If null then the fixVersion is removed.]]></ns2:doc></ns2:param><ns2:param
                            name="moveAffectedIssuesTo" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The version to set affectedVersion to on issues where the deleted version is the affected version,
 If null then the affectedVersion is removed.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the version is successfully deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to delete the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="getVersion"
                            name="GET"><ns2:doc><![CDATA[Returns a project version.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="version" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/version/10000","id":"10000","description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","overdue":true,"userReleaseDate":"6/Jul/2010","projectId":10000}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to view it. Contains a
      full representation of the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateVersion"
                            name="PUT"><ns2:doc><![CDATA[Modify a version via PUT. Any fields present in the PUT will override existing values. As a convenience, if a field
 is not present, it is silently ignored.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/version/10000","id":"10000","description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","overdue":true,"userReleaseDate":"6/Jul/2010","projectId":10000}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to edit the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/relatedIssueCounts"><ns2:param name="id"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the version id]]></ns2:doc></ns2:param><ns2:method
                    id="getVersionRelatedIssues"
                            name="GET"><ns2:doc><![CDATA[Returns a bean containing the number of fixed in and affected issues for the given version.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issue Count Bean" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/version/10000","issuesFixedCount":23,"issuesAffectedCount":101}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to view it. Contains
      counts of issues fixed in and affecting this version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/unresolvedIssueCount"><ns2:param
                    name="id" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the version id]]></ns2:doc></ns2:param><ns2:method
                    id="getVersionUnresolvedIssues"
                            name="GET"><ns2:doc><![CDATA[Returns the number of unresolved issues for the given version]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issuesUnresolvedCount" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/version/10000","issuesUnresolvedCount":23}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to view it. Contains
      counts of issues unresolved in this version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="/{id}/move"><ns2:param name="id"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the version id]]></ns2:doc></ns2:param><ns2:method
                    id="moveVersion"
                            name="POST"><ns2:doc><![CDATA[Modify a version's sequence within a project.

 The move version bean has 2 alternative field value pairs:
 <dl>
     <dt>position</dt><dd>An absolute position, which may have a value of 'First', 'Last', 'Earlier' or 'Later'</dd>
     <dt>after</dt><dd>A version to place this version after.  The value should be the self link of another version</dd>
 </dl>]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"after":"http://www.example.com/jira/rest/api/2/version/10000"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version, or target of the version to move after does not exist or the currently authenticated
      user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="version" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/version/10000","id":"10000","description":"An excellent version","name":"New Version 1","archived":false,"released":true,"releaseDate":"2010-07-06","overdue":true,"userReleaseDate":"6/Jul/2010","projectId":10000}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to view it. Contains a
      full representation of the version moved.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="remotelink"><ns2:method
                    id="getRemoteVersionLinks"
                            name="GET"><ns2:doc><![CDATA[Returns the remote version links for a given global ID.]]></ns2:doc><ns2:request><ns2:param
                            name="globalId" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the global ID of the remote resource that is linked to the versions]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            element="remoteVersionLinks" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"links":[{"self":"http://www.example.com/version/10000/SomeGlobalId","name":"Version 1","link":{ "globalId": "SomeGlobalId", "myCustomLinkProperty": true, "colors": [ "red", "green", "blue" ]}},{"self":"http://www.example.com/version/10101/SomeGlobalId","name":"Version 2","link":{ "globalId": "SomeGlobalId" }}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Contains a list of remote version links.  Any existing links that the user does not
      have permission to see will be filtered out.  The user must have BROWSE permission
      for the project to see links to its versions.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{versionId}/remotelink"><ns2:param
                    name="versionId" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The version for which to delete ALL existing remote version links]]></ns2:doc></ns2:param><ns2:method
                    id="getRemoteVersionLinksByVersionId"
                            name="GET"><ns2:doc><![CDATA[Returns the remote version links associated with the given version ID.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="remoteVersionLinks" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"links":[{"self":"http://www.example.com/version/10000/AnotherGlobalId","name":"Version 1","link":{ "globalId": "AnotherGlobalId", "myCustomLinkProperty": false, "colors": [ "cyan", "magenta", "yellow" ]}},{"self":"http://www.example.com/version/10000/SomeGlobalId","name":"Version 1","link":{ "globalId": "SomeGlobalId", "myCustomLinkProperty": true, "colors": [ "red", "green", "blue" ]}}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to view it, which
      is restricted to those users with BROWSE permission for the project. Contains a full representation
      of the remote version links.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="createOrUpdateRemoteVersionLink"
                            name="POST"><ns2:doc><![CDATA[Create a remote version link via POST.  The link's global ID will be taken from the
 JSON payload if provided; otherwise, it will be generated.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"globalId":"SomeGlobalId","myCustomLinkProperty":true,"colors":["red","green","blue"],"notes":["Remote version links may take any well-formed JSON shape that is desired,","provided that they fit within the maximum buffer size allowed,","which is currently 32,768 characters."]}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="201"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>Returned if the remote version link is created or updated successfully.
      The document has no content, and a </ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version is created successfully.  The document will has no content,
      and a {@code Location:} header contains the self-URI for the newly created link.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the JSON payload is empty or malformed]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to edit the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteRemoteVersionLinksByVersionId"
                            name="DELETE"><ns2:doc><![CDATA[Delete all remote version links for a given version ID.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the remote version links are successfully deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist, the currently authenticated user does not have permission to
      view it, or the version does not have any remote links to delete]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have administrative rights to the project
      and thereby cannot delete remote links to the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{versionId}/remotelink/{globalId}"><ns2:param
                    name="versionId" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The version ID of the remote link]]></ns2:doc></ns2:param><ns2:param
                    name="globalId" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The global ID of the remote link]]></ns2:doc></ns2:param><ns2:method
                    id="getRemoteVersionLink"
                            name="GET"><ns2:doc><![CDATA[A REST sub-resource representing a remote version link]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version or remote version link does not exist or if the user does not have
      the BROWSE permission for the project that owns the specified version]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/version/10000/SomeGlobalId","name":"Version 1","link":{ "globalId": "SomeGlobalId", "myCustomLinkProperty": true, "colors": [ "red", "green", "blue" ]}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Information on the remote version link (or links)]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="createOrUpdateRemoteVersionLink"
                            name="POST"><ns2:doc><![CDATA[Create a remote version link via POST.  The link's global ID will be taken from the
 JSON payload if provided; otherwise, it will be generated.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"globalId":"SomeGlobalId","myCustomLinkProperty":true,"colors":["red","green","blue"],"notes":["Remote version links may take any well-formed JSON shape that is desired,","provided that they fit within the maximum buffer size allowed,","which is currently 32,768 characters."]}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="201"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>Returned if the remote version link is created or updated successfully.
      The document has no content, and a </ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the version is created successfully.  The document will has no content,
      and a {@code Location:} header contains the self-URI for the newly created link.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the JSON payload is empty or malformed]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to edit the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteRemoteVersionLink"
                            name="DELETE"><ns2:doc><![CDATA[Delete a specific remote version link with the given version ID and global ID.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the remote version link is successfully deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist, the currently authenticated user does not have permission to
      view it, or the version does not have a link for the given global ID]]></ns2:doc></ns2:representation><ns2:representation
            status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have administrative rights to the project
      and thereby cannot delete remote links to the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/user"><ns2:method id="getUser"
                        name="GET"><ns2:doc><![CDATA[Returns a user. This resource cannot be accessed anonymously.]]></ns2:doc><ns2:request><ns2:param
                        name="username" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username]]></ns2:doc></ns2:param><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[user key]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                        element="user" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[{"name":"jira-user","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-user"},{"name":"jira-admin","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-admin"},{"name":"important","self":"http://www.example.com/jira/rest/api/2/group?groupname=important"}]},"expand":"groups"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="updateUser"
                        name="PUT"><ns2:doc><![CDATA[Modify user. The "value" fields present will override the existing value.
 Fields skipped in request will not be changed.]]></ns2:doc><ns2:request><ns2:param
                        name="username" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username]]></ns2:doc></ns2:param><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[user key]]></ns2:doc></ns2:param><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"eddie","emailAddress":"eddie@atlassian.com","displayName":"Eddie of Atlassian"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the caller does have permission to edit the user but the user does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                        element="user" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jirahttp://www.example.com/jira/rest/api/2/user/charlie","key":"charlie","name":"charlie","emailAddress":"charlie@atlassian.com","displayName":"Charlie of Atlassian"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the user exists and the caller has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if the request is invalid.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the caller user does not have permission to edit the user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="createUser"
                        name="POST"><ns2:doc><![CDATA[Create user. By default created user will not be notified with email.
 If password field is not set then password will be randomly generated.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"charlie","password":"abracadabra","emailAddress":"charlie@atlassian.com","displayName":"Charlie of Atlassian"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                status="201"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jirahttp://www.example.com/jira/rest/api/2/user/charlie","key":"charlie","name":"charlie","emailAddress":"charlie@atlassian.com","displayName":"Charlie of Atlassian"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the user was created.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if the request is invalid.]]></ns2:doc></ns2:representation><ns2:representation
                        status="403"><ns2:doc><![CDATA[Returned if the caller user does not have permission to create the user.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if the user was not created because of other error.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="removeUser"
                        name="DELETE"><ns2:doc><![CDATA[Removes user.]]></ns2:doc><ns2:request><ns2:param
                        name="username" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username]]></ns2:doc></ns2:param><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[user key]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="204"><ns2:doc><![CDATA[Returned if the user was deleted successfully.]]></ns2:doc></ns2:representation><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the caller does have permission to remove user but the user does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if the request is invalid or some other server error occurred.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the caller does not have permission to remove the user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="avatar/temporary"><ns2:method
                    id="storeTemporaryAvatar"
                            name="POST"><ns2:doc><![CDATA[Creates temporary avatar. Creating a temporary avatar is part of a 3-step process in uploading a new
 avatar for a user: upload, crop, confirm.

 <p>
     The following examples shows these three steps using curl.
     The cookies (session) need to be preserved between requests, hence the use of -b and -c.
     The id created in step 2 needs to be passed to step 3
     (you can simply pass the whole response of step 2 as the request of step 3).
 </p>

 <pre>
 curl -c cookiejar.txt -X POST -u admin:admin -H "X-Atlassian-Token: no-check" \
   -H "Content-Type: image/png" --data-binary @mynewavatar.png \
   'http://localhost:8090/jira/rest/api/2/user/avatar/temporary?username=admin&amp;filename=mynewavatar.png'

 curl -b cookiejar.txt -X POST -u admin:admin -H "X-Atlassian-Token: no-check" \
   -H "Content-Type: application/json" --data '{"cropperWidth": "65","cropperOffsetX": "10","cropperOffsetY": "16"}' \
   -o tmpid.json \
   http://localhost:8090/jira/rest/api/2/user/avatar?username=admin

 curl -b cookiejar.txt -X PUT -u admin:admin -H "X-Atlassian-Token: no-check" \
   -H "Content-Type: application/json" --data-binary @tmpid.json \
   http://localhost:8090/jira/rest/api/2/user/avatar?username=admin
 </pre>]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param><ns2:param
                            name="filename" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[name of file being uploaded]]></ns2:doc></ns2:param><ns2:param
                            name="size" style="query" type="xs:long"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[size of file]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have EDIT PROJECT permission.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatar" status="201"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"url":"http://example.com/jira/secure/temporaryavatar?cropped=true","needsCropping":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[temporary avatar cropping instructions]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the request does not conain a valid XSRF token]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="storeTemporaryAvatarUsingMultiPart"
                            name="POST"><ns2:doc><![CDATA[Creates temporary avatar using multipart. The response is sent back as JSON stored in a textarea. This is because
 the client uses remote iframing to submit avatars using multipart. So we must send them a valid HTML page back from
 which the client parses the JSON from.

 <p>
 Creating a temporary avatar is part of a 3-step process in uploading a new
 avatar for a user: upload, crop, confirm. This endpoint allows you to use a multipart upload
 instead of sending the image directly as the request body.
 </p>

 <p>You *must* use "avatar" as the name of the upload parameter:</p>

 <pre>
 curl -c cookiejar.txt -X POST -u admin:admin -H "X-Atlassian-Token: no-check" \
   -F "avatar=@mynewavatar.png;type=image/png" \
   'http://localhost:8090/jira/rest/api/2/user/avatar/temporary?username=admin'
 </pre>]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[Username]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if user does NOT exist]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatar" status="201"
                                    mediaType="text/html"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"url":"http://example.com/jira/secure/temporaryavatar?cropped=true","needsCropping":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[temporary avatar cropping instructions embeded in HTML page. Error messages will also be embeded in the page.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="avatar"><ns2:method
                    id="createAvatarFromTemporary"
                            name="POST"><ns2:doc><![CDATA[Converts temporary avatar into a real avatar]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"needsCropping":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have EDIT PROJECT permission.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatar" status="201"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"1000","owner":"fred","isSystemAvatar":true,"isSelected":true,"selected":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns created avatar]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the cropping coordinates are invalid]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to pick avatar]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateProjectAvatar"
                            name="PUT"><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                mediaType="application/json"/></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="avatars"><ns2:method id="getAllAvatars"
                            name="GET"><ns2:doc><![CDATA[Returns all avatars which are visible for the currently logged in user.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="avatars" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"system":[{"id":"1000","owner":"fred","isSystemAvatar":true,"isSelected":true,"selected":true}],"custom":[{"id":"1010","owner":"andrew","isSystemAvatar":false,"isSelected":false,"selected":false}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a map containing a list of avatars for both custom an system avatars]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the list of avatars.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="avatar/{id}"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[database id for avatar]]></ns2:doc></ns2:param><ns2:method
                    id="deleteAvatar"
                            name="DELETE"><ns2:doc><![CDATA[Deletes avatar]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"
                            mediaType="application/json"><ns2:doc><![CDATA[Returned if the avatar is successfully deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the avatar does not exist or the currently authenticated user does not have permission to
      delete it.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to delete the avatar.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="search"><ns2:method id="findUsers"
                            name="GET"><ns2:doc><![CDATA[Returns a list of users that match the search string. This resource cannot be accessed anonymously.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A query string used to search username, name or e-mail address]]></ns2:doc></ns2:param><ns2:param
                            name="startAt" style="query" type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first user to return (0-based)]]></ns2:doc></ns2:param><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000.
 If you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param><ns2:param
                            name="includeActive" style="query"
                            type="xs:boolean"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[If true, then active users are included in the results (default true)]]></ns2:doc></ns2:param><ns2:param
                            name="includeInactive" style="query"
                            type="xs:boolean"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[If true, then inactive users are included in the results (default false)]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="List of users" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},{"self":"http://www.example.com/jira/rest/api/2/user?username=andrew","name":"andrew","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=andrew","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=andrew","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=andrew","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=andrew"},"displayName":"Andrew Anderson","active":false}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="picker"><ns2:method id="findUsersForPicker"
                            name="GET"><ns2:doc><![CDATA[Returns a list of users matching query with highlighting. This resource cannot be accessed anonymously.]]></ns2:doc><ns2:request><ns2:param
                            name="query" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A string used to search username, Name or e-mail address]]></ns2:doc></ns2:param><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000.
 If you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param><ns2:param
                            name="showAvatar" style="query"
                            type="xs:boolean"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:param
                            name="exclude" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="List of users" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"users":[{"name":"fred","key":"fred","html":"fred@example.com","displayName":"Fred Grumble","avatarUrl":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred"}],"total":25,"header":"Showing 20 of 25 matching groups"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="assignable/search"><ns2:method
                    id="findAssignableUsers"
                            name="GET"><ns2:doc><![CDATA[Returns a list of users that match the search string. This resource cannot be accessed anonymously.
 Please note that this resource should be called with an issue key when a list of assignable users is retrieved
 for editing.  For create only a project key should be supplied.  The list of assignable users may be incorrect
 if it's called with the project key for editing.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username]]></ns2:doc></ns2:param><ns2:param
                            name="project" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the key of the project we are finding assignable users for]]></ns2:doc></ns2:param><ns2:param
                            name="issueKey" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue key for the issue being edited we need to find assignable users for.]]></ns2:doc></ns2:param><ns2:param
                            name="startAt" style="query" type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first user to return (0-based)]]></ns2:doc></ns2:param><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000.
 If you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param><ns2:param
                            name="actionDescriptorId" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="user" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[{"name":"jira-user","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-user"},{"name":"jira-admin","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-admin"},{"name":"important","self":"http://www.example.com/jira/rest/api/2/group?groupname=important"}]},"expand":"groups"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if no project or issue key was provided]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="password"><ns2:method id="changeUserPassword"
                            name="PUT"><ns2:doc><![CDATA[Modify user password.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username]]></ns2:doc></ns2:param><ns2:param
                            name="key" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[user key]]></ns2:doc></ns2:param><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the user exists and the caller has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the caller does have permission to change user password but the user does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the caller does not have permission to change the user password.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="viewissue/search"><ns2:method
                    id="findUsersWithBrowsePermission"
                            name="GET"><ns2:doc><![CDATA[Returns a list of active users that match the search string. This resource cannot be accessed anonymously.
 Given an issue key this resource will provide a list of users that match the search string and have
 the browse issue permission for the issue provided.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username filter, no users returned if left blank]]></ns2:doc></ns2:param><ns2:param
                            name="issueKey" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue key for the issue being edited we need to find viewable users for.]]></ns2:doc></ns2:param><ns2:param
                            name="projectKey" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the optional project key to search for users with if no issueKey is supplied.]]></ns2:doc></ns2:param><ns2:param
                            name="startAt" style="query" type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first user to return (0-based)]]></ns2:doc></ns2:param><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000.
 If you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue or project is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="List of users" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},{"self":"http://www.example.com/jira/rest/api/2/user?username=andrew","name":"andrew","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=andrew","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=andrew","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=andrew","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=andrew"},"displayName":"Andrew Anderson","active":false}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if no project or issue key was provided]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="permission/search"><ns2:method
                    id="findUsersWithAllPermissions"
                            name="GET"><ns2:doc><![CDATA[Returns a list of active users that match the search string and have all specified permissions for the project or issue.<br>
 This resource can be accessed by users with ADMINISTER_PROJECT permission for the project or global ADMIN or SYSADMIN rights.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username filter, list includes all users if unspecified]]></ns2:doc></ns2:param><ns2:param
                            name="permissions" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[comma separated list of permissions for project or issue returned users must have, see
 <a href="https://developer.atlassian.com/static/javadoc/jira/6.0/reference/com/atlassian/jira/security/Permissions.Permission.html">Permissions</a>
 JavaDoc for the list of all possible permissions.]]></ns2:doc></ns2:param><ns2:param
                            name="issueKey" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue key for the issue for which returned users have specified permissions.]]></ns2:doc></ns2:param><ns2:param
                            name="projectKey" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the optional project key to search for users with if no issueKey is supplied.]]></ns2:doc></ns2:param><ns2:param
                            name="startAt" style="query" type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first user to return (0-based)]]></ns2:doc></ns2:param><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000.
 If you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue or project is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="List of users" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},{"self":"http://www.example.com/jira/rest/api/2/user?username=andrew","name":"andrew","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=andrew","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=andrew","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=andrew","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=andrew"},"displayName":"Andrew Anderson","active":false}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if no project or issue key was provided or when permissions list is empty or contains an invalid entry]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the current user does not have admin rights for the project.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="assignable/multiProjectSearch"><ns2:method
                    id="findBulkAssignableUsers"
                            name="GET"><ns2:doc><![CDATA[Returns a list of users that match the search string and can be assigned issues for all the given projects.
 This resource cannot be accessed anonymously.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the username]]></ns2:doc></ns2:param><ns2:param
                            name="projectKeys" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the keys of the projects we are finding assignable users for, comma-separated]]></ns2:doc></ns2:param><ns2:param
                            name="startAt" style="query" type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first user to return (0-based)]]></ns2:doc></ns2:param><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the maximum number of users to return (defaults to 50). The maximum allowed value is 1000.
 If you specify a value that is higher than this number, your search results will be truncated.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="user" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},{"self":"http://www.example.com/jira/rest/api/2/user?username=andrew","name":"andrew","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=andrew","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=andrew","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=andrew","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=andrew"},"displayName":"Andrew Anderson","active":false}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="columns"><ns2:method id="defaultColumns"
                            name="GET"><ns2:doc><![CDATA[Returns the default columns for the given user. Admin permission will be required to get columns for a user
 other than the currently logged in user.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested user is not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="columns" status="200"
                            mediaType="application/json"><ns2:doc><![CDATA[Returns a list of columns for configured for the given user]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not permitted to request the columns for the given user.]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setColumns"
                            name="PUT"><ns2:doc><![CDATA[Sets the default columns for the given user.  Admin permission will be required to get columns for a user
 other than the currently logged in user.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/x-www-form-urlencoded"><ns2:param
                                name="username" style="query"
                                type="xs:string"
                                xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param><ns2:param
                                name="columns" style="query"
                                type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[list of column ids]]></ns2:doc></ns2:param></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="200"><ns2:doc><![CDATA[Returned when the columns is saved successfully]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="resetColumns"
                            name="DELETE"><ns2:doc><![CDATA[Reset the default columns for the given user to the system default. Admin permission will be required to get
 columns for a user other than the currently logged in user.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[username]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned when the columns are reset successfully]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not permitted to request the columns for the given user.]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[Returned if an error occurs while resetting the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/serverInfo"><ns2:method id="getServerInfo"
                        name="GET"><ns2:doc><![CDATA[Returns general information about the current JIRA server.]]></ns2:doc><ns2:request><ns2:param
                        name="doHealthCheck" style="query"
                        type="xs:boolean"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                        element="serverInfo" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"baseUrl":"http://localhost:8080/jira","version":"5.0-SNAPSHOT","versionNumbers":[5,0,0],"buildNumber":582,"buildDate":"2014-01-28T14:28:59.248+0100","serverTime":"2014-01-28T14:28:59.248+0100","scmInfo":"1f51473f5c7b75c1a69a0090f4832cdc5053702a","buildPartnerName":"Example Partner Co.","serverTitle":"My Shiny New JIRA Server"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of the server info in JSON format]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/screens"><ns2:resource
                    path="{screenId}/tabs"><ns2:param name="screenId"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:method
                    id="addTab"
                            name="POST"><ns2:doc><![CDATA[Creates tab for given screen]]></ns2:doc><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                            element="Newly created tab" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":10000,"name":"Fields Tab"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Newly created tab in JSON.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if screen does not exist or tab name is invalid]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="getAllTabs"
                            name="GET"><ns2:doc><![CDATA[Returns a list of all tabs for the given screen]]></ns2:doc><ns2:response><ns2:representation
                            element="List of tabs" status="200"
                            mediaType="application/json"><ns2:doc><![CDATA[Contains a full representation of all visible tabs in JSON.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen does not exist]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{screenId}/tabs/{tabId}/fields"><ns2:param
                    name="screenId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:param
                    name="tabId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of tab]]></ns2:doc></ns2:param><ns2:method
                    id="addField"
                            name="POST"><ns2:doc><![CDATA[Adds field to the given tab]]></ns2:doc><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"summary","name":"Summary"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Newly added field as json]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if screen,tab or field does not exist.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="getAllFields"
                            name="GET"><ns2:doc><![CDATA[Gets all fields for a given tab]]></ns2:doc><ns2:response><ns2:representation
                            status="200"><ns2:doc><![CDATA[List of fields for given tab]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen or tab does not exist]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{screenId}/tabs/{tabId}/fields/{id}"><ns2:param
                    name="id" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:param
                    name="screenId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:param
                    name="tabId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of tab]]></ns2:doc></ns2:param><ns2:method
                    id="removeField"
                            name="DELETE"><ns2:doc><![CDATA[Removes field from given tab]]></ns2:doc><ns2:response><ns2:representation
                            status="201"><ns2:doc><![CDATA[Successfully removed field from tab]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen or tab does not exist]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{screenId}/tabs/{tabId}"><ns2:param
                    name="screenId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:param
                    name="tabId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of tab]]></ns2:doc></ns2:param><ns2:method
                    id="renameTab"
                            name="PUT"><ns2:doc><![CDATA[Renames tab on given screen]]></ns2:doc><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                            element="Modified tab" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":10000,"name":"Fields Tab"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Modified tab in JSON.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if screen does not exist or tab name is invalid]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteTab"
                            name="DELETE"><ns2:doc><![CDATA[Deletes tab to give screen]]></ns2:doc><ns2:response><ns2:representation
                            status="201"><ns2:doc><![CDATA[Successfully deleted tab]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen or tab does not exist]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{screenId}/tabs/{tabId}/move/{pos}"><ns2:param
                    name="screenId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:param
                    name="tabId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of tab]]></ns2:doc></ns2:param><ns2:param
                    name="pos" style="template" type="xs:int"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[position of tab]]></ns2:doc></ns2:param><ns2:method
                    id="moveTab"
                            name="POST"><ns2:doc><![CDATA[Moves tab position]]></ns2:doc><ns2:response><ns2:representation
                            status="201"><ns2:doc><![CDATA[Successfully moved tab]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen or tab does not exist]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{screenId}/availableFields"><ns2:param
                    name="screenId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:method
                    id="getFieldsToAdd"
                            name="GET"><ns2:doc><![CDATA[Gets available fields for screen. i.e ones that haven't already been added.]]></ns2:doc><ns2:response><ns2:representation
                            status="200"><ns2:doc><![CDATA[List of available fields for screen]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen does not exist]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{screenId}/tabs/{tabId}/fields/{id}/move"><ns2:param
                    name="id" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:param
                    name="screenId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of screen]]></ns2:doc></ns2:param><ns2:param
                    name="tabId" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of tab]]></ns2:doc></ns2:param><ns2:method
                    id="moveField"
                            name="POST"><ns2:doc><![CDATA[Moves field on the given tab]]></ns2:doc><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                            status="201"><ns2:doc><![CDATA[Successfully moved tab]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have permissions]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if screen or tab does not exist. Or move cooridinates invalid.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="addToDefault/{fieldId}"><ns2:param
                    name="fieldId" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of field / custom field]]></ns2:doc></ns2:param><ns2:method
                    id="addFieldToDefaultScreen"
                            name="POST"><ns2:doc><![CDATA[Adds field or custom field to the default tab]]></ns2:doc><ns2:response><ns2:representation
                            status="201"/><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if you do not have administrator permissions]]></ns2:doc></ns2:representation><ns2:representation
            status="400"><ns2:doc><![CDATA[Returned if screen, tab or field does not exist or field is already present on a selected tab]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/workflow"><ns2:doc><![CDATA[REST resource for retrieving workflows.]]></ns2:doc><ns2:method
                id="getAllWorkflows"
                        name="GET"><ns2:doc><![CDATA[Returns all workflows.]]></ns2:doc><ns2:request><ns2:param
                        name="workflowName" style="query"
                        type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                        status="200"
                        mediaType="application/json"><ns2:doc><![CDATA[Returned if the currently authenticated user has administration permission. Contains a
      full representation of every workflow.]]></ns2:doc></ns2:representation><ns2:representation
            status="401"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have administration permission.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/avatar"><ns2:resource
                    path="{type}/system"><ns2:param name="type"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the avatar type]]></ns2:doc></ns2:param><ns2:method
                    id="getAllSystemAvatars"
                            name="GET"><ns2:doc><![CDATA[Returns all system avatars of the given type.]]></ns2:doc><ns2:response><ns2:representation
                            element="avatars" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"system":[{"id":"1000","owner":"fred","isSystemAvatar":true,"isSelected":true,"selected":true}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a map containing a list of system avatars. A map is returned to be consistent with the shape of the
      project/KEY/avatars REST end point.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the list of avatars.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{type}/temporary"><ns2:param name="type"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the avatar type]]></ns2:doc></ns2:param><ns2:method
                    id="storeTemporaryAvatar"
                            name="POST"><ns2:doc><![CDATA[Creates temporary avatar]]></ns2:doc><ns2:request><ns2:param
                            name="filename" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[name of file being uploaded]]></ns2:doc></ns2:param><ns2:param
                            name="size" style="query" type="xs:long"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[size of file]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            element="avatar" status="201"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"url":"http://example.com/jira/secure/temporaryavatar?cropped=true","needsCropping":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[temporary avatar cropping instructions]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Valiation failed. For example filesize is beyond max attachment size.]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the request does not conain a valid XSRF token]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while converting temporary avatar to real avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{type}/temporaryCrop"><ns2:param name="type"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the avatar type]]></ns2:doc></ns2:param><ns2:method
                    id="createAvatarFromTemporary"
                            name="POST"><ns2:doc><![CDATA[Updates the cropping instructions of the temporary avatar.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"cropperWidth":120,"cropperOffsetX":50,"cropperOffsetY":50,"needsCropping":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            element="avatar" status="201"
                            mediaType="application/json"/><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the cropping coordinates are invalid]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[Returned if an error occurs while cropping the temporary avatar]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/dashboard"><ns2:doc><![CDATA[The <code>/dashboard</code> resource.]]></ns2:doc><ns2:method
                id="list"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all dashboards, optionally filtering them.]]></ns2:doc><ns2:request><ns2:param
                        name="filter" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[an optional filter that is applied to the list of dashboards. Valid values include
 <code>"favourite"</code> for returning only favourite dashboards, and <code>"my"</code> for returning
 dashboards that are owned by the calling user.]]></ns2:doc></ns2:param><ns2:param
                        name="startAt" style="query" type="xs:int"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the index of the first dashboard to return (0-based). must be 0 or a multiple of
 <code>maxResults</code>]]></ns2:doc></ns2:param><ns2:param
                        name="maxResults" style="query" type="xs:int"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a hint as to the the maximum number of dashboards to return in each call. Note that the
 JIRA server reserves the right to impose a <code>maxResults</code> limit that is lower than the value that a
 client provides, dues to lack or resources or any other condition. When this happens, your results will be
 truncated. Callers should always check the returned <code>maxResults</code> to determine the value that is
 effectively being used.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                                status="200"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"startAt":10,"maxResults":10,"total":143,"prev":"http://www.example.com/jira/rest/api/2/dashboard?startAt=0","next":"http://www.example.com/jira/rest/api/2/dashboard?startAt=10","dashboards":[{"id":"10000","name":"System Dashboard","self":"http://www.example.com/jira/rest/api/2/dashboard/10000","view":"http://www.example.com/jira/secure/Dashboard.jspa?selectPageId=10000"},{"id":"20000","name":"Build Engineering","self":"http://www.example.com/jira/rest/api/2/dashboard/20000","view":"http://www.example.com/jira/secure/Dashboard.jspa?selectPageId=20000"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a list of dashboards.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the dashboard id]]></ns2:doc></ns2:param><ns2:method
                    id="getDashboard"
                            name="GET"><ns2:doc><![CDATA[Returns a single dashboard.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if there is no dashboard with the specified id, or if the user does not have permission to see it.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"10000","name":"System Dashboard","self":"http://www.example.com/jira/rest/api/2/dashboard/10000","view":"http://www.example.com/jira/secure/Dashboard.jspa?selectPageId=10000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a single dashboard.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/filter"><ns2:doc><![CDATA[Resource for searches.]]></ns2:doc><ns2:method
                id="createFilter"
                        name="POST"><ns2:doc><![CDATA[Creates a new filter, and returns newly created filter.
 Currently sets permissions just using the users default sharing permissions]]></ns2:doc><ns2:request><ns2:param
                        name="expand" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the parameters to expand]]></ns2:doc></ns2:param><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"All Open Bugs","description":"Lists all open bugs","jql":"type = Bug and resolution is empty","favourite":true}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        element="filter" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/filter/10000","id":"10000","name":"All Open Bugs","description":"Lists all open bugs","owner":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"jql":"type = Bug and resolution is empty","viewUrl":"http://www.example.com/jira/secure/IssueNavigator.jspa?mode=hide&amp;requestId=10000","searchUrl":"http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty","favourite":true,"sharePermissions":[],"subscriptions":{"size":0,"items":[],"max-results":1000,"start-index":0,"end-index":0}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of a filter]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. filter name was not provided).]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The ID of the filter to delete.]]></ns2:doc></ns2:param><ns2:method
                    id="getFilter"
                            name="GET"><ns2:doc><![CDATA[Returns a filter given an id]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the parameters to expand]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            element="filter" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/filter/10000","id":"10000","name":"All Open Bugs","description":"Lists all open bugs","owner":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"jql":"type = Bug and resolution is empty","viewUrl":"http://www.example.com/jira/secure/IssueNavigator.jspa?mode=hide&amp;requestId=10000","searchUrl":"http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty","favourite":true,"sharePermissions":[],"subscriptions":{"size":0,"items":[],"max-results":1000,"start-index":0,"end-index":0}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of a filter]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if there is a problem looking up the filter given the id]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="editFilter"
                            name="PUT"><ns2:doc><![CDATA[Updates an existing filter, and returns its new value.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the parameters to expand]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"All Open Bugs","description":"Lists all open bugs","jql":"type = Bug and resolution is empty","favourite":true}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            element="filter" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/filter/10000","id":"10000","name":"All Open Bugs","description":"Lists all open bugs","owner":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"jql":"type = Bug and resolution is empty","viewUrl":"http://www.example.com/jira/secure/IssueNavigator.jspa?mode=hide&amp;requestId=10000","searchUrl":"http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty","favourite":true,"sharePermissions":[],"subscriptions":{"size":0,"items":[],"max-results":1000,"start-index":0,"end-index":0}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of a filter]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if there is a problem updating up the filter of the given id]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteFilter"
                            name="DELETE"><ns2:doc><![CDATA[Delete a filter.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the filter was removed successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if an error occurs.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/columns"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of the filter]]></ns2:doc></ns2:param><ns2:method
                    id="defaultColumns"
                            name="GET"><ns2:doc><![CDATA[Returns the default columns for the given filter. Currently logged in user will be used as
 the user making such request.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the filter does not have any columns.]]></ns2:doc></ns2:representation><ns2:representation
                            element="columns" status="200"
                            mediaType="application/json"><ns2:doc><![CDATA[Returns a list of columns for configured for the given user]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setColumns"
                            name="PUT"><ns2:doc><![CDATA[Sets the default columns for the given filter.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/x-www-form-urlencoded"><ns2:param
                                name="columns" style="query"
                                type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[list of column ids]]></ns2:doc></ns2:param></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="200"><ns2:doc><![CDATA[Returned when the columns are saved successfully]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="resetColumns"
                            name="DELETE"><ns2:doc><![CDATA[Resets the columns for the given filter such that the filter no longer has its own column config.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned when the columns are reset/removed successfully]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="favourite"><ns2:method
                    id="getFavouriteFilters"
                            name="GET"><ns2:doc><![CDATA[Returns the favourite filters of the logged-in user.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the parameters to expand]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            element="filter" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/filter/10000","id":"10000","name":"All Open Bugs","description":"Lists all open bugs","owner":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"jql":"type = Bug and resolution is empty","viewUrl":"http://www.example.com/jira/secure/IssueNavigator.jspa?mode=hide&amp;requestId=10000","searchUrl":"http://www.example.com/jira/rest/api/2/search?jql=type%20%3D%20Bug%20and%20resolutino%20is%20empty","favourite":true,"sharePermissions":[],"subscriptions":{"size":0,"items":[],"max-results":1000,"start-index":0,"end-index":0}},{"self":"http://www.example.com/jira/rest/api/2/filter/10010","id":"10010","name":"My issues","description":"Issues assigned to me","owner":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"jql":"assignee = currentUser() and resolution is empty","viewUrl":"http://www.example.com/jira/secure/IssueNavigator.jspa?mode=hide&amp;requestId=10010","searchUrl":"http://www.example.com/jira/rest/api/2/search?jql=assignee+%3D+currentUser%28%29+and+resolution+is+empty","favourite":true,"sharePermissions":[{"id":10000,"type":"global"},{"id":10010,"type":"project","project":{"self":"http://www.example.com/jira/rest/api/2/project/EX","id":"10000","key":"EX","name":"Example","avatarUrls":{"24x24":"http://www.example.com/jira/secure/projectavatar?size=small&amp;pid=10000","16x16":"http://www.example.com/jira/secure/projectavatar?size=xsmall&amp;pid=10000","32x32":"http://www.example.com/jira/secure/projectavatar?size=medium&amp;pid=10000","48x48":"http://www.example.com/jira/secure/projectavatar?size=large&amp;pid=10000"}}}],"subscriptions":{"size":0,"items":[],"max-results":1000,"start-index":0,"end-index":0}}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of a list of filters]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="defaultShareScope"><ns2:method
                    id="getDefaultShareScope"
                            name="GET"><ns2:doc><![CDATA[Returns the default share scope of the logged-in user.]]></ns2:doc><ns2:response><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"scope":"GLOBAL"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns the default share scope of the logged-in user.]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if there is a problem looking up preferences for the logged-in user]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setDefaultShareScope"
                            name="PUT"><ns2:doc><![CDATA[Sets the default share scope of the logged-in user. Available values are GLOBAL and PRIVATE.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"scope":"GLOBAL"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"scope":"GLOBAL"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns the new default share scope of the logged-in user.]]></ns2:doc></ns2:representation><ns2:representation
            status="400"><ns2:doc><![CDATA[Returned if there is a problem setting the preferences for the logged-in user]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/password"><ns2:resource
                    path="policy"><ns2:method id="getPasswordPolicy"
                            name="GET"><ns2:doc><![CDATA[Returns user-friendly statements governing the system's password policy.]]></ns2:doc><ns2:request><ns2:param
                            name="hasOldPassword" style="query"
                            type="xs:boolean" default="false"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[whether or not the user will be required to enter their current password.  Use
      {@code false} (the default) if this is a new user or if an administrator is forcibly changing
      another user's password.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="200"
                mediaType="application/json"><ns2:doc><![CDATA[Returns an array of message strings.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="policy/createUser"><ns2:method
                    id="policyCheckCreateUser"
                            name="POST"><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                mediaType="application/json"/></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="policy/updateUser"><ns2:method
                    id="policyCheckUpdateUser"
                            name="POST"><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
            mediaType="application/json"/></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/jql/autocompletedata"><ns2:doc><![CDATA[Resource for auto complete data for searches.]]></ns2:doc><ns2:method
                id="getAutoComplete"
                        name="GET"><ns2:doc><![CDATA[Returns the auto complete data required for JQL searches.]]></ns2:doc><ns2:response><ns2:representation
                        status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>"{\"visibleFieldNames\": [{\"value\":\"affectedVersion\",\"displayName\":\"affectedVersion\",\"auto\":\"true\",\"orderable\":\"true\",\"searchable\":\"true\",\"operators\":[\"=\",\"!=\",\"in\",\"not in\",\"is\",\"is not\",\"&lt;\",\"&lt;=\",\"&gt;\",\"&gt;=\"],\"types\":[\"com.atlassian.jira.project.version.Version\"]},{\"value\":\"assignee\",\"displayName\":\"assignee\",\"auto\":\"true\",\"orderable\":\"true\",\"searchable\":\"true\",\"operators\":[\"!=\",\"was not in\",\"not in\",\"was not\",\"is\",\"was in\",\"was\",\"=\",\"in\",\"changed\",\"is not\"],\"types\":[\"com.atlassian.crowd.embedded.api.User\"]}],\"visibleFunctionNames\": {\"value\":\"currentLogin()\",\"displayName\":\"currentLogin()\",\"types\":[\"java.util.Date\"]},{\"value\":\"currentUser()\",\"displayName\":\"currentUser()\",\"types\":[\"com.atlassian.crowd.embedded.api.User\"]}],\"jqlReservedWords\": \"empty\",\"and\",\"or\",\"in\",\"distinct\"]}"</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The auto complete data required for JQL searches.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[Returned if an error occurs while generating the response.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/status"><ns2:method id="getStatuses"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all statuses]]></ns2:doc><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the requested issue status is not found, or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                        element="statuses" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://localhost:8090/jira/rest/api/2.0/status/10000","description":"The issue is currently being worked on.","iconUrl":"http://localhost:8090/jira/images/icons/progress.gif","name":"In Progress","id":"10000","statusCategory":{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/1","id":1,"key":"in-flight","colorName":"yellow"}},{"self":"http://localhost:8090/jira/rest/api/2.0/status/5","description":"The issue is closed.","iconUrl":"http://localhost:8090/jira/images/icons/closed.gif","name":"Closed","id":"5","statusCategory":{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/9","id":9,"key":"completed","colorName":"green"}}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a list of all JIRA issue statuses in JSON format, that are visible to the user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{idOrName}"><ns2:param name="idOrName"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a numeric Status id or a status name]]></ns2:doc></ns2:param><ns2:method
                    id="getStatus"
                            name="GET"><ns2:doc><![CDATA[Returns a full representation of the Status having the given id or name.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue status is not found, or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="status" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://localhost:8090/jira/rest/api/2.0/status/10000","description":"The issue is currently being worked on.","iconUrl":"http://localhost:8090/jira/images/icons/progress.gif","name":"In Progress","id":"10000","statusCategory":{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/1","id":1,"key":"in-flight","colorName":"yellow"}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA issue status in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/component"><ns2:method id="createComponent"
                        name="POST"><ns2:doc><![CDATA[Create a component via POST.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"Component 1","description":"This is a JIRA component","leadUserName":"fred","assigneeType":"PROJECT_LEAD","isAssigneeTypeValid":false,"project":"PXA"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the project does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                        status="201"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/component/10000","id":"10000","name":"Component 1","description":"This is a JIRA component","lead":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"assigneeType":"PROJECT_LEAD","assignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"realAssigneeType":"PROJECT_LEAD","realAssignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"isAssigneeTypeValid":false}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the component is created successfully.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[Returned if the caller is not logged in and does not have permission to create components in
      the project.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the caller is authenticated and does not have permission to create components in the project.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:method
                    id="delete"
                            name="DELETE"><ns2:doc><![CDATA[Delete a project component.]]></ns2:doc><ns2:request><ns2:param
                            name="moveIssuesTo" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The new component applied to issues whose 'id' component will be deleted.
 If this value is null, then the 'id' component is simply removed from the related isues.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the component is successfully deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the component does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to delete the component.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="getComponent"
                            name="GET"><ns2:doc><![CDATA[Returns a project component.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if there is no component with the given key, or if the calling user does not have permission to
      view the component.]]></ns2:doc></ns2:representation><ns2:representation
                            element="component" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/component/10000","id":"10000","name":"Component 1","description":"This is a JIRA component","lead":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"assigneeType":"PROJECT_LEAD","assignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"realAssigneeType":"PROJECT_LEAD","realAssignee":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"isAssigneeTypeValid":false}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full JSON representation of a project component.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateComponent"
                            name="PUT"><ns2:doc><![CDATA[Modify a component via PUT. Any fields present in the PUT will override existing values. As a convenience, if a field
 is not present, it is silently ignored.

 If leadUserName is an empty string ("") the component lead will be removed.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"Component 1","description":"This is a JIRA component","leadUserName":"fred","assigneeType":"PROJECT_LEAD","isAssigneeTypeValid":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the component does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"><ns2:doc><![CDATA[Returned if the component exists and the currently authenticated user has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to edit the component.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/relatedIssueCounts"><ns2:param name="id"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the component id]]></ns2:doc></ns2:param><ns2:method
                    id="getComponentRelatedIssues"
                            name="GET"><ns2:doc><![CDATA[Returns counts of issues related to this component.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the component does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issue Count Bean" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/component/10000","issueCount":23}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the component exists and the currently authenticated user has permission to view it. Contains
      counts of issues related to this component.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/customFieldOption"><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing an Custom Field Option id]]></ns2:doc></ns2:param><ns2:method
                    id="getCustomFieldOption"
                            name="GET"><ns2:doc><![CDATA[Returns a full representation of the Custom Field Option that has the given id.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the Custom Field Option does not exist, or is not visible to the calling user.]]></ns2:doc></ns2:representation><ns2:representation
                            element="customFieldOption" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://localhost:8090/jira/rest/api/2.0/customFieldOption/3","value":"Blue"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the Custom Field Option exists and is visible by the calling user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/group"><ns2:method id="createGroup"
                        name="POST"><ns2:doc><![CDATA[Creates a group by given group parameter

 Returns REST representation for the requested group.]]></ns2:doc><ns2:request><ns2:representation
                        mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                        element="group" status="201"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"jira-administrators","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators","users":{"size":1,"items":[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false}],"max-results":50,"start-index":0,"end-index":0},"expand":"users"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns full representation of a JIRA group in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if user requested an empty group name or group already exists]]></ns2:doc></ns2:representation><ns2:representation
                        status="403"><ns2:doc><![CDATA[Returned if the current user does not have administrator permissions.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if the operation is not permitted or error occurs while creating the group.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="getGroup"
                        name="GET"><ns2:doc><![CDATA[Returns REST representation for the requested group. Allows to get list of active users belonging to the
 specified group and its subgroups if "users" expand option is provided. You can page through users list by using
 indexes in expand param. For example to get users from index 10 to index 15 use "users[10:15]" expand value. This
 will return 6 users (if there are at least 16 users in this group). Indexes are 0-based and inclusive.]]></ns2:doc><ns2:request><ns2:param
                        name="groupname" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A name of requested group.]]></ns2:doc></ns2:param><ns2:param
                        name="expand" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[List of fields to expand. Currently only available expand is "users".]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the requested group was not found.]]></ns2:doc></ns2:representation><ns2:representation
                        element="group" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"jira-administrators","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-administrators","users":{"size":1,"items":[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false}],"max-results":50,"start-index":0,"end-index":0},"expand":"users"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns full representation of a JIRA group in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if user requested an empty group name.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the current user does not have administrator permissions.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="removeGroup"
                        name="DELETE"><ns2:doc><![CDATA[Deletes a group by given group parameter.

 Returns no content]]></ns2:doc><ns2:request><ns2:param
                        name="groupname" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a group to delete]]></ns2:doc></ns2:param><ns2:param
                        name="swapGroup" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a group to transfer visibility restrictions of the group that is being deleted]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the requested group was not found.]]></ns2:doc></ns2:representation><ns2:representation
                        status="200"
                        mediaType="application/json"><ns2:doc><![CDATA[Returned if the group was deleted.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if user requested an group that does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                        status="403"><ns2:doc><![CDATA[Returned if the current user does not have administrator permissions.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[Returned if the operation is not permitted or error occurs while deleting the group.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="user"><ns2:method id="addUserToGroup"
                            name="POST"><ns2:doc><![CDATA[Adds given user to a group.

 Returns the current state of the group.]]></ns2:doc><ns2:request><ns2:param
                            name="groupname" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A name of requested group.]]></ns2:doc></ns2:param><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested group was not found or requested user was not found.]]></ns2:doc></ns2:representation><ns2:representation
                            element="group" status="201"
                            mediaType="application/json"><ns2:doc><![CDATA[Returns full representation of a JIRA group in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if user requested an empty group name or the user already belongs to the group.]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the current user does not have administrator permissions.]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if the operation is not permitted or error occurs while adding user the group.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="removeUserFromGroup"
                            name="DELETE"><ns2:doc><![CDATA[Removes given user from a group.

 Returns no content]]></ns2:doc><ns2:request><ns2:param
                            name="groupname" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[A name of requested group.]]></ns2:doc></ns2:param><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[User to remove from a group]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested group was not found or the requested user wan not found]]></ns2:doc></ns2:representation><ns2:representation
                            element="group" status="200"
                            mediaType="application/json"><ns2:doc><![CDATA[If the user was removed from the group.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if user requested an empty group name]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the current user does not have administrator permissions.]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[Returned if the operation is not permitted or error occurs while removing user from the group.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/securitylevel"><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing an issue security level id]]></ns2:doc></ns2:param><ns2:method
                    id="getIssuesecuritylevel"
                            name="GET"><ns2:doc><![CDATA[Returns a full representation of the security level that has the given id.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue type does not exist, or is not visible to the calling user.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issuesecuritylevel" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://localhost:8090/jira/rest/api/2/securitylevel/10021","id":"10000","description":"Only the reporter and internal staff can see this issue.","name":"Reporter Only"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the issue type exists and is visible by the calling user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/issueLinkType"><ns2:doc><![CDATA[Rest resource to retrieve a list of issue link types.]]></ns2:doc><ns2:method
                id="getIssueLinkTypes"
                        name="GET"><ns2:doc><![CDATA[Returns a list of available issue link types, if issue linking is enabled.
 Each issue link type has an id, a name and a label for the outward and inward link relationship.]]></ns2:doc><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if issue linking is disabled.]]></ns2:doc></ns2:representation><ns2:representation
                        element="issueLinkTypes" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issueLinkTypes":[{"id":"1000","name":"Duplicate","inward":"Duplicated by","outward":"Duplicates","self":"http://www.example.com/jira/rest/api/2//issueLinkType/1000"},{"id":"1010","name":"Blocks","inward":"Blocked by","outward":"Blocks","self":"http://www.example.com/jira/rest/api/2//issueLinkType/1010"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a list of all available issue link types.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="createIssueLinkType"
                        name="POST"><ns2:doc><![CDATA[Create a new issue link type.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"Duplicate","inward":"Duplicated by","outward":"Duplicates"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Issue linking is disabled or you do not have permission to create issue link types.]]></ns2:doc></ns2:representation><ns2:representation
                        element="issueLinkType" status="201"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"1000","name":"Duplicate","inward":"Duplicated by","outward":"Duplicates","self":"http://www.example.com/jira/rest/api/2//issueLinkType/1000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The new issue link type has been created.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="/{issueLinkTypeId}"><ns2:param
                    name="issueLinkTypeId" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:method
                    id="getIssueLinkType"
                            name="GET"><ns2:doc><![CDATA[Returns for a given issue link type id all information about this issue link type.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if issue linking is disabled or no issue link type with the given id exists.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issueLinkType" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"1000","name":"Duplicate","inward":"Duplicated by","outward":"Duplicates","self":"http://www.example.com/jira/rest/api/2//issueLinkType/1000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns the issue link type with the given id.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteIssueLinkType"
                            name="DELETE"><ns2:doc><![CDATA[Delete the specified issue link type.]]></ns2:doc><ns2:response><ns2:representation
                            element="issueLinkType"
                            status="204"/><ns2:representation
                    status="404"><ns2:doc><![CDATA[Returned if issue linking is disabled or no issue link type with the given id exists.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateIssueLinkType"
                            name="PUT"><ns2:doc><![CDATA[Update the specified issue link type.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"Duplicate","inward":"Duplicated by","outward":"Duplicates"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if issue linking is disabled or no issue link type with the given id exists.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"1000","name":"Duplicate","inward":"Duplicated by","outward":"Duplicates","self":"http://www.example.com/jira/rest/api/2//issueLinkType/1000"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation><ns2:representation
            status="400"><ns2:doc><![CDATA[Returned if the supplied id is not a number.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="auth/1/websudo"><ns2:method id="release"
                        name="DELETE"><ns2:doc><![CDATA[This method invalidates the any current WebSudo session.]]></ns2:doc><ns2:response><ns2:representation
            status="204"><ns2:doc><![CDATA[Returned if no error occurs]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/settings"><ns2:doc><![CDATA[REST resource for changing the JIRA system settings]]></ns2:doc><ns2:resource
                    path="baseUrl"><ns2:method id="setBaseURL"
                            name="PUT"><ns2:doc><![CDATA[Sets the base URL that is configured for this JIRA instance.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>http://jira.atlassian.com/</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request></ns2:method></ns2:resource><ns2:resource
                    path="columns"><ns2:method
                    id="getIssueNavigatorDefaultColumns"
                            name="GET"><ns2:doc><![CDATA[Returns the default system columns for issue navigator. Admin permission will be required.]]></ns2:doc><ns2:response><ns2:representation
                            element="columns" status="200"
                            mediaType="application/json"><ns2:doc><![CDATA[Returns a list of columns for configured for the given user]]></ns2:doc></ns2:representation><ns2:representation
                            status="403"><ns2:doc><![CDATA[Returned if the user does not have admin permission]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setIssueNavigatorDefaultColumns"
                            name="PUT"><ns2:doc><![CDATA[Sets the default system columns for issue navigator. Admin permission will be required.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/x-www-form-urlencoded"><ns2:param
                                name="columns" style="query"
                                type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[list of column ids]]></ns2:doc></ns2:param></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="200"><ns2:doc><![CDATA[Returned when the columns is saved successfully]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[Returned if an error occurs while retrieving the column configuration.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/groups"><ns2:doc><![CDATA[REST endpoint for searching groups in a group picker]]></ns2:doc><ns2:resource
                    path="/picker"><ns2:method id="findGroups"
                            name="GET"><ns2:doc><![CDATA[Returns groups with substrings matching a given query. This is mainly for use with
 the group picker, so the returned groups contain html to be used as picker suggestions.
 The groups are also wrapped in a single response object that also contains a header for
 use in the picker, specifically <i>Showing X of Y matching groups</i>.

 The number of groups returned is limited by the system property "jira.ajax.autocomplete.limit"

 The groups will be unique and sorted.]]></ns2:doc><ns2:request><ns2:param
                            name="query" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String to match groups agains]]></ns2:doc></ns2:param><ns2:param
                            name="exclude" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:param
                            name="maxResults" style="query"
                            type="xs:int"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            element="groupsuggestions" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"header":"Showing 20 of 25 matching groups","total":25,"groups":[{"name":"jdog-developers","html":"&lt;b&gt;j&lt;/b&gt;dog-developers"},{"name":"juvenal-bot","html":"&lt;b&gt;j&lt;/b&gt;uvenal-bot"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned even if no groups match the given substring]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/issue"><ns2:method id="createIssue"
                        name="POST"><ns2:doc><![CDATA[Creates an issue or a sub-task from a JSON representation.
 <p>
 The fields that can be set on create, in either the fields parameter or the update parameter can be determined
 using the <b>/rest/api/2/issue/createmeta</b> resource.
 If a field is not configured to appear on the create screen, then it will not be in the createmeta, and a field
 validation error will occur if it is submitted.
 <p/>
 Creating a sub-task is similar to creating a regular issue, with two important differences:
 <ul>
     <li>the <code>issueType</code> field must correspond to a sub-task issue type (you can use
     <code>/issue/createmeta</code> to discover sub-task issue types), and</li>
     <li>you must provide a <code>parent</code> field in the issue create request containing the id or key of the
     parent issue.</li>
 </ul>]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"update":{"worklog":[{"add":{"started":"2011-07-05T11:05:00.000+0000","timeSpent":"60m"}}]},"fields":{"project":{"id":"10000"},"summary":"something's wrong","issuetype":{"id":"10000"},"assignee":{"name":"homer"},"reporter":{"name":"smithers"},"priority":{"id":"20000"},"labels":["bugfix","blitz_test"],"timetracking":{"originalEstimate":"10","remainingEstimate":"5"},"security":{"id":"10000"},"versions":[{"id":"10000"}],"environment":"environment","description":"description","duedate":"2011-03-11","fixVersions":[{"id":"10001"}],"components":[{"id":"10000"}],"customfield_60000":"jira-developers","customfield_20000":"06/Jul/11 3:25 PM","customfield_80000":{"value":"red"},"customfield_40000":"this is a text field","customfield_30000":["10000","10002"],"customfield_70000":["jira-administrators","jira-users"],"customfield_50000":"this is a text area. big text.","customfield_10000":"09/Jun/81"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        element="issue" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"10000","key":"TST-24","self":"http://www.example.com/jira/rest/api/2/issue/10000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a link to the created issue.]]></ns2:doc></ns2:representation><ns2:representation
                                status="400"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"errorMessages":["Field 'priority' is required"],"errors":{}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid field values, and so forth).]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{issueIdOrKey}/notify"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a string containing the issue id or key the comment will be added to]]></ns2:doc></ns2:param><ns2:method
                    id="notify"
                            name="POST"><ns2:doc><![CDATA[Sends a notification (email) to the list or recipients defined in the request.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"subject":"Duis eu justo eget augue iaculis fermentum.","textBody":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","htmlBody":"Lorem ipsum &lt;strong&gt;dolor&lt;/strong&gt; sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","to":{"reporter":false,"assignee":false,"watchers":true,"voters":true,"users":[{"name":"fred","active":false}],"groups":[{"name":"notification-group","self":"http://www.example.com/jira/rest/api/2/group?groupname=notification-group"}]},"restrict":{"groups":[{"name":"notification-group","self":"http://www.example.com/jira/rest/api/2/group?groupname=notification-group"}],"permissions":[{"id":"10","key":"BROWSE"}]}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if adding to the mail queue was successful]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned is outgoing emails are disabled OR no SMTP server is defined.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/comment/{id}"><ns2:param
                    name="id" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of the comment to be deleted]]></ns2:doc></ns2:param><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a string containing the issue id or key the comment belongs to]]></ns2:doc></ns2:param><ns2:method
                    id="getComments"
                            name="GET"><ns2:doc><![CDATA[Returns all comments for an issue.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[optional flags: renderedBody (provides body rendered in HTML)]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue with the given id/key does not exist or if the currently authenticated user does not
      have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"startAt":0,"maxResults":1,"total":1,"comments":[{"self":"http://www.example.com/jira/rest/api/2/issue/10010/comment/10000","id":"10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"created":"2014-01-28T14:28:59.922+0100","updated":"2014-01-28T14:28:59.922+0100","visibility":{"type":"role","value":"Administrators"}}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[returns a collection of comments associated with the issue, with count and pagination information.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateComment"
                            name="PUT"><ns2:doc><![CDATA[Updates an existing comment using its JSON representation.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[optional flags: renderedBody (provides body rendered in HTML)]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","visibility":{"type":"role","value":"Administrators"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/10010/comment/10000","id":"10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"created":"2014-01-28T14:28:59.922+0100","updated":"2014-01-28T14:28:59.922+0100","visibility":{"type":"role","value":"Administrators"}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if update was successful]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteComment"
                            name="DELETE"><ns2:doc><![CDATA[Deletes an existing comment .]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if delete was successful]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/comment"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a string containing the issue id or key the comment will be added to]]></ns2:doc></ns2:param><ns2:method
                    id="getComments"
                            name="GET"><ns2:doc><![CDATA[Returns all comments for an issue.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[optional flags: renderedBody (provides body rendered in HTML)]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue with the given id/key does not exist or if the currently authenticated user does not
      have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"startAt":0,"maxResults":1,"total":1,"comments":[{"self":"http://www.example.com/jira/rest/api/2/issue/10010/comment/10000","id":"10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"created":"2014-01-28T14:28:59.922+0100","updated":"2014-01-28T14:28:59.922+0100","visibility":{"type":"role","value":"Administrators"}}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[returns a collection of comments associated with the issue, with count and pagination information.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="addComment"
                            name="POST"><ns2:doc><![CDATA[Adds a new comment to an issue.]]></ns2:doc><ns2:request><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[optional flags: renderedBody (provides body rendered in HTML)]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","visibility":{"type":"role","value":"Administrators"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                    status="201"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/10010/comment/10000","id":"10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"created":"2014-01-28T14:28:59.922+0100","updated":"2014-01-28T14:28:59.922+0100","visibility":{"type":"role","value":"Administrators"}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if add was successful]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/assignee"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing an issue key]]></ns2:doc></ns2:param><ns2:method
                    id="assign"
                            name="PUT"><ns2:doc><![CDATA[Assigns an issue to a user.
 You can use this resource to assign issues when the user submitting the request has the assign permission but not the
 edit issue permission.
 If the name is "-1" automatic assignee is used.  A null name will remove the assignee.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"harry"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the issue is successfully assigned.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the issue or the user does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user does not have permission to assign the issue.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if there is a problem with the received user representation.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/transitions"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue you want to transition]]></ns2:doc></ns2:param><ns2:method
                    id="getTransitions"
                            name="GET"><ns2:doc><![CDATA[Get a list of the transitions possible for this issue by the current user, along with fields that are required and their types.

 <p>
 Fields will only be returned if <code>expand=transitions.fields</code>.
 <p>
 The fields in the metadata correspond to the fields in the transition screen for that transition.
 Fields not in the screen will not be in the metadata.]]></ns2:doc><ns2:request><ns2:param
                            name="transitionId" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue is not found or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"expand":"transitions","transitions":[{"id":"2","name":"Close Issue","to":{"self":"http://localhost:8090/jira/rest/api/2.0/status/10000","description":"The issue is currently being worked on.","iconUrl":"http://localhost:8090/jira/images/icons/progress.gif","name":"In Progress","id":"10000","statusCategory":{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/1","id":1,"key":"in-flight","colorName":"yellow"}},"fields":{"summary":{"required":false,"schema":{"type":"array","items":"option","custom":"com.atlassian.jira.plugin.system.customfieldtypes:multiselect","customId":10001},"name":"My Multi Select","operations":["set","add"],"allowedValues":["red","blue"]}}},{"id":"711","name":"QA Review","to":{"self":"http://localhost:8090/jira/rest/api/2.0/status/5","description":"The issue is closed.","iconUrl":"http://localhost:8090/jira/images/icons/closed.gif","name":"Closed","id":"5","statusCategory":{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/9","id":9,"key":"completed","colorName":"green"}},"fields":{"colour":{"required":false,"schema":{"type":"array","items":"option","custom":"com.atlassian.jira.plugin.system.customfieldtypes:multiselect","customId":10001},"name":"My Multi Select","operations":["set","add"],"allowedValues":["red","blue"]},"summary":{"required":false,"schema":{"type":"array","items":"option","custom":"com.atlassian.jira.plugin.system.customfieldtypes:multiselect","customId":10001},"name":"My Multi Select","operations":["set","add"],"allowedValues":["red","blue"]}}}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of the transitions possible for the specified issue and the fields required to perform the transition.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="doTransition"
                            name="POST"><ns2:doc><![CDATA[Perform a transition on an issue.
 When performing the transition you can udate or set other issue fields.
 <p>
 The fields that can be set on transtion, in either the fields parameter or the update parameter can be determined
 using the <b>/rest/api/2/issue/{issueIdOrKey}/transitions?expand=transitions.fields</b> resource.
 If a field is not configured to appear on the transition screen, then it will not be in the transition metadata, and a field
 validation error will occur if it is submitted.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"update":{"comment":[{"add":{"body":"Bug has been fixed."}}]},"fields":{"assignee":{"name":"bob"},"resolution":{"name":"Fixed"}},"transition":{"id":"5"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the transition was successful.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[The issue does not exist or the user does not have permission to view it]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[If there is no transition specified.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/votes"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue to view voting information for]]></ns2:doc></ns2:param><ns2:method
                    id="removeVote"
                            name="DELETE"><ns2:doc><![CDATA[Remove your vote from an issue. (i.e. "unvote")]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Nothing is returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="404"><ns2:doc><![CDATA[Returned if the user cannot remove a vote for any reason. (The user did not vote on the issue,
      the user is the reporter, voting is disabled, the issue does not exist, etc.)]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="addVote"
                            name="POST"><ns2:doc><![CDATA[Cast your vote in favour of an issue.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Nothing is returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="404"><ns2:doc><![CDATA[Returned if the user cannot vote for any reason. (The user is the reporter, the user does
      not have permission to vote, voting is disabled in the instance, the issue does not exist, etc.)]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="getVotes"
                            name="GET"><ns2:doc><![CDATA[A REST sub-resource representing the voters on the issue.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the user cannot view the issue in question or voting is disabled.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/issue/MKY-1/votes","votes":24,"hasVoted":true,"voters":[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Information about voting on the current issue.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}"><ns2:param name="issueIdOrKey"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue id or key to update (i.e. JRA-1330)]]></ns2:doc></ns2:param><ns2:method
                    id="getIssue"
                            name="GET"><ns2:doc><![CDATA[Returns a full representation of the issue for the given issue key.

 <p>
  An issue JSON consists of the issue key, a collection of fields,
  a link to the workflow transition sub-resource, and (optionally) the HTML rendered values of any fields that support it
  (e.g. if wiki syntax is enabled for the description or comments).

  <p>
  The <code>fields</code> param (which can be specified multiple times) gives a comma-separated list of fields
  to include in the response. This can be used to retrieve a subset of fields.
  A particular field can be excluded by prefixing it with a minus.
  <p>
   By default, all (<code>*all</code>) fields are returned in this get-issue resource. Note: the default is different
   when doing a jql search -- the default there is just navigable fields (<code>*navigable</code>).
  <ul>
      <li><code>*all</code> - include all fields</li>
      <li><code>*navigable</code> - include just navigable fields</li>
      <li><code>summary,comment</code> - include just the summary and comments</li>
      <li><code>-comment</code> - include everything except comments (the default is <code>*all</code> for get-issue)</li>
      <li><code>*all,-comment</code> - include everything except comments</li>
  </ul>

  <p>
  JIRA will attempt to identify the issue by the <code>issueIdOrKey</code> path parameter. This can be an issue id,
  or an issue key. If the issue cannot be found via an exact match, JIRA will also look for the issue in a case-insensitive way, or
  by looking to see if the issue was moved. In either of these cases, the request will proceed as normal (a 302 or other redirect
  will <b>not</b> be returned). The issue key contained in the response will indicate the current value of issue's key.]]></ns2:doc><ns2:request><ns2:param
                            name="fields" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the list of fields to return for the issue. By default, all fields are returned.]]></ns2:doc></ns2:param><ns2:param
                            name="expand" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"/></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue is not found, or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issue" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"expand":"renderedFields,names,schema,transitions,operations,editmeta,changelog","id":"10002","self":"http://www.example.com/jira/rest/api/2/issue/10002","key":"EX-1","fields":{"sub-tasks":[{"id":"10000","type":{"id":"10000","name":"","inward":"Parent","outward":"Sub-task"},"outwardIssue":{"id":"10003","key":"EX-2","self":"http://www.example.com/jira/rest/api/2/issue/EX-2","fields":{"status":{"iconUrl":"http://www.example.com/jira//images/icons/statuses/open.png","name":"Open"}}}}],"timetracking":{"originalEstimate":"10m","remainingEstimate":"3m","timeSpent":"6m","originalEstimateSeconds":600,"remainingEstimateSeconds":200,"timeSpentSeconds":400},"project":{"self":"http://www.example.com/jira/rest/api/2/project/EX","id":"10000","key":"EX","name":"Example","avatarUrls":{"24x24":"http://www.example.com/jira/secure/projectavatar?size=small&amp;pid=10000","16x16":"http://www.example.com/jira/secure/projectavatar?size=xsmall&amp;pid=10000","32x32":"http://www.example.com/jira/secure/projectavatar?size=medium&amp;pid=10000","48x48":"http://www.example.com/jira/secure/projectavatar?size=large&amp;pid=10000"}},"updated":1,"description":"example bug report","issuelinks":[{"id":"10001","type":{"id":"10000","name":"Dependent","inward":"depends on","outward":"is depended by"},"outwardIssue":{"id":"10004L","key":"PRJ-2","self":"http://www.example.com/jira/rest/api/2/issue/PRJ-2","fields":{"status":{"iconUrl":"http://www.example.com/jira//images/icons/statuses/open.png","name":"Open"}}}},{"id":"10002","type":{"id":"10000","name":"Dependent","inward":"depends on","outward":"is depended by"},"inwardIssue":{"id":"10004","key":"PRJ-3","self":"http://www.example.com/jira/rest/api/2/issue/PRJ-3","fields":{"status":{"iconUrl":"http://www.example.com/jira//images/icons/statuses/open.png","name":"Open"}}}}],"attachment":[{"self":"http://www.example.com/jira/rest/api/2.0/attachments/10000","filename":"picture.jpg","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"created":"2014-01-28T14:29:00.005+0100","size":23123,"mimeType":"image/jpeg","content":"http://www.example.com/jira/attachments/10000","thumbnail":"http://www.example.com/jira/secure/thumbnail/10000"}],"watcher":{"self":"http://www.example.com/jira/rest/api/2/issue/EX-1/watchers","isWatching":false,"watchCount":1,"watchers":[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false}]},"comment":[{"self":"http://www.example.com/jira/rest/api/2/issue/10010/comment/10000","id":"10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"body":"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eget venenatis elit. Duis eu justo eget augue iaculis fermentum. Sed semper quam laoreet nisi egestas at posuere augue semper.","updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"created":"2014-01-28T14:28:59.922+0100","updated":"2014-01-28T14:28:59.922+0100","visibility":{"type":"role","value":"Administrators"}}],"worklog":[{"self":"http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"comment":"I did some work here.","visibility":{"type":"group","value":"jira-developers"},"started":"2014-01-28T14:29:00.010+0100","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028"}]},"names":{"sub-tasks":"sub-tasks","timetracking":"timetracking","project":"project","updated":"updated","description":"description","issuelinks":"issuelinks","attachment":"attachment","watcher":"watcher","comment":"comment","worklog":"worklog"},"schema":{}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA issue in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteIssue"
                            name="DELETE"><ns2:doc><![CDATA[Delete an issue.

 If the issue has subtasks you must set the parameter deleteSubtasks=true to delete the issue.
 You cannot delete an issue without its subtasks also being deleted.]]></ns2:doc><ns2:request><ns2:param
                            name="deleteSubtasks" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String of true or false indicating that any subtasks should also be deleted.  If the
 issue has no subtasks this parameter is ignored.  If the issue has subtasks and this parameter is missing or false,
 then the issue will not be deleted and an error will be returned.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the issue was removed successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if an error occurs.]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to delete the issue.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="editIssue"
                            name="PUT"><ns2:doc><![CDATA[Edits an issue from a JSON representation.
 <p>
 The issue can either be updated by setting explicit the field value(s)
 or by using an operation to change the field value.
 <p>
 The fields that can be updated, in either the fields parameter or the update parameter, can be determined
 using the <b>/rest/api/2/issue/{issueIdOrKey}/editmeta</b> resource.<br>
 If a field is not configured to appear on the edit screen, then it will not be in the editmeta, and a field
 validation error will occur if it is submitted.
 <p>
 Specifying a "field_id": field_value in the "fields" is a shorthand for a "set" operation in the "update" section.<br>
 Field should appear either in "fields" or "update", not in both.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"update":{"summary":[{"set":"Bug in business logic"}],"timetracking":[{"edit":{"originalEstimate":"1w 1d","remainingEstimate":"4d"}}],"labels":[{"add":"triaged"},{"remove":"blocker"}],"components":[{"set":""}]},"fields":{"summary":"This is a shorthand for a set operation on the summary field","customfield_10010":1,"customfield_10000":"This is a shorthand for a set operation on a text custom field"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="200"
                            mediaType="application/json"><ns2:doc><![CDATA[Returned if it updated the issue succesfully.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if the requested issue update failed.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/watchers"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing an issue key.]]></ns2:doc></ns2:param><ns2:method
                    id="getIssueWatchers"
                            name="GET"><ns2:doc><![CDATA[Returns the list of watchers for the issue with the given key.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue is not found, or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="watchers" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/EX-1/watchers","isWatching":false,"watchCount":1,"watchers":[{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns the list of watchers for an issue.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="addWatcher"
                            name="POST"><ns2:doc><![CDATA[Adds a user to an issue's watcher list.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>"fred"</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the watcher was added successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the issue or the user does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user does not have permission to add the watcher to the issue's list of watchers.]]></ns2:doc></ns2:representation><ns2:representation
                    status="400"><ns2:doc><![CDATA[Returned if there is a problem with the received user representation.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="removeWatcher"
                            name="DELETE"><ns2:doc><![CDATA[Removes a user from an issue's watcher list.]]></ns2:doc><ns2:request><ns2:param
                            name="username" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the name of the user to remove from the watcher list. Must not be null.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the watcher was removed successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the issue does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user does not have permission to remove the watcher from the issue's list of
      watchers.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if a user name query parameter is not supplied.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="/bulk"><ns2:method id="createIssues"
                            name="POST"><ns2:doc><![CDATA[Creates issues or sub-tasks from a JSON representation.
 <p>
 Creates many issues in one bulk operation.
 <p/>
 Creating a sub-task is similar to creating a regular issue. More details can be found in createIssue section:
 {@link IssueResource#createIssue(IssueUpdateBean)}}]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issueUpdates":[{"update":{"worklog":[{"add":{"started":"2011-07-05T11:05:00.000+0000","timeSpent":"60m"}}]},"fields":{"project":{"id":"10000"},"summary":"something's wrong","issuetype":{"id":"10000"},"assignee":{"name":"homer"},"reporter":{"name":"smithers"},"priority":{"id":"20000"},"labels":["bugfix","blitz_test"],"timetracking":{"originalEstimate":"10","remainingEstimate":"5"},"security":{"id":"10000"},"versions":[{"id":"10000"}],"environment":"environment","description":"description","duedate":"2011-03-11","fixVersions":[{"id":"10001"}],"components":[{"id":"10000"}],"customfield_60000":"jira-developers","customfield_20000":"06/Jul/11 3:25 PM","customfield_80000":{"value":"red"},"customfield_40000":"this is a text field","customfield_30000":["10000","10002"],"customfield_70000":["jira-administrators","jira-users"],"customfield_50000":"this is a text area. big text.","customfield_10000":"09/Jun/81"}},{"update":{},"fields":{"project":{"id":"1000"},"summary":"something's very wrong","issuetype":{"id":"10000"},"assignee":{"name":"jerry"},"reporter":{"name":"kosecki"},"priority":{"id":"20000"},"labels":["new_release"],"timetracking":{"originalEstimate":"15","remainingEstimate":"5"},"security":{"id":"10000"},"versions":[{"id":"10000"}],"environment":"environment","description":"description","duedate":"2011-04-16","fixVersions":[{"id":"10001"}],"components":[{"id":"10000"}],"customfield_60000":"jira-developers","customfield_20000":"06/Jul/11 3:25 PM","customfield_80000":{"value":"red"},"customfield_40000":"this is a text field","customfield_30000":["10000","10002"],"customfield_70000":["jira-administrators","jira-users"],"customfield_50000":"this is a text area. big text.","customfield_10000":"09/Jun/81"}}]}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            element="issue" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issues":[{"id":"10000","key":"TST-24","self":"http://www.example.com/jira/rest/api/2/issue/10000"},{"id":"10001","key":"TST-25","self":"http://www.example.com/jira/rest/api/2/issue/10001"}],"errors":[]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a link to the created issue.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="400"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"status":400,"elementErrors":{"errorMessages":["Field 'priority' is required"],"errors":{}},"failedElementNumber":3}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid field values, and so forth).]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="createmeta"><ns2:method
                    id="getCreateIssueMeta"
                            name="GET"><ns2:doc><![CDATA[Returns the meta data for creating issues. This includes the available projects, issue types and fields,
 including field types and whether or not those fields are required.
 Projects will not be returned if the user does not have permission to create issues in that project.

 <p>
 The fields in the createmeta correspond to the fields in the create screen for the project/issuetype.
 Fields not in the screen will not be in the createmeta.

 <p>
 Fields will only be returned if <code>expand=projects.issuetypes.fields</code>.
 <p>
 The results can be filtered by project and/or issue type, given by the query params.]]></ns2:doc><ns2:request><ns2:param
                            name="projectIds" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[combined with the projectKeys param, lists the projects with which to filter the results. If absent, all projects are returned.
  This parameter can be specified multiple times, and/or be a comma-separated list.
  Specifiying a project that does not exist (or that you cannot create issues in) is not an error, but it will not be in the results.]]></ns2:doc></ns2:param><ns2:param
                            name="projectKeys" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[combined with the projectIds param, lists the projects with which to filter the results. If null, all projects are returned.
  This parameter can be specified multiple times, and/or be a comma-separated list.
  Specifiying a project that does not exist (or that you cannot create issues in) is not an error, but it will not be in the results.]]></ns2:doc></ns2:param><ns2:param
                            name="issuetypeIds" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[combinded with issuetypeNames, lists the issue types with which to filter the results. If null, all issue types are returned.
  This parameter can be specified multiple times, and/or be a comma-separated list.
  Specifiying an issue type that does not exist is not an error.]]></ns2:doc></ns2:param><ns2:param
                            name="issuetypeNames" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[combinded with issuetypeIds, lists the issue types with which to filter the results. If null, all issue types are returned.
  This parameter can be specified multiple times, but is NOT interpreted as a comma-separated list.
  Specifiying an issue type that does not exist is not an error.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"expand":"projects","projects":[{"self":"http://www.example.com/jira/rest/api/2/project/EX","id":"10000","key":"EX","name":"Example Project","avatarUrls":{"24x24":"http://www.example.com/jira/secure/projectavatar?size=small&amp;pid=10000&amp;avatarId=10011","16x16":"http://www.example.com/jira/secure/projectavatar?size=xsmall&amp;pid=10000&amp;avatarId=10011","32x32":"http://www.example.com/jira/secure/projectavatar?size=medium&amp;pid=10000&amp;avatarId=10011","48x48":"http://www.example.com/jira/secure/projectavatar?pid=10000&amp;avatarId=10011"},"issuetypes":[{"self":"http://www.example.com/jira/rest/api/2/issueType/1","id":"1","description":"An error in the code","iconUrl":"http://www.example.com/jira/images/icons/issuetypes/bug.png","name":"Bug","subtask":false,"fields":{"issuetype":{"required":true,"name":"Issue Type","operations":["set"]}}}]}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns the meta data for creating issues.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the user does not have permission to view any of the requested projects.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/editmeta"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue whose edit meta data you want to view]]></ns2:doc></ns2:param><ns2:method
                    id="getEditIssueMeta"
                            name="GET"><ns2:doc><![CDATA[Returns the meta data for editing an issue.
 <p>
 The fields in the editmeta correspond to the fields in the edit screen for the issue.
 Fields not in the screen will not be in the editemeta.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue is not found or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"fields":{"summary":{"required":false,"schema":{"type":"array","items":"option","custom":"com.atlassian.jira.plugin.system.customfieldtypes:multiselect","customId":10001},"name":"My Multi Select","operations":["set","add"],"allowedValues":["red","blue"]}}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a response containing a Map of FieldBeans for fields editable by the current user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/remotelink"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue to create the remote issue link for]]></ns2:doc></ns2:param><ns2:method
                    id="getRemoteIssueLinks"
                            name="GET"><ns2:doc><![CDATA[A REST sub-resource representing the remote issue links on the issue.]]></ns2:doc><ns2:request><ns2:param
                            name="globalId" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[The id of the remote issue link to be returned.  If null (not provided) all remote links for the
 issue are returned.
 <p>For a fullexplanation of Issue Link fields please refer to
 <a href="https://developer.atlassian.com/display/JIRADEV/Fields+in+Remote+Issue+Links">https://developer.atlassian.com/display/JIRADEV/Fields+in+Remote+Issue+Links</a></p>]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue or remote issue link do not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"id":10000,"self":"http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10000","globalId":"system=http://www.mycompany.com/support&amp;id=1","application":{"type":"com.acme.tracker","name":"My Acme Tracker"},"relationship":"causes","object":{"url":"http://www.mycompany.com/support?id=1","title":"TSTSUP-111","summary":"Crazy customer support issue","icon":{"url16x16":"http://www.mycompany.com/support/ticket.png","title":"Support Ticket"},"status":{"resolved":true,"icon":{"url16x16":"http://www.mycompany.com/support/resolved.png","title":"Case Closed","link":"http://www.mycompany.com/support?id=1&amp;details=closed"}}}},{"id":10001,"self":"http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10001","globalId":"system=http://www.anothercompany.com/tester&amp;id=1234","application":{"type":"com.acme.tester","name":"My Acme Tester"},"relationship":"is tested by","object":{"url":"http://www.anothercompany.com/tester/testcase/1234","title":"Test Case #1234","summary":"Test that the submit button saves the thing","icon":{"url16x16":"http://www.anothercompany.com/tester/images/testcase.gif","title":"Test Case"},"status":{"resolved":false,"icon":{"url16x16":"http://www.anothercompany.com/tester/images/person/fred.gif","title":"Tested by Fred Jones","link":"http://www.anothercompany.com/tester/person?username=fred"}}}}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Information on the remote issue links for the current issue.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to view the remote issue links, or if issue linking is
      disabled.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="createOrUpdateRemoteIssueLink"
                            name="POST"><ns2:doc><![CDATA[Creates or updates a remote issue link from a JSON representation. If a globalId is provided and a remote issue link
 exists with that globalId, the remote issue link is updated. Otherwise, the remote issue link is created.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"globalId":"system=http://www.mycompany.com/support&amp;id=1","application":{"type":"com.acme.tracker","name":"My Acme Tracker"},"relationship":"causes","object":{"url":"http://www.mycompany.com/support?id=1","title":"TSTSUP-111","summary":"Crazy customer support issue","icon":{"url16x16":"http://www.mycompany.com/support/ticket.png","title":"Support Ticket"},"status":{"resolved":true,"icon":{"url16x16":"http://www.mycompany.com/support/resolved.png","title":"Case Closed","link":"http://www.mycompany.com/support?id=1&amp;details=closed"}}}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            element="remote issue link" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":10000,"self":"http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a link to the created/updated remote issue link.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="400"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"errorMessages":[],"errors":{"title":"'title' is required."}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to create/update the remote issue link, or if issue linking
      is disabled.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteRemoteIssueLinkByGlobalId"
                            name="DELETE"><ns2:doc><![CDATA[Delete the remote issue link with the given global id on the issue.]]></ns2:doc><ns2:request><ns2:param
                            name="globalId" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the global id of the remote issue link]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the remote issue link was removed successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue or remote issue link do not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to delete the remote issue link, or if issue linking is
      disabled.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/remotelink/{linkId}"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue to create the remote issue link for]]></ns2:doc></ns2:param><ns2:param
                    name="linkId" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the remote issue link]]></ns2:doc></ns2:param><ns2:method
                    id="getRemoteIssueLinkById"
                            name="GET"><ns2:doc><![CDATA[Get the remote issue link with the given id on the issue.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue or remote issue link do not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":10000,"self":"http://www.example.com/jira/rest/api/issue/MKY-1/remotelink/10000","globalId":"system=http://www.mycompany.com/support&amp;id=1","application":{"type":"com.acme.tracker","name":"My Acme Tracker"},"relationship":"causes","object":{"url":"http://www.mycompany.com/support?id=1","title":"TSTSUP-111","summary":"Crazy customer support issue","icon":{"url16x16":"http://www.mycompany.com/support/ticket.png","title":"Support Ticket"},"status":{"resolved":true,"icon":{"url16x16":"http://www.mycompany.com/support/resolved.png","title":"Case Closed","link":"http://www.mycompany.com/support?id=1&amp;details=closed"}}}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Information on the remote issue link with the given id.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the linkId is not a valid number, or if the remote issue link with the given id does not belong to
      the given issue.]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to view the remote issue link, or if issue linking is
      disabled.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateRemoteIssueLink"
                            name="PUT"><ns2:doc><![CDATA[Updates a remote issue link from a JSON representation. Any fields not provided are set to null.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"globalId":"system=http://www.mycompany.com/support&amp;id=1","application":{"type":"com.acme.tracker","name":"My Acme Tracker"},"relationship":"causes","object":{"url":"http://www.mycompany.com/support?id=1","title":"TSTSUP-111","summary":"Crazy customer support issue","icon":{"url16x16":"http://www.mycompany.com/support/ticket.png","title":"Support Ticket"},"status":{"resolved":true,"icon":{"url16x16":"http://www.mycompany.com/support/resolved.png","title":"Case Closed","link":"http://www.mycompany.com/support?id=1&amp;details=closed"}}}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the remote issue link was updated successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="400"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"errorMessages":[],"errors":{"title":"'title' is required."}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to update the remote issue link, or if issue linking is
      disabled.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteRemoteIssueLinkById"
                            name="DELETE"><ns2:doc><![CDATA[Delete the remote issue link with the given id on the issue.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the remote issue link was removed successfully.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue or remote issue link do not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if the calling user is not authenticated.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to delete the remote issue link, or if issue linking is
      disabled.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/worklog"><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a string containing the issue id or key the worklog will be added to]]></ns2:doc></ns2:param><ns2:method
                    id="getIssueWorklog"
                            name="GET"><ns2:doc><![CDATA[Returns all work logs for an issue.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue with the given id/key does not exist or if the currently authenticated user does not
      have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"startAt":0,"maxResults":1,"total":1,"worklogs":[{"self":"http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"comment":"I did some work here.","visibility":{"type":"group","value":"jira-developers"},"started":"2014-01-28T14:29:00.010+0100","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028"}]}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[returns a collection of worklogs associated with the issue, with count and pagination information.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="addWorklog"
                            name="POST"><ns2:doc><![CDATA[Adds a new worklog entry to an issue.]]></ns2:doc><ns2:request><ns2:param
                            name="adjustEstimate" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(optional) allows you to provide specific instructions to update the remaining time estimate of the issue.  Valid values are
      <ul>
      <li>"new" - sets the estimate to a specific value</li>
      <li>"leave"- leaves the estimate as is</li>
      <li>"manual" - specify a specific amount to increase remaining estimate by</li>
      <li>"auto"- Default option.  Will automatically adjust the value based on the new timeSpent specified on the worklog</li> </ul>]]></ns2:doc></ns2:param><ns2:param
                            name="newEstimate" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(required when "new" is selected for adjustEstimate) the new value for the remaining estimate field. e.g. "2d"]]></ns2:doc></ns2:param><ns2:param
                            name="reduceBy" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(required when "manual" is selected for adjustEstimate) the amount to reduce the remaining estimate by e.g. "2d"]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"comment":"I did some work here.","visibility":{"type":"group","value":"jira-developers"},"started":"2014-01-28T14:29:00.010+0100","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="201"><ns2:doc><![CDATA[Returned if add was successful]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to add the worklog]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{issueIdOrKey}/worklog/{id}"><ns2:param
                    name="id" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[id of the worklog to be deleted]]></ns2:doc></ns2:param><ns2:param
                    name="issueIdOrKey" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a string containing the issue id or key the worklog belongs to]]></ns2:doc></ns2:param><ns2:method
                    id="getWorklog"
                            name="GET"><ns2:doc><![CDATA[Returns a specific worklog.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the work log with the given id does not exist or if the currently authenticated user does not
      have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="worklog" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"comment":"I did some work here.","visibility":{"type":"group","value":"jira-developers"},"started":"2014-01-28T14:29:00.010+0100","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the work log with the given id exists and the currently authenticated user has permission to
      view it. The returned response contains a full representation of the work log in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateWorklog"
                            name="PUT"><ns2:doc><![CDATA[Updates an existing worklog entry using its JSON representation.]]></ns2:doc><ns2:request><ns2:param
                            name="adjustEstimate" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(optional) allows you to provide specific instructions to update the remaining time estimate of the issue.  Valid values are
      <ul>
      <li>"new" - sets the estimate to a specific value</li>
      <li>"leave"- leaves the estimate as is</li>
      <li>"auto"- Default option.  Will automatically adjust the value based on the new timeSpent specified on the worklog</li> </ul>]]></ns2:doc></ns2:param><ns2:param
                            name="newEstimate" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(required when "new" is selected for adjustEstimate) the new value for the remaining estimate field.]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"comment":"I did some work here.","visibility":{"type":"group","value":"jira-developers"},"started":"2014-01-28T14:29:00.010+0100","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/issue/10010/worklog/10000","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"updateAuthor":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","displayName":"Fred F. User","active":false},"comment":"I did some work here.","visibility":{"type":"group","value":"jira-developers"},"started":"2014-01-28T14:29:00.010+0100","timeSpent":"3h 20m","timeSpentSeconds":12000,"id":"100028"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if update was successful]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation><ns2:representation
                    status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to update the worklog]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteWorklog"
                            name="DELETE"><ns2:doc><![CDATA[Deletes an existing worklog entry .]]></ns2:doc><ns2:request><ns2:param
                            name="adjustEstimate" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(optional) allows you to provide specific instructions to update the remaining time estimate of the issue.  Valid values are
      <ul>
      <li>"new" - sets the estimate to a specific value</li>
      <li>"leave"- leaves the estimate as is</li>
      <li>"manual" - specify a specific amount to increase remaining estimate by</li>
      <li>"auto"- Default option.  Will automatically adjust the value based on the new timeSpent specified on the worklog</li> </ul>]]></ns2:doc></ns2:param><ns2:param
                            name="newEstimate" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(required when "new" is selected for adjustEstimate) the new value for the remaining estimate field. e.g. "2d"]]></ns2:doc></ns2:param><ns2:param
                            name="increaseBy" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[(required when "manual" is selected for adjustEstimate) the amount to increase the remaining estimate by e.g. "2d"]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if delete was successful]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[Returned if the input is invalid (e.g. missing required fields, invalid values, and so forth).]]></ns2:doc></ns2:representation><ns2:representation
            status="403"><ns2:doc><![CDATA[Returned if the calling user does not have permission to delete the worklog]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/myself"><ns2:doc><![CDATA[Currently logged user resource]]></ns2:doc><ns2:method
                id="getUser"
                        name="GET"><ns2:doc><![CDATA[Returns currently logged user. This resource cannot be accessed anonymously.]]></ns2:doc><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the the user could not be found.]]></ns2:doc></ns2:representation><ns2:representation
                        element="user" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[{"name":"jira-user","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-user"},{"name":"jira-admin","self":"http://www.example.com/jira/rest/api/2/group?groupname=jira-admin"},{"name":"important","self":"http://www.example.com/jira/rest/api/2/group?groupname=important"}]},"expand":"groups"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA user in JSON format.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="updateUser"
                        name="PUT"><ns2:doc><![CDATA[Modify currently logged user. The "value" fields present will override the existing value.
 Fields skipped in request will not be changed. Only email and display name can be change that way.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"emailAddress":"eddie@atlassian.com","displayName":"Eddie of Atlassian"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the the user could not be found.]]></ns2:doc></ns2:representation><ns2:representation
                        element="user" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jirahttp://www.example.com/jira/rest/api/2/user/charlie","key":"charlie","name":"eddie","emailAddress":"eddie@atlassian.com","displayName":"Eddie of Atlassian"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the user exists and the caller has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[Returned if the request is invalid.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the current user is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="password"><ns2:method id="changeMyPassword"
                            name="PUT"><ns2:doc><![CDATA[Modify caller password.]]></ns2:doc><ns2:request><ns2:representation
                            mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if the user exists and the caller has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the caller does have permission to change user password but the user does not exist.]]></ns2:doc></ns2:representation><ns2:representation
            status="403"><ns2:doc><![CDATA[Returned if the caller does not have permission to change the user password.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/statuscategory"><ns2:method
                id="getStatusCategories"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all status categories]]></ns2:doc><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if no status categories are found, or the user does not have permission to view them.]]></ns2:doc></ns2:representation><ns2:representation
                        element="statusCategory" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/1","id":1,"key":"in-flight","colorName":"yellow"},{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/9","id":9,"key":"completed","colorName":"green"}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a list of all JIRA issue status categories in JSON format, that are visible to the user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{idOrKey}"><ns2:param name="idOrKey"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a numeric StatusCategory id or a status category key]]></ns2:doc></ns2:param><ns2:method
                    id="getStatusCategory"
                            name="GET"><ns2:doc><![CDATA[Returns a full representation of the StatusCategory having the given id or key]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested issue status category is not found, or the user does not have permission to view it.]]></ns2:doc></ns2:representation><ns2:representation
                            element="statusCategory" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://localhost:8090/jira/rest/api/2.0/statuscategory/1","id":1,"key":"in-flight","colorName":"yellow"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a full representation of a JIRA issue status category in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/attachment"><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the attachment to ddelete.]]></ns2:doc></ns2:param><ns2:method
                    id="getAttachment"
                            name="GET"><ns2:doc><![CDATA[Returns the meta-data for an attachment, including the URI of the actual attached file.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the attachment with the given id does not exist, or is not accessible by the calling user.]]></ns2:doc></ns2:representation><ns2:representation
                            element="attachment" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                    xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2.0/attachments/10000","filename":"picture.jpg","author":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":false},"created":"2014-01-28T14:29:00.005+0100","size":23123,"mimeType":"image/jpeg","content":"http://www.example.com/jira/attachments/10000","thumbnail":"http://www.example.com/jira/secure/thumbnail/10000"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of the attachment meta-data. The representation does not contain the
      attachment itself, but contains a URI that can be used to download the actual attached file.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="removeAttachment"
                            name="DELETE"><ns2:doc><![CDATA[Remove an attachment from an issue.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[Returned if successful.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the attachment is not found]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if attachments is disabled or if you don't have permission to remove attachments from this issue.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="meta"><ns2:method id="getAttachmentMeta"
                            name="GET"><ns2:doc><![CDATA[Returns the meta informations for an attachments, specifically if they are enabled and the maximum upload size allowed.]]></ns2:doc><ns2:response><ns2:representation
                            element="attachmentMeta" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"enabled":true,"uploadLimit":1000000}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a JSON representation of the attachment capabilities.
      Consumers of this resource may also need to check if the logged in user has permission to upload or
      otherwise manipulate attachments using the {@link com.atlassian.jira.rest.v2.permission.PermissionsResource}.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/issuetype"><ns2:method id="getIssueAllTypes"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all issue types visible to the user]]></ns2:doc><ns2:response><ns2:representation
                        status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://localhost:8090/jira/rest/api/2.0/issueType/3","id":"3","description":"A task that needs to be done.","iconUrl":"http://localhost:8090/jira/images/icons/issuetypes/task.png","name":"Task","subtask":false},{"self":"http://localhost:8090/jira/rest/api/2.0/issueType/1","id":"1","description":"A problem with the software.","iconUrl":"http://localhost:8090/jira/images/icons/issuetypes/bug.png","name":"Bug","subtask":false}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the issue type exists and is visible by the calling user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing an issue type id]]></ns2:doc></ns2:param><ns2:method
                    id="getIssueType"
                            name="GET"><ns2:doc><![CDATA[Returns a full representation of the issue type that has the given id.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue type does not exist, or is not visible to the calling user.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issueType" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://localhost:8090/jira/rest/api/2.0/issueType/3","id":"3","description":"A task that needs to be done.","iconUrl":"http://localhost:8090/jira/images/icons/issuetypes/task.png","name":"Task","subtask":false}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the issue type exists and is visible by the calling user.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/mypermissions"><ns2:doc><![CDATA[Provide permission information for the current user.]]></ns2:doc><ns2:method
                id="getPermissions"
                        name="GET"><ns2:doc><![CDATA[Returns all permissions in the system and whether the currently logged in user has them. You can optionally provide a specific context to get permissions for
 (projectKey OR projectId OR issueKey OR issueId)
 <ul>
    <li> When no context supplied the project related permissions will return true if the user has that permission in ANY project </li>
    <li> If a project context is provided, project related permissions will return true if the user has the permissions in the specified project.
        For permissions that are determined using issue data (e.g Current Assignee), true will be returned if the user meets the permission criteria in ANY issue in that project </li>
    <li> If an issue context is provided, it will return whether or not the user has each permission in that specific issue</li>
 </ul>
 <p>
    NB: The above means that for issue-level permissions (EDIT_ISSUE for example), hasPermission may be true when no context is provided, or when a project context is provided,
    <b>but</b> may be false for any given (or all) issues. This would occur (for example) if Reporters were given the EDIT_ISSUE permission. This is because
    any user could be a reporter, except in the context of a concrete issue, where the reporter is known.
 </p>
 <p>
    Global permissions will still be returned for all scopes.
 </p>]]></ns2:doc><ns2:request><ns2:param
                        name="projectKey" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- key of project to scope returned permissions for.]]></ns2:doc></ns2:param><ns2:param
                        name="projectId" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- id of project to scope returned permissions for.]]></ns2:doc></ns2:param><ns2:param
                        name="issueKey" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- key of the issue to scope returned permissions for.]]></ns2:doc></ns2:param><ns2:param
                        name="issueId" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- id of the issue to scope returned permissions for.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the project or issue id or key is not found.]]></ns2:doc></ns2:representation><ns2:representation
                        element="permission" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"permissions":{"EDIT_ISSUE":{"id":"12","key":"EDIT_ISSUE","name":"Edit Issues","description":"Ability to edit issues.","havePermission":true}}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a list of all permissions in JIRA and whether the user has them.]]></ns2:doc></ns2:representation><ns2:representation
            status="400"><ns2:doc><![CDATA[Returned if the project or issue id is invalid.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/priority"><ns2:method id="getPriorities"
                        name="GET"><ns2:doc><![CDATA[Returns a list of all issue priorities.]]></ns2:doc><ns2:response><ns2:representation
                        element="list of priorities" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>[{"self":"http://www.example.com/jira/rest/api/2/priority/3","statusColor":"#009900","description":"Major loss of function.","iconUrl":"http://www.example.com/jira/images/icons/priorities/major.png","name":"Major"},{"self":"http://www.example.com/jira/rest/api/2/priority/5","statusColor":"#cfcfcf","description":"Very little impact.","iconUrl":"http://www.example.com/jira/images/icons/priorities/trivial.png","name":"Trivial"}]</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the priorities exists and the user has permission to view it. Contains a full representation of
      the priority in JSON format.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the priority id]]></ns2:doc></ns2:param><ns2:method
                    id="getPriority"
                            name="GET"><ns2:doc><![CDATA[Returns an issue priority.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the issue priority does not exist or is not visible to the calling user.]]></ns2:doc></ns2:representation><ns2:representation
                            element="issuePriority" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2/priority/3","statusColor":"#009900","description":"Major loss of function.","iconUrl":"http://www.example.com/jira/images/icons/priorities/major.png","name":"Major"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the issue priority exists and is visible by the calling user. Contains a full representation of
      the issue priority in JSON.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2//reindex"><ns2:doc><![CDATA[REST resource for starting/stopping/querying indexing.]]></ns2:doc><ns2:method
                id="reindex"
                        name="POST"><ns2:doc><![CDATA[Kicks off a reindex.  Need Admin permissions to perform this reindex.]]></ns2:doc><ns2:request><ns2:param
                        name="type" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[Case insensitive String indicating type of reindex.  If omitted, then defaults to BACKGROUND_PREFERRED]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="202"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"progressUrl":"http://localhost:8080/jira","currentProgress":0,"type":"FOREGROUND","submittedTime":"2014-01-28T14:28:59.625+0100","startTime":"2014-01-28T14:28:59.625+0100","finishTime":"2014-01-28T14:28:59.625+0100","success":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a representation of the progress of the re-index operation.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="getReindexInfo"
                        name="GET"><ns2:doc><![CDATA[Returns information on the system reindexes.  If a reindex is currently taking place then information about this reindex is returned.
 If there is no active index task, then returns information about the latest reindex task run, otherwise returns a 404
 indicating that no reindex has taken place.]]></ns2:doc><ns2:request><ns2:param
                        name="taskId" style="query" type="xs:long"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of an indexing task you wish to obtain details on.  If omitted, then defaults to the standard behaviour and
 returns information on the active reindex task, or the last task to run if no reindex is taking place. .  If there is no
 reindexing task with that id then a 404 is returned.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if there is no re-indexing task found]]></ns2:doc></ns2:representation><ns2:representation
                        status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"progressUrl":"http://localhost:8080/jira","currentProgress":0,"type":"FOREGROUND","submittedTime":"2014-01-28T14:28:59.625+0100","startTime":"2014-01-28T14:28:59.625+0100","finishTime":"2014-01-28T14:28:59.625+0100","success":true}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns a representation of the progress of the re-index operation.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="auth/1/session"><ns2:doc><![CDATA[Implement a REST resource for acquiring a session cookie.]]></ns2:doc><ns2:method
                id="login"
                        name="POST"><ns2:doc><![CDATA[Creates a new session for a user in JIRA. Once a session has been successfully created it can be used to access
 any of JIRA's remote APIs and also the web UI by passing the appropriate HTTP Cookie header.
 <p/>
 Note that it is generally preferrable to use HTTP BASIC authentication with the REST API. However, this resource
 may be used to mimic the behaviour of JIRA's log-in page (e.g. to display log-in errors to a user).]]></ns2:doc><ns2:request><ns2:representation
                        element="credentials"
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"username":"fred","password":"freds_password"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                status="200"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"session":{"name":"JSESSIONID","value":"12345678901234567890"},"loginInfo":{"failedLoginCount":10,"loginCount":127,"lastFailedLoginTime":"2014-01-28T14:28:58.772+0100","previousLoginTime":"2014-01-28T14:28:58.772+0100"}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns information about the caller's session if the caller is authenticated.
      <p/>
      Note that the response contains the <code>Set-Cookie</code> HTTP headers that <b>must</b> be honoured by the
      caller. If you are using a cookie-aware HTTP client then it will handle all <code>Set-Cookie</code> headers
      automatically. This is important because setting the <code>JSESSIONID</code> cookie alone may not be
      sufficient for the authentication to work.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[Returned if the login fails due to invalid credentials.]]></ns2:doc></ns2:representation><ns2:representation
                status="403"><ns2:doc><![CDATA[Returned if the login is denied due to a CAPTCHA requirement, throtting, or any other reason. In case of a
      403 status code it is possible that the supplied credentials are valid but the user is not allowed to log in
      at this point in time.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="logout"
                        name="DELETE"><ns2:doc><![CDATA[Logs the current user out of JIRA, destroying the existing session, if any.]]></ns2:doc><ns2:response><ns2:representation
                        status="204"><ns2:doc><![CDATA[Returned if the user was successfully logged out.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if the caller is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                id="currentUser"
                        name="GET"><ns2:doc><![CDATA[Returns information about the currently authenticated user's session. If the caller is not authenticated they
 will get a 401 Unauthorized status code.]]></ns2:doc><ns2:response><ns2:representation
                                status="200"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"self":"http://www.example.com/jira/rest/api/2.0/user/fred","name":"fred","loginInfo":{"failedLoginCount":10,"loginCount":127,"lastFailedLoginTime":"2014-01-28T14:28:58.772+0100","previousLoginTime":"2014-01-28T14:28:58.772+0100"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation><ns2:representation
            status="401"><ns2:doc><![CDATA[Returned if the caller is not authenticated.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/workflowscheme"><ns2:method
                id="createScheme"
                        name="POST"><ns2:doc><![CDATA[Create a new workflow scheme.

 The body contains a representation of the new scheme. Values not passed are assumed to be set to their defaults.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"name":"New Workflow Scheme Name","description":"New Workflow Scheme Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId":"WorkflowName"}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                status="201"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The newly created scheme.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{id}/default"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="getDefault"
                            name="GET"><ns2:doc><![CDATA[Return the default workflow from the passed workflow scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="returnDraftIfExists" style="query"
                            type="xs:boolean" default="false"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when true indicates that a scheme's draft, if it exists, should be queried instead of
  the scheme itself.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned when the workflow scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteDefault"
                            name="DELETE"><ns2:doc><![CDATA[Remove the default workflow from the passed workflow scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="updateDraftIfNeeded" style="query"
                            type="xs:boolean"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when true will create and return a draft when the workflow scheme cannot be edited
 (e.g. when it is being used by a project).]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateDefault"
                            name="PUT"><ns2:doc><![CDATA[Set the default workflow for the passed workflow scheme.

 The passed representation can have its
 updateDraftIfNeeded flag set to true to indicate that the draft should be created/updated when the actual scheme
 cannot be edited.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName","updateDraftIfNeeded":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}"><ns2:param name="id" style="template"
                    type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="update"
                            name="PUT"><ns2:doc><![CDATA[Update the passed workflow scheme.

 The body of the request is a representation of the workflow scheme. Values not passed are assumed to indicate
 no change for that field.

 The passed representation can have its updateDraftIfNeeded flag set to true to indicate that the draft
 should be created and/or updated when the actual scheme cannot be edited (e.g. when the scheme is being used by
 a project). Values not appearing the body will not be touched.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":57585,"name":"Updated Workflow Scheme Name","description":"Updated Workflow Scheme Name","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId":"WorkflowName"},"updateDraftIfNeeded":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The updated scheme.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="getById"
                            name="GET"><ns2:doc><![CDATA[Returns the requested workflow scheme to the caller.]]></ns2:doc><ns2:request><ns2:param
                            name="returnDraftIfExists" style="query"
                            type="xs:boolean" default="false"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when true indicates that a scheme's draft, if it exists, should be queried instead of
  the scheme itself.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the scheme exists and the caller has permission to see it.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteScheme"
                            name="DELETE"><ns2:doc><![CDATA[Delete the passed workflow scheme.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[If the scheme was deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation><ns2:representation
                status="400"><ns2:doc><![CDATA[Returned if the requested scheme is active (i.e. being used by JIRA).]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/draft"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the parent scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="getDraftById"
                            name="GET"><ns2:doc><![CDATA[Returns the requested draft workflow scheme to the caller.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested draft scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the scheme exists and the caller has permission to see it.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteDraftById"
                            name="DELETE"><ns2:doc><![CDATA[Delete the passed draft workflow scheme.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[If the scheme was deleted.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested draft scheme or parent scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateDraft"
                            name="PUT"><ns2:doc><![CDATA[Update a draft workflow scheme. The draft will created if necessary.

 The body is a representation of the workflow scheme. Values not passed are assumed to indicate no change for that field.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":57585,"name":"Updated Workflow Scheme Name","description":"Updated Workflow Scheme Name","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId":"WorkflowName"},"updateDraftIfNeeded":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The updated/created scheme.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/createdraft"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the parent scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="createDraftForParent"
                            name="POST"><ns2:doc><![CDATA[Create a draft for the passed scheme. The draft will be a copy of the state of the parent.]]></ns2:doc><ns2:response><ns2:representation
                                    status="201"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The newly created scheme.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/workflow"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="getWorkflow"
                            name="GET"><ns2:doc><![CDATA[Returns the workflow mappings or requested mapping to the caller for the passed scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="workflowName" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the workflow mapping to return. Null can be passed to return all mappings. Must be a valid workflow name.]]></ns2:doc></ns2:param><ns2:param
                            name="returnDraftIfExists" style="query"
                            type="xs:boolean" default="false"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when true indicates that a scheme's draft, if it exists, should be queried instead of
  the scheme itself.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or workflow does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName","issueTypes":["IssueTypeId","IssueTypeId2"],"defaultMapping":false}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteWorkflowMapping"
                            name="DELETE"><ns2:doc><![CDATA[Delete the passed workflow from the workflow scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="workflowName" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the name of the workflow to delete.]]></ns2:doc></ns2:param><ns2:param
                            name="updateDraftIfNeeded" style="query"
                            type="xs:boolean"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[flag to indicate if a draft should be created if necessary to delete the workflow
   from the scheme.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested scheme or workflow does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"><ns2:doc><![CDATA[The scheme with the workflow deleted.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateWorkflowMapping"
                            name="PUT"><ns2:doc><![CDATA[Update the scheme to include the passed mapping.

 The body is a representation of the workflow mapping.
 Values not passed are assumed to indicate no change for that field.

 The passed representation can have its updateDraftIfNeeded flag set to true to indicate that the draft
 should be created/updated when the actual scheme cannot be edited.]]></ns2:doc><ns2:request><ns2:param
                            name="workflowName" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the name of the workflow mapping to update.]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName3","issueTypes":["IssueTypeId"],"updateDraftIfNeeded":true}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The updated scheme.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/draft/workflow"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the parent scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="getDraftWorkflow"
                            name="GET"><ns2:doc><![CDATA[Returns the draft workflow mappings or requested mapping to the caller.]]></ns2:doc><ns2:request><ns2:param
                            name="workflowName" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the workflow mapping to return. Null can be passed to return all mappings. Must be a valid workflow name.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or workflow does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName","issueTypes":["IssueTypeId","IssueTypeId2"],"defaultMapping":false}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteDraftWorkflowMapping"
                            name="DELETE"><ns2:doc><![CDATA[Delete the passed workflow from the draft workflow scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="workflowName" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the name of the workflow to delete.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the requested scheme or workflow does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"><ns2:doc><![CDATA[The scheme with the workflow deleted.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateDraftWorkflowMapping"
                            name="PUT"><ns2:doc><![CDATA[Update the draft scheme to include the passed mapping.

 The body is a representation of the workflow mapping.
 Values not passed are assumed to indicate no change for that field.]]></ns2:doc><ns2:request><ns2:param
                            name="workflowName" style="query"
                            type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the name of the workflow mapping to update.]]></ns2:doc></ns2:param><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName3","issueTypes":["IssueTypeId"],"updateDraftIfNeeded":true}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[The updated scheme.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/issuetype/{issueType}"><ns2:param
                    name="id" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the scheme.]]></ns2:doc></ns2:param><ns2:param
                    name="issueType" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue type being set.]]></ns2:doc></ns2:param><ns2:method
                    id="getIssueType"
                            name="GET"><ns2:doc><![CDATA[Returns the issue type mapping for the passed workflow scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="returnDraftIfExists" style="query"
                            type="xs:boolean" default="false"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when true indicates that a scheme's draft, if it exists, should be queried instead of
  the scheme itself.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or issue type does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issueType":"IssueTypeId","workflow":"WorkflowName"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteIssueType"
                            name="DELETE"><ns2:doc><![CDATA[Remove the specified issue type mapping from the scheme.]]></ns2:doc><ns2:request><ns2:param
                            name="updateDraftIfNeeded" style="query"
                            type="xs:boolean"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when true will create and return a draft when the workflow scheme cannot be edited
 (e.g. when it is being used by a project).]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or issue type does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setIssueType"
                            name="PUT"><ns2:doc><![CDATA[Set the issue type mapping for the passed scheme.

 The passed representation can have its updateDraftIfNeeded flag set to true to indicate that
 the draft should be created/updated when the actual scheme cannot be edited.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issueType":"IssueTypeId","workflow":"WorkflowName","updateDraftIfNeeded":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or issue type does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":101010,"name":"Workflow Scheme One","description":"Workflow Scheme One Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"draft":false,"self":"http://www.example.com/jira/rest/api/2/workflowscheme/101010"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/draft/issuetype/{issueType}"><ns2:param
                    name="id" style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the parent scheme.]]></ns2:doc></ns2:param><ns2:param
                    name="issueType" style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue type being set.]]></ns2:doc></ns2:param><ns2:method
                    id="getDraftIssueType"
                            name="GET"><ns2:doc><![CDATA[Returns the issue type mapping for the passed draft workflow scheme.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or issue type does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issueType":"IssueTypeId","workflow":"WorkflowName"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteDraftIssueType"
                            name="DELETE"><ns2:doc><![CDATA[Remove the specified issue type mapping from the draft scheme.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or issue type does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="setDraftIssueType"
                            name="PUT"><ns2:doc><![CDATA[Set the issue type mapping for the passed draft scheme.

 The passed representation can have its updateDraftIfNeeded flag set to true to indicate that
 the draft should be created/updated when the actual scheme cannot be edited.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"issueType":"IssueTypeId","workflow":"WorkflowName","updateDraftIfNeeded":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if either the requested scheme or issue type does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource><ns2:resource
                    path="{id}/draft/default"><ns2:param name="id"
                    style="template" type="xs:long"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the id of the parent scheme.]]></ns2:doc></ns2:param><ns2:method
                    id="getDraftDefault"
                            name="GET"><ns2:doc><![CDATA[Return the default workflow from the passed draft workflow scheme to the caller.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned when the workflow scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteDraftDefault"
                            name="DELETE"><ns2:doc><![CDATA[Remove the default workflow from the passed draft workflow scheme.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
                    status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="updateDraftDefault"
                            name="PUT"><ns2:doc><![CDATA[Set the default workflow for the passed draft workflow scheme.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"workflow":"WorkflowName","updateDraftIfNeeded":false}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the scheme does not exist.]]></ns2:doc></ns2:representation><ns2:representation
                                    status="200"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":17218781,"name":"Workflow Scheme Two","description":"Workflow Scheme Two Description","defaultWorkflow":"DefaultWorkflowName","issueTypeMappings":{"IsueTypeId2":"WorkflowName","IsueTypeId":"WorkflowName"},"originalDefaultWorkflow":"ParentsDefaultWorkflowName","originalIssueTypeMappings":{"IssueTypeId":"WorkflowName2"},"draft":true,"lastModifiedUser":{"self":"http://www.example.com/jira/rest/api/2/user?username=fred","name":"fred","emailAddress":"fred@example.com","avatarUrls":{"24x24":"http://www.example.com/jira/secure/useravatar?size=small&amp;ownerId=fred","16x16":"http://www.example.com/jira/secure/useravatar?size=xsmall&amp;ownerId=fred","32x32":"http://www.example.com/jira/secure/useravatar?size=medium&amp;ownerId=fred","48x48":"http://www.example.com/jira/secure/useravatar?size=large&amp;ownerId=fred"},"displayName":"Fred F. User","active":true,"timeZone":"Australia/Sydney","groups":{"size":3,"items":[]}},"lastModified":"Today 12:45","self":"http://www.example.com/jira/rest/api/2/workflowscheme/17218781/draft"}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned on success.]]></ns2:doc></ns2:representation><ns2:representation
            status="401"><ns2:doc><![CDATA[Returned if there is no user or if the user has not entered a websudo
      session.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/licenseValidator"><ns2:doc><![CDATA[A REST endpoint to provide simple validation services for a JIRA license.
 Typically used by the setup phase of the JIRA application.  This will return an object
 with a list of errors as key, value pairs.]]></ns2:doc><ns2:method
                id="validate"
                        name="POST"><ns2:request><ns2:representation
                        mediaType="application/json"/></ns2:request><ns2:response><ns2:representation
            mediaType="application/json"/></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/issueLink"><ns2:doc><![CDATA[The Link Issue Resource provides functionality to manage issue links.]]></ns2:doc><ns2:method
                id="linkIssues"
                        name="POST"><ns2:doc><![CDATA[Creates an issue link between two issues.
 The user requires the link issue permission for the issue which will be linked to another issue.
 The specified link type in the request is used to create the link and will create a link from the first issue
 to the second issue using the outward description. It also create a link from the second issue to the first issue using the
 inward description of the issue link type.
 It will add the supplied comment to the first issue. The comment can have a restriction who can view it.
 If group is specified, only users of this group can view this comment, if roleLevel is specified only users who have the specified role can view this comment.
 The user who creates the issue link needs to belong to the specified group or have the specified role.]]></ns2:doc><ns2:request><ns2:representation
                                mediaType="application/json"><ns2:doc><ns3:p
                        xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"type":{"name":"Duplicate"},"inwardIssue":{"key":"HSP-1"},"outwardIssue":{"key":"MKY-1"},"comment":{"body":"Linked related issue!","visibility":{"type":"group","value":"jira-users"}}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[If issue linking is disabled or
      it failed to find one of the issues (issue might exist, but it is not visible for this user) or
      it failed to find the specified issue link type.]]></ns2:doc></ns2:representation><ns2:representation
                        status="200"
                        mediaType="application/json"><ns2:doc><![CDATA[if the issue link was created successfully.]]></ns2:doc></ns2:representation><ns2:representation
                        status="401"><ns2:doc><![CDATA[if the user does not have the link issue permission for the issue, which will be linked to another issue.]]></ns2:doc></ns2:representation><ns2:representation
                        status="400"><ns2:doc><![CDATA[if it can't create the supplied comment.
      The response will contain an error message indicating why it failed to create the comment.
      No issue link will be created if it failed to create the comment.]]></ns2:doc></ns2:representation><ns2:representation
                status="500"><ns2:doc><![CDATA[if an error occurred when creating the issue link or the comment.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="{linkId}"><ns2:param name="linkId"
                    style="template" type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the issue link id.]]></ns2:doc></ns2:param><ns2:method
                    id="getIssueLink"
                            name="GET"><ns2:doc><![CDATA[Returns an issue link with the specified id.]]></ns2:doc><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[If issue linking is disabled or
      it failed to find an issue link with the specified id. Either because none exists with this id, or the user
      doesn't have the permission to see one of the linked issues.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"10001","type":{"id":"1000","name":"Duplicate","inward":"Duplicated by","outward":"Duplicates","self":"http://www.example.com/jira/rest/api/2//issueLinkType/1000"},"inwardIssue":{"id":"10004","key":"PRJ-3","self":"http://www.example.com/jira/rest/api/2/issue/PRJ-3","fields":{"status":{"iconUrl":"http://www.example.com/jira//images/icons/statuses/open.png","name":"Open"}}},"outwardIssue":{"id":"10004L","key":"PRJ-2","self":"http://www.example.com/jira/rest/api/2/issue/PRJ-2","fields":{"status":{"iconUrl":"http://www.example.com/jira//images/icons/statuses/open.png","name":"Open"}}}}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation><ns2:representation
                            status="401"><ns2:doc><![CDATA[if the user does not have the link issue permission for the issue, which will be linked to another issue.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[If the specified issue link id is invalid.]]></ns2:doc></ns2:representation><ns2:representation
                    status="500"><ns2:doc><![CDATA[if an error occurred when creating the issue link or the comment.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:method
                    id="deleteIssueLink"
                            name="DELETE"><ns2:doc><![CDATA[Deletes an issue link with the specified id.
 To be able to delete an issue link you must be able to view both issues and must have the link issue permission
 for at least one of the issues.]]></ns2:doc><ns2:response><ns2:representation
                            status="204"><ns2:doc><![CDATA[If it successfully deleted the issue link.]]></ns2:doc></ns2:representation><ns2:representation
                            status="404"><ns2:doc><![CDATA[If issue linking is disabled or
      it failed to find an issue link with the specified id. Either because none exists with this id, or the user
      doesn't have the permission to see one of the linked issues.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"
                            mediaType="application/json"/><ns2:representation
                            status="401"><ns2:doc><![CDATA[if the user does not have the link issue permission for the source or destination issue of the issue link.]]></ns2:doc></ns2:representation><ns2:representation
                            status="400"><ns2:doc><![CDATA[If the specified issue link id is invalid.]]></ns2:doc></ns2:representation><ns2:representation
            status="500"><ns2:doc><![CDATA[if an error occurred when deleting the issue link or the comment.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/application-properties"><ns2:method
                id="getProperty"
                        name="GET"><ns2:doc><![CDATA[Returns an application property.]]></ns2:doc><ns2:request><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[a String containing the property key]]></ns2:doc></ns2:param><ns2:param
                        name="permissionLevel" style="query"
                        type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when fetching a list specifies the permission level of all items in the list
      see {@link com.atlassian.jira.bc.admin.ApplicationPropertiesService.EditPermissionLevel}]]></ns2:doc></ns2:param><ns2:param
                        name="keyFilter" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[when fetching a list allows the list to be filtered by the property's start of key
      e.g. "jira.lf.*" whould fetch only those permissions that are editable and whose keys start with
      "jira.lf.". This is a regex.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                        status="404"><ns2:doc><![CDATA[Returned if the property does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                        element="property" status="200"
                                mediaType="application/json"><ns2:doc><ns3:p
                xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"jira.home","key":"jira.home","value":"/var/jira/jira-home","name":"jira.home","desc":"JIRA home directory","type":"string","defaultValue":""}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returned if the property exists and the currently authenticated user has permission to view it. Contains a
      full representation of the property.]]></ns2:doc></ns2:representation></ns2:response></ns2:method><ns2:resource
                    path="/{id}"><ns2:param name="id" style="template"
                    type="xs:string"
                    xmlns:xs="http://www.w3.org/2001/XMLSchema"/><ns2:method
                    id="setPropertyViaRestfulTable"
                            name="PUT"><ns2:doc><![CDATA[Modify an application property via PUT. The "value" field present in the PUT will override thee existing value.]]></ns2:doc><ns2:request><ns2:representation
                                    mediaType="*/*"><ns2:doc><ns3:p
                            xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"id":"jira.home","value":"/var/jira/jira-home"}</ns3:code></ns3:pre></ns3:p></ns2:doc></ns2:representation></ns2:request><ns2:response><ns2:representation
                            status="404"><ns2:doc><![CDATA[Returned if the version does not exist or the currently authenticated user does not have permission to
      view it.]]></ns2:doc></ns2:representation><ns2:representation
                            status="200"><ns2:doc><![CDATA[Returned if the version exists and the currently authenticated user has permission to edit it.]]></ns2:doc></ns2:representation><ns2:representation
            status="403"><ns2:doc><![CDATA[Returned if the currently authenticated user does not have permission to edit the version.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource><ns2:resource
                path="api/2/mypreferences"><ns2:doc><![CDATA[Provide preferences of the currently logged in user.]]></ns2:doc><ns2:method
                id="getPreference"
                        name="GET"><ns2:doc><![CDATA[Returns preference of the currently logged in user. Preference key must be provided as input parameter (key). The
 value is returned exactly as it is. If key parameter is not provided or wrong - status code 404. If value is
 found  - status code 200.]]></ns2:doc><ns2:request><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- key of the preference to be returned.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:doc><![CDATA[response with value of one preference of currently logged in user.]]></ns2:doc><ns2:representation
                mediaType="application/json"/></ns2:response></ns2:method><ns2:method
                id="setPreference"
                        name="PUT"><ns2:doc><![CDATA[Sets preference of the currently logged in user. Preference key must be provided as input parameters (key). Value
 must be provided as post body. If key or value parameter is not provided - status code 404. If preference is set
 - status code 204.]]></ns2:doc><ns2:request><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- key of the preference to be set.]]></ns2:doc></ns2:param><ns2:representation
                        mediaType="application/json"/></ns2:request><ns2:response><ns2:doc><![CDATA[empty response]]></ns2:doc><ns2:representation
                mediaType="application/json"/></ns2:response></ns2:method><ns2:method
                id="removePreference"
                        name="DELETE"><ns2:doc><![CDATA[Removes preference of the currently logged in user. Preference key must be provided as input parameters (key). If
 key parameter is not provided or wrong - status code 404. If preference is unset - status code 204.]]></ns2:doc><ns2:request><ns2:param
                        name="key" style="query" type="xs:string"
                        xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[- key of the preference to be removed.]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:doc><![CDATA[empty response]]></ns2:doc><ns2:representation
            mediaType="application/json"/></ns2:response></ns2:method></ns2:resource><ns2:resource
                path="api/2/projectvalidate"><ns2:resource
                    path="key"><ns2:method id="getProject"
                            name="GET"><ns2:doc><![CDATA[Validates a project key.]]></ns2:doc><ns2:request><ns2:param
                            name="key" style="query" type="xs:string"
                            xmlns:xs="http://www.w3.org/2001/XMLSchema"><ns2:doc><![CDATA[the project key]]></ns2:doc></ns2:param></ns2:request><ns2:response><ns2:representation
                            element="errorCollection" status="200"
                                    mediaType="application/json"><ns2:doc><ns3:p xmlns:ns3="http://www.w3.org/1999/xhtml"><ns3:h6>Example</ns3:h6><ns3:pre><ns3:code>{"errorMessages":[],"errors":{"projectKey":"A project with that project key already exists."}}</ns3:code></ns3:pre></ns3:p></ns2:doc><ns2:doc><![CDATA[Returns an ErrorCollection containing any validation errors for the project key.]]></ns2:doc></ns2:representation></ns2:response></ns2:method></ns2:resource></ns2:resource></ns2:resources></ns2:application>