Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrating "REST API: Project Tree" to an improved template

com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/foldertree/id

GETcom.easesolutions.jira.plugins.requirement1s/1.0/search/prjKeySearch for project tree folders and retrieve detailed information for the found elements.
GETcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKeyGet the complete project tree structure for a given project.
POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/reuseTrigger a requirements reuse. Source and target may be in different projects.
POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/createscheduledjobAllows the creation of jobs for the scheduled adding of existing issues.
GETcom.easesolutions.jira.plugins.requirements/1.0/tree/totalItemCount/prjKey
Status
title4.2.0
 Returns total item count of project tree. 



GETcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/foldersGet complete tree structure of project.
GETcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/foldertree/idGet complete tree structure with or without issues for certain project tree folder.
POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderCreate a new project tree folder below the root folder of a given project.
POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/idCreate a new project tree folder below a specified folder of a given project.
PUTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/idRename a folder using project key.
DELETEcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id

Delete a project tree folder from a given project.



POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/rootissueAdd an existing issue to the root folder of a given project.
DELETEcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/rootissueRemove an issue from the root folder of a given project.
POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderissue/id

Add an existing issue to a specified tree folder of a given project.

DELETEcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderissue/idRemove an issue from a specified tree folder of a given project.
POSTcom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/moveissueMove an issue from one tree folder to another one of the same project.



GETcom.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKeyGet all child requirements for a given issue in a specific project.
POSTcom.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKeyAdd a child requirement to an issue in the project tree a given project.
DELETEcom.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey

Remove a child requirement from an issue in the project tree of a given project.

...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/search/prjKey

Search for project tree folders and retrieve detailed information for the found elements.  

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/search/prjKey?type&pathSep&path



PARAMETERS
parametertypedescription
prjKey*stringthe project key
typestringitemtype to search for (should be "folder")
pathSepstringseperator chars used in path (default "/")
pathstringthe path to search in



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if tree element is found

Code Block
languagejava
titleExample response
{
  	"folders": [
    	{
      		"name": "First",
      		"id": 9,
      		"name_display":"First",
      		"parent": -1,
      		"folders": [
        		{
          			"name": "Second",
          			"id": 14,
          			"name_display":"Second",
          			"parent": 9,
          			"folders": [],
          			"issues": [],
          			"position": 2
        		},
      		],
      		"issues": [],
      		"position": 3
    	}
  	],
  	"issues": []
}

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, type is invalid, the path separator is invalid or path is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey

Get the complete project tree structure for a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey?n



PARAMETERS
parametertypedescription
prjKey*stringthe project key
nstringtoggles structure numbering prefix for folder names (0 = disabled (default), 1 = enabled)



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if tree structure of an existing project is found

Code Block
languagejava
titleExample response
{
  	"id": -1,
  	"folders": [
		{
      		"name": "First",
      		"id": 56,
      		"name_display": "First",
      		"parent": -1,
      		"folders": [
        		{
          			"name": "Third",
          			"id": 69,
          			"name_display": "Third",
          			"parent": 56,
          			"folders": [],
          			"issues": [
            			{
              				"id": 132,
              				"issueId": 10157,
              				"key": "AN-4",
              				"url": "http://<server-name>/browse/AN-4",
              				"summary": "Second",
              				"description": "Issue number 61",
              				"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
              				"issueType": "New Feature",
              				"position": 1
            			},
            			{
              				"id": 131,
              				"issueId": 10155,
              				"key": "AN-2",
              				"url": "http://<server-name>/browse/AN-2",
              				"summary": "Second",
              				"description": "Second",
              				"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
              				"issueType": "New Feature",
              				"position": 2
            			}
          			],
         			"position": 1
        		}
			],
    		"issues": [],
    		"position": 1
		},
		{
			"name": "Test",
			"id": 67,
			"name_display": "Test",
			"parent": -1,
			"folders": [
				{
					"name": "Second",
					"id": 68,
					"name_display": "Second",
					"parent": 67,
					"folders": [],
					"issues": [
						{
							"id": 127,
							"issueId": 10155,
							"key": "AN-2",
							"url": "http://<server-name>/browse/AN-2",
							"summary": "Second",
							"description": "Second",
							"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
							"issueType": "New Feature",
							"position": 1
						},
						{
							"id": 118,
							"issueId": 10154,
							"key": "AN-1",
							"url": "http://<server-name>/browse/AN-1",
							"summary": "First",
							"description": "First issue textasd",
							"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
							"issueType": "New Feature",
							"position": 2
						}
					],
					"position": 1
				}
			],
			"issues": [],
			"position": 2
		},
		{
			"name": "Root",
			"id": 75,
			"name_display": "Root",
			"parent": -1,
			"folders": [],
			"issues": [],
			"position": 3
		},
		{
			"name": "Test",
			"id": 70,
			"name_display": "Test",
			"parent": -1,
			"folders": [],
			"issues": [],
			"position": 4
		}
	],
	"issues": []
} 

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/reuse

