---
title: "Update Existing Project Properties"
method: PUT
path: "/access/api/v1/projects/{projectKey}"
tags: ["Projects"]
---

# Update Existing Project Properties

`PUT /access/api/v1/projects/{projectKey}`

Updates an existing project's properties.

**Note:** Starting from version 7.146.0, granular repository privileges
are supported in `admin_privileges`. If at least one granular field is
set, legacy mapping is ignored and omitted granular fields retain their
existing values. See the `admin_privileges` schema for details.

**Security:** Requires Platform Admin privileges.

## Path parameters

- `projectKey` string, required

## Request body

- ProjectUpdateRequest
  - `display_name` string
  - `description` string
  - `admin_privileges` object — Project Admin privileges. If none of the six granular fields are provided, legacy mapping applies (manage_resources and manage_remote_repository control the granular permissions). If at least one granular field is set, legacy mapping is ignored and omitted granular fields retain their existing values.
    - `manage_members` boolean
    - `manage_resources` boolean — Legacy field. When no granular fields are provided, controls create_local_repository, delete_local_repository, create_virtual_repository, and delete_virtual_repository.
    - `index_resources` boolean
    - `manage_remote_repository` boolean — Legacy field. When no granular fields are provided, controls create_remote_repository and delete_remote_repository.
    - `create_remote_repository` boolean — Allow Project Admin to create remote repositories. Available from Artifactory 7.146.0.
    - `delete_remote_repository` boolean — Allow Project Admin to delete remote repositories. Available from Artifactory 7.146.0.
    - `create_local_repository` boolean — Allow Project Admin to create local repositories. Available from Artifactory 7.146.0.
    - `delete_local_repository` boolean — Allow Project Admin to delete local repositories. Available from Artifactory 7.146.0.
    - `create_virtual_repository` boolean — Allow Project Admin to create virtual repositories. Available from Artifactory 7.146.0.
    - `delete_virtual_repository` boolean — Allow Project Admin to delete virtual repositories. Available from Artifactory 7.146.0.
  - `storage_quota_bytes` integer

## Response `200`

Project updated

- Project
  - `project_key` string — The project key
  - `display_name` string — Display name
  - `description` string — Project description
  - `admin_privileges` object — Project Admin privileges. Starting from version 7.146.0, granular repository privileges are supported. When any of the six granular fields are set, the legacy `manage_resources` and `manage_remote_repository` mappings are ignored and each granular field controls its own permission independently.
    - `manage_members` boolean
    - `manage_resources` boolean — Legacy field. When no granular fields are provided, controls create_local_repository, delete_local_repository, create_virtual_repository, and delete_virtual_repository.
    - `index_resources` boolean
    - `manage_remote_repository` boolean — Legacy field. When no granular fields are provided, controls create_remote_repository and delete_remote_repository.
    - `create_remote_repository` boolean — Allow Project Admin to create remote repositories. Available from Artifactory 7.146.0.
    - `delete_remote_repository` boolean — Allow Project Admin to delete remote repositories. Available from Artifactory 7.146.0.
    - `create_local_repository` boolean — Allow Project Admin to create local repositories. Available from Artifactory 7.146.0.
    - `delete_local_repository` boolean — Allow Project Admin to delete local repositories. Available from Artifactory 7.146.0.
    - `create_virtual_repository` boolean — Allow Project Admin to create virtual repositories. Available from Artifactory 7.146.0.
    - `delete_virtual_repository` boolean — Allow Project Admin to delete virtual repositories. Available from Artifactory 7.146.0.
  - `storage_quota_bytes` integer — Storage quota in bytes
  - `soft_limit` boolean — Whether the storage quota is a soft limit
  - `storage_quota_email_notification` boolean — Whether to send email notifications when storage quota is exceeded

## Other responses

- `400` — Bad Request - Invalid input
- `401` — Bad Credentials - Invalid credentials
- `403` — Permission Denied - Insufficient permissions
- `404` — Not Found - Project not found

---

[API](https://skmtc.dev/jfrog/apis/jfrog-platform-projects-api.md) · [All operations](https://skmtc.dev/jfrog/apis/jfrog-platform-projects-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jfrog/jfrog-platform-projects-api/revisions/1c6bb09154a9/schema)