Skip to main content
POST
/
admin
/
projects
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

curl "https://api.pinecone.io/admin/projects" \
    -H "X-Pinecone-Api-Version: 2025-10" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-d '{
        "name":"example-project"
        }'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "example-project",
  "max_pods": 0,
  "force_encryption_with_cmek": false,
  "organization_id": "string",
  "created_at": "2025-03-16T22:46:45.030Z"
}

PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

curl "https://api.pinecone.io/admin/projects" \
    -H "X-Pinecone-Api-Version: 2025-10" \
	-H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
	-d '{
        "name":"example-project"
        }'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "example-project",
  "max_pods": 0,
  "force_encryption_with_cmek": false,
  "organization_id": "string",
  "created_at": "2025-03-16T22:46:45.030Z"
}

Authorizations

​
Authorization
string
header
required

An access token must be provided in the Authorization header using the Bearer scheme.

Headers

​
X-Pinecone-Api-Version
string
default:2025-10
required

Required date-based version header

Body

application/json

The details of the new project.

​
name
string
required

The name of the new project.

Required string length: 1 - 512
Example:

"chatbot-prod"

​
max_pods
integer

The maximum number of Pods that can be created in the project. Default is 0 (serverless only).

​
force_encryption_with_cmek
boolean

Whether to force encryption with a customer-managed encryption key (CMEK). Default is false.

Response

The project was successfully created.

The details of a project.

​
id
string<uuid>
required

The unique ID of the project.

​
name
string
required

The name of the project.

Required string length: 1 - 512
​
max_pods
integer
required

The maximum number of Pods that can be created in the project.

​
force_encryption_with_cmek
boolean
required

Whether to force encryption with a customer-managed encryption key (CMEK).

​
organization_id
string
required

The unique ID of the organization that the project belongs to.

​
created_at
string<date-time>

The date and time when the project was created.