Create custom project
POST
/rest/api/3/project-template
details - represents the project details settingstemplate - represents a list of capabilities responsible for creating specific parts of a projectLocation link in the response header to determine the status of the task and use Get task to obtain subsequent updates.Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/rest/api/3/project-template' \
--header 'Content-Type: application/json' \
--data-raw '{
"details": {
"accessLevel": "open",
"additionalProperties": {
"property1": "string",
"property2": "string"
},
"assigneeType": "PROJECT_DEFAULT",
"avatarId": 10200,
"categoryId": 0,
"description": "This is a project for Foo Bar",
"enableComponents": false,
"key": "PRJ",
"language": "en",
"leadAccountId": "1234567890",
"name": "Project Foo Bar",
"url": "https://www.example.com"
},
"template": {
"boards": {
"boards": [
{
"boardFilterJQL": "project = '\''My Project'\''",
"cardColorStrategy": "ISSUE_TYPE",
"cardLayout": {
"showDaysInColumn": false
},
"cardLayouts": [
{
"fieldId": "string",
"id": 0,
"mode": "PLAN",
"position": 0
}
],
"columns": [
{
"maximumIssueConstraint": 0,
"minimumIssueConstraint": 0,
"name": "TODO",
"statusIds": "pcri:status:ref:done"
}
],
"features": [
{
"featureKey": "ESTIMATION",
"state": true
}
],
"name": "string",
"pcri": "pcri:permissionScheme:id:10001",
"quickFilters": [
{
"description": "string",
"jqlQuery": "string",
"name": "string"
}
],
"supportsSprint": true,
"swimlanes": {
"customSwimlanes": [
{
"description": "string",
"jqlQuery": "string",
"name": "string"
}
],
"defaultCustomSwimlaneName": "string",
"swimlaneStrategy": "none"
},
"workingDaysConfig": {
"friday": true,
"id": 0,
"monday": true,
"nonWorkingDays": [
{
"id": 0,
"iso8601Date": "string"
}
],
"saturday": true,
"sunday": true,
"thursday": true,
"timezoneId": "string",
"tuesday": true,
"wednesday": true
}
}
]
},
"field": {
"customFieldDefinitions": [
{
"cfType": "See https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-3-field-post `type` for values",
"description": "This is a custom field",
"name": "My Custom Field",
"onConflict": "FAIL",
"pcri": "pcri:permissionScheme:id:10001",
"searcherKey": "See https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-fields/#api-rest-api-3-field-post `searcherKey` for values"
}
],
"fieldLayoutScheme": {
"defaultFieldLayout": "pcri:permissionScheme:id:10001",
"description": "This is a field layout scheme",
"explicitMappings": {
"property1": "pcri:permissionScheme:id:10001",
"property2": "pcri:permissionScheme:id:10001"
},
"name": "My Field Layout Scheme",
"pcri": "pcri:permissionScheme:id:10001"
},
"fieldLayouts": [
{
"configuration": [
{
"field": true,
"pcri": "pcri:permissionScheme:id:10001",
"required": true
}
],
"description": "This is a field layout",
"name": "My Field Layout",
"pcri": "pcri:permissionScheme:id:10001"
}
],
"issueLayouts": [
{
"containerId": "pcri:permissionScheme:id:10001",
"issueLayoutType": "ISSUE_VIEW",
"items": [
{
"itemKey": "pcri:permissionScheme:id:10001",
"sectionType": "content",
"type": "FIELD"
}
],
"pcri": "pcri:permissionScheme:id:10001"
}
],
"issueTypeScreenScheme": {
"defaultScreenScheme": "pcri:permissionScheme:id:10001",
"description": "This is an issue type screen scheme",
"explicitMappings": {
"property1": "pcri:permissionScheme:id:10001",
"property2": "pcri:permissionScheme:id:10001"
},
"name": "My Issue Type Screen Scheme",
"pcri": "pcri:permissionScheme:id:10001"
},
"screenScheme": [
{
"defaultScreen": "pcri:permissionScheme:id:10001",
"description": "This is a screen scheme",
"name": "My Screen Scheme",
"pcri": "pcri:permissionScheme:id:10001",
"screens": {
"property1": "pcri:permissionScheme:id:10001",
"property2": "pcri:permissionScheme:id:10001"
}
}
],
"screens": [
{
"description": "This is a screen",
"name": "My Screen",
"pcri": "pcri:permissionScheme:id:10001",
"tabs": [
{
"fields": [
"pcri:permissionScheme:id:10001"
],
"name": "string"
}
]
}
]
},
"issueType": {
"issueTypeHierarchy": [
{
"hierarchyLevel": 0,
"name": "string",
"onConflict": "FAIL",
"pcri": "pcri:permissionScheme:id:10001"
}
],
"issueTypeScheme": {
"defaultIssueTypeId": "pcri:permissionScheme:id:10001",
"description": "string",
"issueTypeIds": "pcri:issueType:id:10001",
"name": "string",
"pcri": "pcri:permissionScheme:id:10001"
},
"issueTypes": [
{
"avatarId": 0,
"description": "string",
"hierarchyLevel": 0,
"name": "string",
"onConflict": "FAIL",
"pcri": "pcri:permissionScheme:id:10001"
}
]
},
"notification": "CMP: \"project\": {\n \"pcri\": \"pcri:project:ref:new-project1\",\n \"notificationSchemeId\": \"pcri:notificationScheme:id:10000\",\n ...\n }\nTMP: \"notification\": {\n \"pcri\": \"pcri:notificationScheme:ref:notification1\",\n \"name\": \"Simplified Notification Scheme\",\n \"notificationSchemeEvents\": [\n {\n \"event\": {\n \"id\": \"1\"\n },\n \"notifications\": [\n {\n \"notificationType\": \"CurrentAssignee\"\n },\n {\n \"notificationType\": \"Reporter\"\n },\n {\n \"notificationType\": \"AllWatchers\"\n }\n ]\n },\n {\n \"event\": {\n \"id\": \"2\"\n },\n \"notifications\": [\n {\n \"notificationType\": \"CurrentAssignee\"\n },\n {\n \"notificationType\": \"Reporter\"\n },\n {\n \"notificationType\": \"AllWatchers\"\n }\n ]\n },...\n ]\n }\n",
"permissionScheme": {
"addAddonRole": true,
"description": "string",
"grants": [
{
"applicationAccess": [
"string"
],
"groupCustomFields": [
"pcri:permissionScheme:id:10001"
],
"groups": [
"pcri:permissionScheme:id:10001"
],
"permissionKeys": [
"string"
],
"projectRoles": [
"pcri:permissionScheme:id:10001"
],
"specialGrants": [
"string"
],
"userCustomFields": [
"pcri:permissionScheme:id:10001"
],
"users": [
"pcri:permissionScheme:id:10001"
]
}
],
"name": "string",
"onConflict": "FAIL",
"pcri": "pcri:permissionScheme:id:10001"
},
"project": {
"fieldLayoutSchemeId": "pcri:permissionScheme:id:10001",
"issueSecuritySchemeId": "pcri:permissionScheme:id:10001",
"issueTypeSchemeId": "pcri:permissionScheme:id:10001",
"issueTypeScreenSchemeId": "pcri:permissionScheme:id:10001",
"notificationSchemeId": "pcri:permissionScheme:id:10001",
"pcri": "pcri:permissionScheme:id:10001",
"permissionSchemeId": "pcri:permissionScheme:id:10001",
"projectTypeKey": "software",
"workflowSchemeId": "pcri:permissionScheme:id:10001"
},
"role": {
"roleToProjectActors": {
"property1": [
"pcri:permissionScheme:id:10001"
],
"property2": [
"pcri:permissionScheme:id:10001"
]
},
"roles": [
{
"defaultActors": "[pcri:user:id:1234]",
"description": "string",
"name": "string",
"onConflict": "USE",
"pcri": "pcri:permissionScheme:id:10001",
"type": "HIDDEN"
}
]
},
"scope": {
"type": "GLOBAL"
},
"security": {
"description": "Newly created issue security scheme",
"name": "New Security Scheme",
"pcri": "pcri:permissionScheme:id:10001",
"securityLevels": [
{
"description": "Newly created issue security level",
"isDefault": true,
"name": "New Security Level",
"securityLevelMembers": [
{
"parameter": "string",
"type": "group"
}
]
}
]
},
"workflow": {
"statuses": [
{
"description": "string",
"name": "string",
"onConflict": "FAIL",
"pcri": "pcri:permissionScheme:id:10001",
"statusCategory": "TODO"
}
],
"workflowScheme": {
"defaultWorkflow": "pcri:permissionScheme:id:10001",
"description": "string",
"explicitMappings": {
"property1": "pcri:permissionScheme:id:10001",
"property2": "pcri:permissionScheme:id:10001"
},
"name": "string",
"pcri": "pcri:permissionScheme:id:10001"
},
"workflows": [
{
"description": "a software workflow",
"loopedTransitionContainerLayout": {
"x": 1,
"y": 2
},
"name": "Software Simplified Workflow",
"onConflict": "NEW",
"pcri": "pcri:permissionScheme:id:10001",
"startPointLayout": {
"x": 1,
"y": 2
},
"statuses": [
{
"layout": {
"x": 1,
"y": 2
},
"pcri": "pcri:permissionScheme:id:10001",
"properties": {
"property1": "string",
"property2": "string"
}
}
],
"transitions": [
{
"actions": [
{
"parameters": {
"property1": "string",
"property2": "string"
},
"ruleKey": "system:update-field"
}
],
"conditions": {
"conditionGroup": [
{}
],
"conditions": [
{
"parameters": {
"property1": "string",
"property2": "string"
},
"ruleKey": "system:update-field"
}
],
"operation": "ANY"
},
"customIssueEventId": "string",
"description": "string",
"from": [
{
"fromPort": 0,
"status": "pcri:permissionScheme:id:10001",
"toPortOverride": 0
}
],
"id": 0,
"name": "string",
"properties": {
"property1": "string",
"property2": "string"
},
"to": {
"port": 1,
"status": "pcri:permissionScheme:id:10001"
},
"transitionScreen": {
"parameters": {
"property1": "string",
"property2": "string"
},
"ruleKey": "system:update-field"
},
"triggers": [
{
"parameters": {
"property1": "string",
"property2": "string"
},
"ruleKey": "system:update-field"
}
],
"type": "global",
"validators": [
{
"parameters": {
"property1": "string",
"property2": "string"
},
"ruleKey": "system:update-field"
}
]
}
]
}
]
}
}
}'Response Response Example
nullModified at 2025-07-16 07:18:01