v1

latestOpenAPI 3.0.3Apache 2.02026-07-1372170520.1 KB

API Keys

Create an API key

Create a new API key for a project. Developers can use the API key to authenticate requests to Pinecone's Data Plane and Control Plane APIs.

post/admin/projects/{project_id}/api-keys

Path parameters

project_idstring uuid required

Project ID

Headers

X-Pinecone-Api-Versionstring required

Required date-based version header

Request body

namestring required

The name of the API key. The name must be 1-80 characters long.

rolesstring[]

The roles to create the API key with. Default is ["ProjectEditor"].

Example request

{
  "name": "devkey",
  "roles": [
    "ProjectEditor"
  ]
}

Response

API key created successfully.

valuestring required

The value to use as an API key. New keys will have the format "pckey_<public-label>_<unique-key>". The entire string should be used when authenticating.

Example response

{
  "key": {
    "roles": [
      "ProjectEditor"
    ]
  }
}