Create a new project - Pinecone Docs

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.

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.