---
title: "Create Project"
method: POST
path: "/access/api/v1/projects"
tags: ["Projects"]
---

# Create Project

`POST /access/api/v1/projects`

Creates a new project.

**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 default to
`true`. See the `admin_privileges` schema for details.

**Security:** Requires Platform Admin privileges.

## Request body

- ProjectCreateRequest
  - `project_key` string, required — The project key
  - `display_name` string, required — Display name
  - `description` string — Project description
  - `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 default to true.
    - `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. If not specified during project creation, defaults to true. Available from Artifactory 7.146.0.
    - `delete_remote_repository` boolean — Allow Project Admin to delete remote repositories. If not specified during project creation, defaults to true. Available from Artifactory 7.146.0.
    - `create_local_repository` boolean — Allow Project Admin to create local repositories. If not specified during project creation, defaults to true. Available from Artifactory 7.146.0.
    - `delete_local_repository` boolean — Allow Project Admin to delete local repositories. If not specified during project creation, defaults to true. Available from Artifactory 7.146.0.
    - `create_virtual_repository` boolean — Allow Project Admin to create virtual repositories. If not specified during project creation, defaults to true. Available from Artifactory 7.146.0.
    - `delete_virtual_repository` boolean — Allow Project Admin to delete virtual repositories. If not specified during project creation, defaults to true. Available from Artifactory 7.146.0.
  - `storage_quota_bytes` integer — Storage quota in bytes

## Response `201`

Project created

- 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
- `409` — Conflict - Project with the same key already exists

---

[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)