How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Pinecone

Pinecone Manage Assistants API

Actions that manage Assistants

Documentation Provider Profile APIs.io OpenAPI GitHub

Pinecone Manage Assistants API is one of 9 APIs that Pinecone publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Manage Assistants. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 12 operations across 7 paths, and defines 31 schemas. It is described by OpenAPI 3.2.0, at version 2025-10.

Requests are made against 2 base URLs: https://api.pinecone.io/assistant, https://{assistant_host}.

12 operations 7 paths 31 schemas 2 DELETE4 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-10
Base URL
https://api.pinecone.io
Authentication
API Key
Contact
Pinecone Support
License
Apache 2.0
Resource Areas
1

Authentication & Security 1

Pinecone Manage Assistants API declares 1 security scheme for authenticating requests. An API key is passed in the header as Api-Key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — Pinecone API Key

Paths & Operations 12

Across 7 paths, the API surfaces 12 operations — 2 DELETE, 4 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Manage Assistants 12

Actions that manage Assistants

GET
/assistants
List assistants
list_assistants 1 param → 200401500
POST
/assistants
Create an assistant
create_assistant 1 param body → 200400401500429
GET
/assistants/{assistant_name}
Check assistant status
get_assistant 2 params → 200401404500
DELETE
/assistants/{assistant_name}
Delete an assistant
delete_assistant 2 params → 200401404500
PATCH
/assistants/{assistant_name}
Update an assistant
update_assistant 2 params body → 200400401404500
GET
/files/{assistant_name}
List Files
list_files 3 params → 200401404500
POST
/files/{assistant_name}
Upload file to assistant
upload_file 4 params body → 200400401404500
GET
/files/{assistant_name}/{assistant_file_id}
Describe a file upload
describe_file 4 params → 200401404500
DELETE
/files/{assistant_name}/{assistant_file_id}
Delete an uploaded file
delete_file 3 params → 200401404500
POST
/chat/{assistant_name}/chat/completions
Chat through an OpenAI-compatible interface
chat_completion_assistant 2 params body → 200400401404500
POST
/chat/{assistant_name}
Chat with an assistant
chat_assistant 2 params body → 200400401404500
POST
/chat/{assistant_name}/context
Retrieve context from an assistant
context_assistant 2 params body → 200400401404500

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are AssistantFileModel (10 properties), ChatRequest (8 properties), Assistant (7 properties), ContextRequest (7 properties). Each schema is shown below with its type and property counts.

Assistant
object
Describes the configuration and status of a Pinecone Assistant.
7 properties 2 required
ErrorResponse
object
The response shape used for all error responses.
2 properties 2 required
ContextOptionsModel
object
Controls the context snippets sent to the LLM.
4 properties
MessageModel
object
Describes the format of a message in a chat.
2 properties
ChoiceChunkModel
object
Describes a single choice in a chat completion response.
3 properties
MultiModalContentBlocksModel
object
Represents a block in the multimodal content of a context snippet.
ChoiceModel
object
Describes a single choice in a chat completion response.
3 properties
TypedReferenceModel
object
Represents a reference for the information provided.
ImageModel
objectnull
Represents the data for an image.
3 properties 3 required
UsageModel
object
Describes the usage of a chat completion.
3 properties
MarkdownReferenceModel
object
Represents a reference to a part of a markdown document.
2 properties 2 required
MultiModalContentTextBlockModel
object
Represents a text block in a multimodal context snippet.
2 properties 2 required
JsonReferenceModel
object
Represents a reference to a json document.
2 properties 2 required
SnippetModel
object
Represents a part of a document that is relevant to the user query.
ContextRequest
object
Parameters to retrieve context from an assistant.
7 properties
ContextModel
object
The response format containing the context from an assistant.
3 properties 2 required
DocxReferenceModel
object
Represents a reference to a part of a docx document.
3 properties 3 required
StreamChatCompletionChunkModel
object
Describes the response format of a chat request.
3 properties
ChatRequest
object
The list of queries / chats to chat an assistant
8 properties 1 required
MultiModalContentImageBlockModel
object
Represents an image block in a multimodal context snippet.
3 properties 2 required
HighlightModel
objectnull
Represents a portion of a referenced document that directly supports or is relevant to the response.
2 properties 2 required
TextReferenceModel
object
Represents a reference to a part of a text document.
2 properties 2 required
TextSnippetModel
object
Represents a text context snippet.
4 properties 4 required
ReferenceModel
object
Describes a single reference in a citation.
3 properties
SearchCompletions
object
The list of queries / chats to chat an assistant
5 properties 1 required
ChatModel
object
Describes the response format of a chat request from the citation API.
6 properties
CitationModel
object
Describes a single cited source returned by a chat request.
2 properties
MultiModalSnippetModel
object
Represents a multimodal context snippet.
4 properties 4 required
AssistantFileModel
object
The response format for a successful file upload request.
10 properties 2 required
ChatCompletionModel
object
Describes the response format of a chat request.
4 properties
PdfReferenceModel
object
Represents a reference to a part of a PDF document.
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

pinecone-manage-assistants-api-openapi.yml Raw ↑

Other APIs Pinecone publishes across the network.

Pinecone API Keys API
AE Profile APIs.io
Pinecone Bulk Operations API
AE Profile APIs.io
Pinecone Inference API
AE Profile APIs.io
Pinecone Manage Indexes API
AE Profile APIs.io
Pinecone Namespace Operations API
AE Profile APIs.io
Pinecone Organizations API
AE Profile APIs.io
Pinecone Projects API
AE Profile APIs.io
Pinecone Vector Operations API
AE Profile APIs.io
#Manage Assistants
← Back to P APIs
API Details
ID
pinecone:pinecone-manage-assistants-api
Base URL
https://api.pinecone.io
Docs
https://docs.pinecone.io/reference/api/introduction
Provider
Pinecone
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=pinecone-manage-assistants-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/pinecone-manage-assistants-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Pinecone Manage Assistants API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.