Update Project

PUT {{baseUrl}}/rest/api/3/project/:projectIdOrKey?expand=<string>

Updates the project details of a project.

All parameters are optional in the body of the request.

Permissions required: Administer Jira global permission.

Request Params

KeyDatatypeRequiredDescription
expandstringUse expand to include additional information in the response. This parameter accepts a comma-separated list. Note that the project description, issue types, and project lead are included in all responses by default. Expand options include:
  • description The project description.
  • issueTypes The issue types associated with the project.
  • lead The project lead.
  • projectKeys All project keys associated with the project. |

Request Body

{"key"=>"<string>", "name"=>"<string>", "projectTypeKey"=>"<string>", "projectTemplateKey"=>"<string>", "description"=>"<string>", "lead"=>"<string>", "leadAccountId"=>"<string>", "url"=>"<string>", "assigneeType"=>"<string>", "avatarId"=>"<long>", "issueSecurityScheme"=>"<long>", "permissionScheme"=>"<long>", "notificationScheme"=>"<long>", "categoryId"=>"<long>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: OK

{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/EX&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;key&quot;:&quot;EX&quot;,&quot;description&quot;:&quot;This project was created as an example for REST.&quot;,&quot;lead&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;key&quot;:&quot;&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;name&quot;:&quot;&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48\u0026s=48&quot;,&quot;24x24&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24\u0026s=24&quot;,&quot;16x16&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16\u0026s=16&quot;,&quot;32x32&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32\u0026s=32&quot;},&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false},&quot;components&quot;:[{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/component/10000&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;name&quot;:&quot;Component 1&quot;,&quot;description&quot;:&quot;This is a Jira component&quot;,&quot;lead&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;key&quot;:&quot;&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;name&quot;:&quot;&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48\u0026s=48&quot;,&quot;24x24&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24\u0026s=24&quot;,&quot;16x16&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16\u0026s=16&quot;,&quot;32x32&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32\u0026s=32&quot;},&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false},&quot;assigneeType&quot;:&quot;PROJECT_LEAD&quot;,&quot;assignee&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;key&quot;:&quot;&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;name&quot;:&quot;&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48\u0026s=48&quot;,&quot;24x24&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24\u0026s=24&quot;,&quot;16x16&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16\u0026s=16&quot;,&quot;32x32&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32\u0026s=32&quot;},&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false},&quot;realAssigneeType&quot;:&quot;PROJECT_LEAD&quot;,&quot;realAssignee&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;key&quot;:&quot;&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;name&quot;:&quot;&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48\u0026s=48&quot;,&quot;24x24&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24\u0026s=24&quot;,&quot;16x16&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16\u0026s=16&quot;,&quot;32x32&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32\u0026s=32&quot;},&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false},&quot;isAssigneeTypeValid&quot;:false,&quot;project&quot;:&quot;HSP&quot;,&quot;projectId&quot;:10000}],&quot;issueTypes&quot;:[{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/issueType/3&quot;,&quot;id&quot;:&quot;3&quot;,&quot;description&quot;:&quot;A task that needs to be done.&quot;,&quot;iconUrl&quot;:&quot;https://your-domain.atlassian.net//secure/viewavatar?size=xsmall\u0026avatarId=10299\u0026avatarType=issuetype\&quot;,&quot;,&quot;name&quot;:&quot;Task&quot;,&quot;subtask&quot;:false,&quot;avatarId&quot;:1},{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/issueType/1&quot;,&quot;id&quot;:&quot;1&quot;,&quot;description&quot;:&quot;A problem with the software.&quot;,&quot;iconUrl&quot;:&quot;https://your-domain.atlassian.net/secure/viewavatar?size=xsmall\u0026avatarId=10316\u0026avatarType=issuetype\&quot;,&quot;,&quot;name&quot;:&quot;Bug&quot;,&quot;subtask&quot;:false,&quot;avatarId&quot;:10002,&quot;entityId&quot;:&quot;9d7dd6f7-e8b6-4247-954b-7b2c9b2a5ba2&quot;,&quot;scope&quot;:{&quot;type&quot;:&quot;PROJECT&quot;,&quot;project&quot;:{&quot;id&quot;:&quot;10000&quot;,&quot;key&quot;:&quot;KEY&quot;,&quot;name&quot;:&quot;Next Gen Project&quot;}}}],&quot;url&quot;:&quot;https://www.example.com&quot;,&quot;email&quot;:&quot;from-jira@example.com&quot;,&quot;assigneeType&quot;:&quot;PROJECT_LEAD&quot;,&quot;versions&quot;:[],&quot;name&quot;:&quot;Example&quot;,&quot;roles&quot;:{&quot;Developers&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/EX/role/10000&quot;},&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=large\u0026pid=10000&quot;,&quot;24x24&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=small\u0026pid=10000&quot;,&quot;16x16&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=xsmall\u0026pid=10000&quot;,&quot;32x32&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=medium\u0026pid=10000&quot;},&quot;projectCategory&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/projectCategory/10000&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;name&quot;:&quot;FIRST&quot;,&quot;description&quot;:&quot;First Project Category&quot;},&quot;simplified&quot;:false,&quot;style&quot;:&quot;classic&quot;,&quot;properties&quot;:{&quot;propertyKey&quot;:&quot;propertyValue&quot;},&quot;insight&quot;:{&quot;totalIssueCount&quot;:100,&quot;lastIssueUpdateTime&quot;:&quot;2020-12-17T01:45:38.377+0000&quot;}}