Trigger a requirements reuse. Source and target may be in different projects.

Expand
titleClick here for details...


Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/reuse
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/reuse?source&target&ruleName



PARAMETERS
parametertypedescription
sourcestringthe source folder for reuse (e.g. Requirements Plugin/Implementation)
targetstringthe target folder for the reuse (e.g. Requirements Plugin/Features/Baseline/Permissions)
ruleNamestringthe name of a reuse rule (e.g. "rule 27")



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if requirement is successfully reused

Code Block
languagejava
titleExample Response
Reuse Success

Status
colourRed
titleSTATUS 400
- Returned if source folder is invalid, source project is invalid, target folder is invalid, target project is invalid, the reuse rule name is invalid or an error occurs while processing reuse

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version



...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/createscheduledjob

Allows the creation of jobs for the scheduled adding of existing issues.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/createscheduledjob?name&folderId&filter&interval



PARAMETERS
parametertypedescription
prjKey*stringthe project key of the project
namestringthe name of the scheduled job
folderIdlongthe folder id of the tree folder
filterstringthe JQL, JIRA filter, or if null will default to add all issues from the project that have not added to the project tree
intervallongthe time interval in minutes. Enter 0 as value to set execution interval to Manual.



RESPONSES

Status
colourGreen
titleSTATUS 201
- Returned if jobs for the scheduled adding of existing issues is succesfully created

Code Block
languagejava
titleExample Response
Rule Home Page UI req has been successfully created

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, the name is invalid or already exists, the folder is invalid, the filter is invalid or interval is less than zero

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission to use the Requirements for JIRA plugin

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, incompatible JIRA version, or no permission to create jobs for the scheduled adding of existing issues

Status
colourRed
titleSTATUS 404
- Returned if folder is not found


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folders

Returns all tree folders and subfolders in project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folders



PARAMETERS
parametertypedescription
prjKey*stringproject key of folders to be return



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if tree structure if an existing project is found

Code Block
languagejava
titleExample response
[
  {
    "folders": [
      {
        "folders": [],
        "name": "Folder 1.1",
        "id": 10
      },
      {
        "folders": [],
        "name": "Folder 1.2",
        "id": 11
      }
    ],
    "name": "Folder 1",
    "id": 5
  },
  {
    "folders": [],
    "name": "Folder 2",
    "id": 6
  },
  {
    "folders": [
      {
        "folders": [],
        "name": "Folder 3.1",
        "id": 8
      },
      {
        "folders": [],
        "name": "Folder 3.2",
        "id": 9
      }
    ],
    "name": "Folder 3",
    "id": 7
  }
]

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/foldertree/id

Get complete tree structure with or without issues for certain project tree folder.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/foldertree/id?folderOnly&n



PARAMETERS
parametertypedescription
prjKey*stringthe project key
id*stringthe folder id
folderOnlystringtoggles include issues in folder (0 = disabled (default), 1 = enabled)
nstringtoggles structure numbering prefix for folder names (0 = disabled (default), 1 = enabled)



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if tree structure if an existing project is found

