Pinecone · Capability
Pinecone Admin API
Provides an API for managing a Pinecone organization and its resources.
What You Can Do
GET
List projects
— List projects
/admin/projects
POST
Create project
— Create a new project
/admin/projects
GET
List organizations
— List organizations
/admin/organizations
GET
Fetch project
— Get project details
/admin/projects/{project_id}
DELETE
Delete project
— Delete a project
/admin/projects/{project_id}
PATCH
Update project
— Update a project
/admin/projects/{project_id}
GET
Fetch organization
— Get organization details
/admin/organizations/{organization_id}
DELETE
Delete organization
— Delete an organization
/admin/organizations/{organization_id}
PATCH
Update organization
— Update an organization
/admin/organizations/{organization_id}
GET
List project api keys
— List API keys
/admin/projects/{project_id}/api-keys
POST
Create api key
— Create an API key
/admin/projects/{project_id}/api-keys
GET
Fetch api key
— Get API key details
/admin/api-keys/{api_key_id}
DELETE
Delete api key
— Delete an API key
/admin/api-keys/{api_key_id}
PATCH
Update api key
— Update an API key
/admin/api-keys/{api_key_id}
MCP Tools
list-projects
List projects
read-only
idempotent
create-project
Create a new project
list-organizations
List organizations
read-only
idempotent
fetch-project
Get project details
read-only
idempotent
delete-project
Delete a project
idempotent
update-project
Update a project
fetch-organization
Get organization details
read-only
idempotent
delete-organization
Delete an organization
idempotent
update-organization
Update an organization
list-project-api-keys
List API keys
read-only
idempotent
create-api-key
Create an API key
fetch-api-key
Get API key details
read-only
idempotent
delete-api-key
Delete an API key
idempotent
update-api-key
Update an API key
Capability Spec
naftiko: 1.0.0-alpha2
info:
label: Pinecone Admin API
description: Provides an API for managing a Pinecone organization and its resources.
tags:
- Pinecone
- API
created: '2026-05-06'
modified: '2026-05-06'
capability:
consumes:
- type: http
namespace: pinecone
baseUri: https://api.pinecone.io
description: Pinecone Admin API HTTP API.
authentication:
type: bearer
token: '{{PINECONE_TOKEN}}'
resources:
- name: admin-projects
path: /admin/projects
operations:
- name: list-projects
method: GET
description: List projects
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: create-project
method: POST
description: Create a new project
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: admin-organizations
path: /admin/organizations
operations:
- name: list-organizations
method: GET
description: List organizations
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: admin-projects-project-id
path: /admin/projects/{project_id}
operations:
- name: fetch-project
method: GET
description: Get project details
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: project_id
in: path
type: string
required: true
description: Project ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: delete-project
method: DELETE
description: Delete a project
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: project_id
in: path
type: string
required: true
description: Project ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: update-project
method: PATCH
description: Update a project
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: project_id
in: path
type: string
required: true
description: Project ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: admin-organizations-organization-id
path: /admin/organizations/{organization_id}
operations:
- name: fetch-organization
method: GET
description: Get organization details
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: organization_id
in: path
type: string
required: true
description: Organization ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: delete-organization
method: DELETE
description: Delete an organization
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: organization_id
in: path
type: string
required: true
description: Organization ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: update-organization
method: PATCH
description: Update an organization
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: organization_id
in: path
type: string
required: true
description: Organization ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: admin-projects-project-id-api-keys
path: /admin/projects/{project_id}/api-keys
operations:
- name: list-project-api-keys
method: GET
description: List API keys
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: project_id
in: path
type: string
required: true
description: Project ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: create-api-key
method: POST
description: Create an API key
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: project_id
in: path
type: string
required: true
description: Project ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: admin-api-keys-api-key-id
path: /admin/api-keys/{api_key_id}
operations:
- name: fetch-api-key
method: GET
description: Get API key details
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: api_key_id
in: path
type: string
required: true
description: API key ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: delete-api-key
method: DELETE
description: Delete an API key
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: api_key_id
in: path
type: string
required: true
description: API key ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
- name: update-api-key
method: PATCH
description: Update an API key
inputParameters:
- name: X-Pinecone-Api-Version
in: header
type: string
required: true
description: Required date-based version header
- name: api_key_id
in: path
type: string
required: true
description: API key ID
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
exposes:
- type: rest
port: 8080
namespace: pinecone-rest
description: REST adapter for Pinecone Admin API.
resources:
- path: /admin/projects
name: list-projects
operations:
- method: GET
name: list-projects
description: List projects
call: pinecone.list-projects
outputParameters:
- type: object
mapping: $.
- path: /admin/projects
name: create-project
operations:
- method: POST
name: create-project
description: Create a new project
call: pinecone.create-project
outputParameters:
- type: object
mapping: $.
- path: /admin/organizations
name: list-organizations
operations:
- method: GET
name: list-organizations
description: List organizations
call: pinecone.list-organizations
outputParameters:
- type: object
mapping: $.
- path: /admin/projects/{project_id}
name: fetch-project
operations:
- method: GET
name: fetch-project
description: Get project details
call: pinecone.fetch-project
with:
project_id: rest.project_id
outputParameters:
- type: object
mapping: $.
- path: /admin/projects/{project_id}
name: delete-project
operations:
- method: DELETE
name: delete-project
description: Delete a project
call: pinecone.delete-project
with:
project_id: rest.project_id
outputParameters:
- type: object
mapping: $.
- path: /admin/projects/{project_id}
name: update-project
operations:
- method: PATCH
name: update-project
description: Update a project
call: pinecone.update-project
with:
project_id: rest.project_id
outputParameters:
- type: object
mapping: $.
- path: /admin/organizations/{organization_id}
name: fetch-organization
operations:
- method: GET
name: fetch-organization
description: Get organization details
call: pinecone.fetch-organization
with:
organization_id: rest.organization_id
outputParameters:
- type: object
mapping: $.
- path: /admin/organizations/{organization_id}
name: delete-organization
operations:
- method: DELETE
name: delete-organization
description: Delete an organization
call: pinecone.delete-organization
with:
organization_id: rest.organization_id
outputParameters:
- type: object
mapping: $.
- path: /admin/organizations/{organization_id}
name: update-organization
operations:
- method: PATCH
name: update-organization
description: Update an organization
call: pinecone.update-organization
with:
organization_id: rest.organization_id
outputParameters:
- type: object
mapping: $.
- path: /admin/projects/{project_id}/api-keys
name: list-project-api-keys
operations:
- method: GET
name: list-project-api-keys
description: List API keys
call: pinecone.list-project-api-keys
with:
project_id: rest.project_id
outputParameters:
- type: object
mapping: $.
- path: /admin/projects/{project_id}/api-keys
name: create-api-key
operations:
- method: POST
name: create-api-key
description: Create an API key
call: pinecone.create-api-key
with:
project_id: rest.project_id
outputParameters:
- type: object
mapping: $.
- path: /admin/api-keys/{api_key_id}
name: fetch-api-key
operations:
- method: GET
name: fetch-api-key
description: Get API key details
call: pinecone.fetch-api-key
with:
api_key_id: rest.api_key_id
outputParameters:
- type: object
mapping: $.
- path: /admin/api-keys/{api_key_id}
name: delete-api-key
operations:
- method: DELETE
name: delete-api-key
description: Delete an API key
call: pinecone.delete-api-key
with:
api_key_id: rest.api_key_id
outputParameters:
- type: object
mapping: $.
- path: /admin/api-keys/{api_key_id}
name: update-api-key
operations:
- method: PATCH
name: update-api-key
description: Update an API key
call: pinecone.update-api-key
with:
api_key_id: rest.api_key_id
outputParameters:
- type: object
mapping: $.
- type: mcp
port: 9090
namespace: pinecone-mcp
transport: http
description: MCP adapter for Pinecone Admin API for AI agent use.
tools:
- name: list-projects
description: List projects
hints:
readOnly: true
destructive: false
idempotent: true
call: pinecone.list-projects
outputParameters:
- type: object
mapping: $.
- name: create-project
description: Create a new project
hints:
readOnly: false
destructive: false
idempotent: false
call: pinecone.create-project
outputParameters:
- type: object
mapping: $.
- name: list-organizations
description: List organizations
hints:
readOnly: true
destructive: false
idempotent: true
call: pinecone.list-organizations
outputParameters:
- type: object
mapping: $.
- name: fetch-project
description: Get project details
hints:
readOnly: true
destructive: false
idempotent: true
call: pinecone.fetch-project
with:
project_id: tools.project_id
inputParameters:
- name: project_id
type: string
description: Project ID
required: true
outputParameters:
- type: object
mapping: $.
- name: delete-project
description: Delete a project
hints:
readOnly: false
destructive: true
idempotent: true
call: pinecone.delete-project
with:
project_id: tools.project_id
inputParameters:
- name: project_id
type: string
description: Project ID
required: true
outputParameters:
- type: object
mapping: $.
- name: update-project
description: Update a project
hints:
readOnly: false
destructive: false
idempotent: false
call: pinecone.update-project
with:
project_id: tools.project_id
inputParameters:
- name: project_id
type: string
description: Project ID
required: true
outputParameters:
- type: object
mapping: $.
- name: fetch-organization
description: Get organization details
hints:
readOnly: true
destructive: false
idempotent: true
call: pinecone.fetch-organization
with:
organization_id: tools.organization_id
inputParameters:
- name: organization_id
type: string
description: Organization ID
required: true
outputParameters:
- type: object
mapping: $.
- name: delete-organization
description: Delete an organization
hints:
readOnly: false
destructive: true
idempotent: true
call: pinecone.delete-organization
with:
organization_id: tools.organization_id
inputParameters:
- name: organization_id
type: string
description: Organization ID
required: true
outputParameters:
- type: object
mapping: $.
- name: update-organization
description: Update an organization
hints:
readOnly: false
destructive: false
idempotent: false
call: pinecone.update-organization
with:
organization_id: tools.organization_id
inputParameters:
- name: organization_id
type: string
description: Organization ID
required: true
outputParameters:
- type: object
mapping: $.
- name: list-project-api-keys
description: List API keys
hints:
readOnly: true
destructive: false
idempotent: true
call: pinecone.list-project-api-keys
with:
project_id: tools.project_id
inputParameters:
- name: project_id
type: string
description: Project ID
required: true
outputParameters:
- type: object
mapping: $.
- name: create-api-key
description: Create an API key
hints:
readOnly: false
destructive: false
idempotent: false
call: pinecone.create-api-key
with:
project_id: tools.project_id
inputParameters:
- name: project_id
type: string
description: Project ID
required: true
outputParameters:
- type: object
mapping: $.
- name: fetch-api-key
description: Get API key details
hints:
readOnly: true
destructive: false
idempotent: true
call: pinecone.fetch-api-key
with:
api_key_id: tools.api_key_id
inputParameters:
- name: api_key_id
type: string
description: API key ID
required: true
outputParameters:
- type: object
mapping: $.
- name: delete-api-key
description: Delete an API key
hints:
readOnly: false
destructive: true
idempotent: true
call: pinecone.delete-api-key
with:
api_key_id: tools.api_key_id
inputParameters:
- name: api_key_id
type: string
description: API key ID
required: true
outputParameters:
- type: object
mapping: $.
- name: update-api-key
description: Update an API key
hints:
readOnly: false
destructive: false
idempotent: false
call: pinecone.update-api-key
with:
api_key_id: tools.api_key_id
inputParameters:
- name: api_key_id
type: string
description: API key ID
required: true
outputParameters:
- type: object
mapping: $.
binds:
- namespace: env
keys:
PINECONE_TOKEN: PINECONE_TOKEN