Projects
Create project
Available since v. 1.10.*
Available since v. 1.23.* - Reindex project
Available ONLY for JIRA administrators
Method type - POST
URL: {JIRA_URL}/rest/extender/1.0/project/createProject
Request format - JSON
Example request
JSON for one project
{
"key":"EXAMPLEKEY",
"name":"Example project name",
"lead":"admin",
"typeKey":"business",
"templateKey":"com.atlassian.jira-core-project-templates:jira-core-project-management",
"description":"Example description",
"assigneeType":"PROJECT_LEAD",
"categoryId":10000,
"issueTypeScheme":10202,
"workflowScheme":10101,
"issueTypeScreenScheme":10001,
"fieldConfigurationScheme":10000,
"issueSecurityScheme":10000,
"notificationScheme":10100,
"permissionScheme":10000,
"prioritiesScheme":10203
}
Parameters
key - required - project key
name - required - project name
lead - required - project lead (user name, like admin)
typeKey - required - project type - please see Get project template informations and field projectTypeKey
templateKey - optional - project template key - please see Get project template informations and field projectTemplateKey - this parameter set project schemes like build in templates into JIRA when you create project
description - optional - project description
assigneeType - optional - default assignee - please see Get project assignee type and field assigneType
categoryId - optional - project category id - please see https://docs.atlassian.com/software/jira/docs/api/REST/latest/#api/2/projectCategory
issueTypeScheme - optional - issue type scheme id
workflowScheme - optional - workflow scheme id
issueTypeScreenScheme - optional - issue type screen scheme id
fieldConfigurationScheme - optional - field configuration scheme id
issueSecurityScheme - optional - issue security scheme id
notificationScheme - optional - notification scheme id
permissionScheme - optional - permission scheme id
prioritiesScheme - optional - priorities scheme id - this parameter works only for Jira >= 7.6.0
Request format - JSON
Example response
{
"message": "project was created"
}
{
"message": "project not created",
"errors": [
{
"errorFieldName": "key",
"errorMessage": "Project 'Example project name' uses this project key."
},
{
"errorFieldName": "name",
"errorMessage": "A project with that name already exists."
}
]
}
Reindex project
Available ONLY for JIRA administrators
Method type - POST
URL: {JIRA_URL}/rest/extender/1.0/project/{projectKeyOrId}/reindex
where {projectKeyOrId} is project key or id (10000, TEST etc.)
Example URL:
{JIRA_URL}/rest/extender/1.0/project/PROJECTA/reindex
{JIRA_URL}/rest/extender/1.0/project/12000/reindex
Response format - JSON
Example response:
JSON for one project
Delete projects
Method type - DELETE
URL:
{JIRA_URL}/rest/extender/1.0/project/deleteProject
{JIRA_URL}/rest/extender/1.0/project/deleteProject?asynchronous=true
Request format - JSON
JSON for one project
JSON for one project
JSON for several projects
Response format - JSON
Example response
Parameters
asynchronous - optional - boolean - if set to true, plugin deletes the project in a backgound task
Set Project Lead
Method type - PUT
URL: {JIRA_URL}/rest/extender/1.0/project/{projectKeyOrId}/setLead/{userName}
where {projectKeyOrId} is project key or id (10000, TEST etc.)
where {userName} is user (new Project Lead)
Example URL:
{JIRA_URL}/rest/extender/1.0/project/PROJECTA/setLead/USER1
Response format - JSON
Example response
Get project template informations
Method type - GET
URL: {JIRA_URL}/rest/extender/1.0/project/getProjectTemplateInformation
Response format - JSON
Example response
Get project assignee type
Method type - GET
URL: {JIRA_URL}/rest/extender/1.0/project/getProjectAssigneeType
Response format - JSON
Example response