Code Block
languagejava
titleExample response
{
  	"id": 1,
  	"folders": [
		{
      		"name": "First",
      		"id": 56,
      		"name_display": "First",
      		"parent": -1,
      		"folders": [
        		{
          			"name": "Third",
          			"id": 69,
          			"name_display": "Third",
          			"parent": 56,
          			"folders": [],
          			"issues": [
            			{
              				"id": 132,
              				"issueId": 10157,
              				"key": "AN-4",
              				"url": "http://<server-name>/browse/AN-4",
              				"summary": "Second",
              				"description": "Issue number 61",
              				"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
              				"issueType": "New Feature",
              				"position": 1
            			},
            			{
              				"id": 131,
              				"issueId": 10155,
              				"key": "AN-2",
              				"url": "http://<server-name>/browse/AN-2",
              				"summary": "Second",
              				"description": "Second",
              				"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
              				"issueType": "New Feature",
              				"position": 2
            			}
          			],
         			"position": 1
        		}
			],
    		"issues": [],
    		"position": 1
		},
		{
			"name": "Test",
			"id": 67,
			"name_display": "Test",
			"parent": -1,
			"folders": [
				{
					"name": "Second",
					"id": 68,
					"name_display": "Second",
					"parent": 67,
					"folders": [],
					"issues": [
						{
							"id": 127,
							"issueId": 10155,
							"key": "AN-2",
							"url": "http://<server-name>/browse/AN-2",
							"summary": "Second",
							"description": "Second",
							"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
							"issueType": "New Feature",
							"position": 1
						},
						{
							"id": 118,
							"issueId": 10154,
							"key": "AN-1",
							"url": "http://<server-name>/browse/AN-1",
							"summary": "First",
							"description": "First issue textasd",
							"icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
							"issueType": "New Feature",
							"position": 2
						}
					],
					"position": 1
				}
			],
			"issues": [],
			"position": 2
		},
		{
			"name": "Root",
			"id": 75,
			"name_display": "Root",
			"parent": -1,
			"folders": [],
			"issues": [],
			"position": 3
		},
		{
			"name": "Test",
			"id": 70,
			"name_display": "Test",
			"parent": -1,
			"folders": [],
			"issues": [],
			"position": 4
		}
	],
	"issues": []
} 

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder

Create a new project tree folder below the root folder of a given project.

Info

Returns information about the new folder in case of success. 


Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder?name&description



PARAMETERS
parametertypedescription
prjKey*stringthe project key
namestringthe name of the new folder
descriptionstringoptional description of the new folder



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if the folder is successfully created

Code Block
languagejava
titleExample Response
{
  "name": "Test",
  "id": 76,
  "parent": -1,
  "folders": [],
  "issues": [],
  "position": 0
} 

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, name is invalid or already exists, or an error occurs in folder creation

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id

Create a new project tree folder below a specified folder of a given project.

Info

Returns information about the new folder in case of success. 


Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id?name&description



PARAMETERS
parametertypedescription
prjKey*stringthe project key
id*stringthe ID of the parent folder
namestringthe name of the new folder
descriptionstringoptional description for the new folder



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if the folder is successfully created

Code Block
languagejava
titleExample Response
{
  "name": "Child",
  "id": 77,
  "parent": 76,
  "folders": [],
  "issues": [],
  "position": 0
} 

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, the folder is invalid, name is invalid or already exists, or an error occurs in folder creation

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id

Renames folder using project key.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
PUT

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id

Sample request data JSON:
{
"name": "sample name"
}

name (string): The folder's new name if operation is successful.



PARAMETERS
parametertypedescription
prjKey*stringthe project key
id*stringthe ID of the folder to be renamed
dataobjectThe JSON object of the new folder. Please refer above for the example and properties definition.



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if the folder is successfully renamed

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, or the folder id is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id

Delete a project tree folder from a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
DELETE

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folder/id



PARAMETERS
parametertypedescription
prjKey*stringthe project key
id*stringthe ID of the folder to be deleted



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if the folder is successfully deleted

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, or the folder id is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/rootissue

Add an existing issue to the root folder of a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/{prjKey}/rootissue



QUERY PARAMETERS
parametertypedescription
issuekeystringthe key of the issue to be associated



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if issue is added to root folder

Code Block
languagejava
titleExample Response
{
  	"id": 136,
  	"issueId": 0,
  	"key": "",
  	"url": "",
  	"summary": "",
  	"description": "",
  	"issueType": "",
  	"position": 0,
  	"childReqs": {
    	"childReq": []
  	}
} 

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, or an error occurs while adding the issue to the root folder

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/rootissue

Remove an issue from the root folder of a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
DELETE

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/rootissue?issuekey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
issuekeystringthe key of the issue whose association should be removed



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if issue is deleted from root folder

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, or an error occurs while removing the issue from the root folder

Status
colourRed
titleSTATUS 401
Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderissue/id

Add an existing issue to a specified tree folder of a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderissue/id?issuekey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
id*stringthe folder ID
issuekeystringthe key of the issue to be associated



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if issue is associated to the folder

