```bash curl theme={null}
PINECONE_PROJECT_ID="32c8235a-5220-4a80-a9f1-69c24109e6f2"
PINECONE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"

curl -X POST "https://api.pinecone.io/admin/projects/$PINECONE_PROJECT_ID/api-keys" \
     -H "X-Pinecone-Api-Version: 2025-04" \
     -H "Authorization: Bearer $PINECONE_ACCESS_TOKEN" \
     -d '{ 
           "name": "example-api-key", 
           "roles": ["ProjectEditor"] 
         }'
```

```bash CLI theme={null}
# Target the project for which you want to create an API key.
pc target -o "example-org" -p "example-project"
# Create the API key
pc api-key create -n "example-api-key" --roles ProjectEditor
```

```json curl theme={null}
{
  "key": {
    "id": "62b0dbfe-3489-4b79-b850-34d911527c88",
    "name": "example-api-key",
    "project_id": "32c8235a-5220-4a80-a9f1-69c24109e6f2",
    "roles": [
      "ProjectEditor"
    ],
    "created_at": "2025-10-20T23:40:27.069075Z"
  },
  "value": "..."
}
```

```text CLI theme={null}
ATTRIBUTE     VALUE
Name          example-api-key
ID            62b0dbfe-3489-4b79-b850-34d911527c88
Value         ...
Project ID    32c8235a-5220-4a80-a9f1-69c24109e6f2
Roles         ProjectEditor
```

**POST** `/admin/projects/{project_id}/api-keys`

:::code-group
```bash title="cURL"
curl --request POST \
  --url https://api.pinecone.io/admin/projects/{project_id}/api-keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "devkey",
  "roles": [
    "ProjectEditor"
  ]
}'
```

```json title="201"
{
  "key": {
    "id": "<string>",
    "name": "<string>",
    "project_id": "<string>",
    "roles": [
      "ProjectEditor"
    ]
  },
  "value": "<string>"
}
```
:::

## Authorizations

- `Authorization` (header, string, required) — Bearer authentication header of the form `Bearer <token>`.

## Path Parameters

- `project_id` (path, string, required) — Project ID

## Body

- `name` (body, string, required) — The name of the API key. The name must be 1-80 characters long.
- `roles` (body, string\[]) — The roles to create the API key with. Default is `["ProjectEditor"]`.

## Response

- `201` — API key created successfully.
- `400` — Bad request. The request body included invalid request parameters.
- `401` — Unauthorized. Possible causes: Invalid API key.
- `403` — Not enough available quota to complete this operation.
- `500` — Internal server error.
- `4XX` — Unexpected error on request.

## Related pages

- [List API keys](./admin-2-2026-07-admin-api-keys-list-api-keys.md)
- [Create an API key](./admin-2-2026-07-admin-api-keys-create-an-api-key.md)
- [Get API key details](./admin-2-2026-07-admin-api-keys-get-api-key-details.md)
- [Delete an API key](./admin-2-2026-07-admin-api-keys-delete-an-api-key.md)
- [Update an API key](./admin-2-2026-07-admin-api-keys-update-an-api-key.md)
- [Create an API key](./admin-2-2026-04-admin-create-api-key.md)
- [Create an API key](./admin-2-2026-04-admin-assistant-create-api-key.md)
- [List API keys](./admin-2-2026-04-admin-assistant-list-api-keys.md)
- [Get API key details](./admin-2-2026-04-admin-assistant-fetch-api-key.md)
- [Update an API key](./admin-2-2026-04-admin-assistant-update-api-key.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.