Code Block
languagejava
titleExample Response
{
  	"id": 136,
  	"issueId": 0,
  	"key": "",
  	"url": "",
  	"summary": "",
  	"description": "",
  	"issueType": "",
  	"position": 0,
  	"childReqs": {
    	"childReq": []
  	}
}  

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, the folder id is invalid, or an error occurs while adding the issue to the folder

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderissue/id

Remove an issue from a specified tree folder of a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
DELETE

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/folderissue/id?issuekey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
id*stringthe folder ID
issuekeystringthe key of the issue whose association should be removed



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if issue association is removed from the folder

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, the folder id is invalid, or an error occurs while removing the issue from the folder

Status
colourRed
titleSTATUS 401
Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/moveissue

Move an existing issue association to a new folder

Info

Returns ok in case of success


Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/prjKey/moveissue?from&to&issuekey&pos



PARAMETERS
parametertypedescription
prjKey*stringthe project key
from
stringthe ID of the source folder (if source folder is root, ID may be blank or -1)
tostringthe ID of the destination folder (if destination folder is root, ID may be blank or -1)
issuekeystringthe key of the issue whose association should be moved
posstringoptional position of the issue in the destination folder (currently not supported)



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if issue association is moved to the new folder

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, the from folder id is invalid, the to folder id is invalid, or an error occurs while moving the issue

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey

Get all child requirements for a given issue in a specific project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
parentKey*stringkey of the parent issue



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if child requirements of a given issue key is found

Code Block
languagejava
titleExample Response
{
  "childReq": [
    {
      "issueId": 10154,
      "key": "AN-1",
      "url": "http://<server-name>/jira/browse/AN-1",
      "summary": "First",
      "icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
      "issueType": "New Feature",
      "position": 1
    }
  ]
} 

Status
colourRed
titleSTATUS 400
- Returned if the parent key is invalid

Status
colourRed
titleSTATUS 401
- Returned if the project is invalid, invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey

Add a child requirement to an issue in the project tree a given project.

Note

Note that the child requirement can't be already part of the project. 


Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
POST

/rest/com.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey?childKey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
parentKey*stringkey of the parent issue
childKeystringkey of the child issue



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if a child requirement to an issue is added

Code Block
languagejava
titleExample Response
{
  "childReq": [
    {
      "issueId": 10154,
      "key": "AN-1",
      "url": "http://<server-name>/jira/browse/AN-1",
      "summary": "First",
      "icon_url": "http://<server-name>/images/icons/issuetypes/newfeature.png",
      "issueType": "New Feature",
      "position": 1
    }
  ]
} 

Status
colourRed
titleSTATUS 400
- Returned if the parent key is invalid, child key is invalid, or the child requirement is already part of the project tree

Status
colourRed
titleSTATUS 401
- Returned if the project is invalid, invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey

Remove a child requirement from an issue in the project tree of a given project.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
DELETE

/rest/com.easesolutions.jira.plugins.requirements/1.0/child-req/prjKey/parentKey?childKey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
parentKey*stringkey of the parent issue
childKeystringkey of the child issue



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if a child requirement to an issue is removed

Status
colourRed
titleSTATUS 400
- Returned if the parent or child key is invalid

Status
colourRed
titleSTATUS 401
- Returned if the project is invalid, invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...

Panel
titleColor#FFFFFF
titleBGColor#6c809a
titlecom.easesolutions.jira.plugins.requirements/1.0/tree/totalItemCount/prjKey

Get total item count in project tree with option to include or exclude pages in count.

Expand
titleClick here for details...
REQUEST
Panel
bgColor#f6f5f5
GET

/rest/com.easesolutions.jira.plugins.requirements/1.0/tree/totalItemCount/prjKey



PARAMETERS
parametertypedescription
prjKey*stringthe project key
includePagesbooleanoption to include pages in total count; where default value is true. if value is set to false, only issues will be counted



RESPONSES

Status
colourGreen
titleSTATUS 200
- Returned if project key is valid

Code Block
languagejava
titleExample response
{ "totalItemCount": 125 }

Status
colourRed
titleSTATUS 400
- Returned if the project is invalid, type is invalid, the path separator is invalid or path is invalid

Status
colourRed
titleSTATUS 401
- Returned if invalid user credentials, or the user has no permission

Status
colourRed
titleSTATUS 403
- Returned if the license is invalid or has expired, or incompatible JIRA version


...