# Pinecone Docs: Pinecone Assistant Reference > Official Pinecone documentation for the vector database, Assistant, inference APIs, SDKs, and building production search and AI applications. ## Reference ### 2026-04 (latest) #### APIs - [Assistant API reference](https://docs.pinecone.io/reference/api/assistant/introduction.md): Assistant API reference overview covering document upload, chat, and RAG endpoints supported by the Pinecone Python and Node.js SDKs. - [Authentication](https://docs.pinecone.io/reference/api/assistant/authentication.md): Assistant API authentication with API keys, HTTP headers, and SDK client initialization for Pinecone Assistant requests and RAG apps. - [Pinecone Assistant limits](https://docs.pinecone.io/reference/api/assistant/assistant-limits.md): Reference for Pinecone Assistant limits, including file size, storage, chat token, and rate limits across the Starter, Builder, Standard, and Enterprise plans. #### Assistants - [List assistants](https://docs.pinecone.io/reference/api/2026-04/assistant/list_assistants.md): List of all assistants in a project. - [Create an assistant](https://docs.pinecone.io/reference/api/2026-04/assistant/create_assistant.md): Create an assistant. This is where you specify the underlying training model, which cloud provider you would like to deploy with, and more. - [Check assistant status](https://docs.pinecone.io/reference/api/2026-04/assistant/describe_assistant.md): Get the status of an assistant. - [Update an assistant](https://docs.pinecone.io/reference/api/2026-04/assistant/update_assistant.md): Update an existing assistant. You can modify the assistant's instructions. - [Delete an assistant](https://docs.pinecone.io/reference/api/2026-04/assistant/delete_assistant.md): Delete an existing assistant. #### Files - [List Files](https://docs.pinecone.io/reference/api/2026-04/assistant/list_files.md): List all files in an assistant, with an option to filter files with metadata. - [Upload a file](https://docs.pinecone.io/reference/api/2026-04/assistant/upload_file.md): Upload a file to the specified assistant. - [Upsert a file](https://docs.pinecone.io/reference/api/2026-04/assistant/upsert_file.md): Create or replace a file in the specified assistant. If a file with the given `assistant_file_id` already exists, it will be replaced with the new file. If it doesn't exist, a new file will be created with that identifier. - [Describe a file](https://docs.pinecone.io/reference/api/2026-04/assistant/describe_file.md): [Get the current status and metadata of a file](https://docs.pinecone.io/guides/assistant/manage-files#get-the-status-of-a-file) uploaded to an assistant. - [Delete a file](https://docs.pinecone.io/reference/api/2026-04/assistant/delete_file.md): [Delete an uploaded file](https://docs.pinecone.io/guides/assistant/manage-files#delete-a-file) from an assistant. #### Operations - [List operations](https://docs.pinecone.io/reference/api/2026-04/assistant/list_operations.md): List all operations for an assistant. Returns operations that are in progress, as well as recently completed or failed operations. Both successful and failed operations are retained for 30 days after completion. Use the `operation_type` and `status` query parameters to filter results. - [Describe an operation](https://docs.pinecone.io/reference/api/2026-04/assistant/describe_operation.md): Get the status of an operation. #### Chat - [Chat with an assistant](https://docs.pinecone.io/reference/api/2026-04/assistant/chat_assistant.md): Chat with an assistant and get back citations in structured form. - [Chat through an OpenAI-compatible interface](https://docs.pinecone.io/reference/api/2026-04/assistant/chat_completion_assistant.md): Chat with an assistant. This endpoint is based on the OpenAI Chat Completion API, a commonly used and adopted API. #### Evaluation - [Evaluate an answer](https://docs.pinecone.io/reference/api/2026-04/assistant/metrics_alignment.md): Evaluate the correctness and completeness of a response from an assistant or a RAG system. The correctness and completeness are evaluated based on the precision and recall of the generated answer with respect to the ground truth answer facts. Alignment is the harmonic mean of correctness and complet… #### Context snippets - [Retrieve context from an assistant](https://docs.pinecone.io/reference/api/2026-04/assistant/context_assistant.md): Retrieve context snippets from an assistant to use as part of RAG or any agentic flow. #### Admin ##### API keys - [Create an API key](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/create_api_key.md): Create an API key for a project to authenticate Data Plane and Control Plane requests. - [List API keys](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/list_api_keys.md): List all API keys in a project. - [Get API key details](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/fetch_api_key.md): Get an API key's details, excluding its secret. - [Update an API key](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/update_api_key.md): Update an API key's name and roles. - [Delete an API key](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/delete_api_key.md): Delete an API key from a project. ##### Projects - [Create a new project](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/create_project.md): Create a new project. - [List projects](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/list_projects.md): List all projects in an organization. - [Get project details](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/fetch_project.md): Get a project's details. - [Update a project](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/update_project.md): Update a project's name, maximum number of Pods, or customer-managed encryption key (CMEK). - [Delete a project](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/delete_project.md): Delete a project and all its configuration; delete its indexes, assistants, backups, and collections first. ##### Service accounts - [Create an access token](https://docs.pinecone.io/reference/api/2026-04/admin-assistant/get_token.md): Obtain an access token for a service account using the OAuth2 client credentials flow. An access token is needed to authorize requests to the Pinecone Admin API. The host domain for OAuth endpoints is `login.pinecone.io`. #### Architecture - [Pinecone Assistant architecture](https://docs.pinecone.io/reference/architecture/assistant-architecture.md): Pinecone Assistant architecture overview covering document ingestion, chunking, vector retrieval, and LLM response generation for RAG. ### 2025-10 #### APIs - [Assistant API reference](https://docs.pinecone.io/reference/api/assistant/introduction.md): Assistant API reference overview covering document upload, chat, and RAG endpoints supported by the Pinecone Python and Node.js SDKs. - [Authentication](https://docs.pinecone.io/reference/api/assistant/authentication.md): Assistant API authentication with API keys, HTTP headers, and SDK client initialization for Pinecone Assistant requests and RAG apps. - [Pinecone Assistant limits](https://docs.pinecone.io/reference/api/assistant/assistant-limits.md): Reference for Pinecone Assistant limits, including file size, storage, chat token, and rate limits across the Starter, Builder, Standard, and Enterprise plans. #### Assistants - [List assistants](https://docs.pinecone.io/reference/api/2025-10/assistant/list_assistants.md): List of all assistants in a project. - [Create an assistant](https://docs.pinecone.io/reference/api/2025-10/assistant/create_assistant.md): Create an assistant. This is where you specify the underlying training model, which cloud provider you would like to deploy with, and more. - [Check assistant status](https://docs.pinecone.io/reference/api/2025-10/assistant/describe_assistant.md): Get the status of an assistant. - [Update an assistant](https://docs.pinecone.io/reference/api/2025-10/assistant/update_assistant.md): Update an existing assistant. You can modify the assistant's instructions. - [Delete an assistant](https://docs.pinecone.io/reference/api/2025-10/assistant/delete_assistant.md): Delete an existing assistant. #### Files - [List Files](https://docs.pinecone.io/reference/api/2025-10/assistant/list_files.md): List all files in an assistant, with an option to filter files with metadata. - [Upload file to assistant](https://docs.pinecone.io/reference/api/2025-10/assistant/upload_file.md): Upload a file to the specified assistant. - [Describe a file upload](https://docs.pinecone.io/reference/api/2025-10/assistant/describe_file.md): Get the status and metadata of a file uploaded to an assistant. - [Delete an uploaded file](https://docs.pinecone.io/reference/api/2025-10/assistant/delete_file.md): Delete an uploaded file from an assistant. #### Chat - [Chat with an assistant](https://docs.pinecone.io/reference/api/2025-10/assistant/chat_assistant.md): Chat with an assistant and get back citations in structured form. - [Chat through an OpenAI-compatible interface](https://docs.pinecone.io/reference/api/2025-10/assistant/chat_completion_assistant.md): Chat with an assistant. This endpoint is based on the OpenAI Chat Completion API, a commonly used and adopted API. #### Evaluation - [Evaluate an answer](https://docs.pinecone.io/reference/api/2025-10/assistant/metrics_alignment.md): Evaluate the correctness and completeness of a response from an assistant or a RAG system. The correctness and completeness are evaluated based on the precision and recall of the generated answer with respect to the ground truth answer facts. Alignment is the harmonic mean of correctness and complet… #### Context snippets - [Retrieve context from an assistant](https://docs.pinecone.io/reference/api/2025-10/assistant/context_assistant.md): Retrieve context snippets from an assistant to use as part of RAG or any agentic flow. #### Admin ##### API keys - [Create an API key](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/create_api_key.md): 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. - [List API keys](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/list_api_keys.md): List all API keys in a project. - [Get API key details](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/fetch_api_key.md): Get the details of an API key, excluding the API key secret. - [Update an API key](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/update_api_key.md): Update the name and roles of an API key. - [Delete an API key](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/delete_api_key.md): Delete an API key from a project. ##### Projects - [Create a new project](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/create_project.md): Creates a new project. - [List projects](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/list_projects.md): List all projects in an organization. - [Get project details](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/fetch_project.md): Get details about a project. - [Update a project](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/update_project.md): Update a project's configuration details. You can update the project's name, maximum number of Pods, or enable encryption with a customer-managed encryption key (CMEK). - [Delete a project](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/delete_project.md): Delete a project and all its associated configuration. Before deleting a project, you must delete all indexes, assistants, backups, and collections associated with the project. Other project resources, such as API keys, are automatically deleted when the project is deleted. ##### Service accounts - [Create an access token](https://docs.pinecone.io/reference/api/2025-10/admin-assistant/get_token.md): Obtain an access token for a service account using the OAuth2 client credentials flow. An access token is needed to authorize requests to the Pinecone Admin API. The host domain for OAuth endpoints is `login.pinecone.io`. #### Architecture - [Pinecone Assistant architecture](https://docs.pinecone.io/reference/architecture/assistant-architecture.md): Pinecone Assistant architecture overview covering document ingestion, chunking, vector retrieval, and LLM response generation for RAG. ### 2025-04 #### APIs - [Assistant API reference](https://docs.pinecone.io/reference/api/assistant/introduction.md): Assistant API reference overview covering document upload, chat, and RAG endpoints supported by the Pinecone Python and Node.js SDKs. - [Authentication](https://docs.pinecone.io/reference/api/assistant/authentication.md): Assistant API authentication with API keys, HTTP headers, and SDK client initialization for Pinecone Assistant requests and RAG apps. - [Pinecone Assistant limits](https://docs.pinecone.io/reference/api/assistant/assistant-limits.md): Reference for Pinecone Assistant limits, including file size, storage, chat token, and rate limits across the Starter, Builder, Standard, and Enterprise plans. #### Assistants - [List assistants](https://docs.pinecone.io/reference/api/2025-04/assistant/list_assistants.md): List of all assistants in a project. - [Create an assistant](https://docs.pinecone.io/reference/api/2025-04/assistant/create_assistant.md): Create an assistant. This is where you specify the underlying training model, which cloud provider you would like to deploy with, and more. - [Check assistant status](https://docs.pinecone.io/reference/api/2025-04/assistant/describe_assistant.md): Get the status of an assistant. - [Update an assistant](https://docs.pinecone.io/reference/api/2025-04/assistant/update_assistant.md): Update an existing assistant. You can modify the assistant's instructions. - [Delete an assistant](https://docs.pinecone.io/reference/api/2025-04/assistant/delete_assistant.md): Delete an existing assistant. #### Files - [List Files](https://docs.pinecone.io/reference/api/2025-04/assistant/list_files.md): List all files in an assistant, with an option to filter files with metadata. - [Upload file to assistant](https://docs.pinecone.io/reference/api/2025-04/assistant/upload_file.md): Upload a file to the specified assistant. - [Describe a file upload](https://docs.pinecone.io/reference/api/2025-04/assistant/describe_file.md): Get the status and metadata of a file uploaded to an assistant. - [Delete an uploaded file](https://docs.pinecone.io/reference/api/2025-04/assistant/delete_file.md): Delete an uploaded file from an assistant. #### Chat - [Chat with an assistant](https://docs.pinecone.io/reference/api/2025-04/assistant/chat_assistant.md): Chat with an assistant and get back citations in structured form. - [Chat through an OpenAI-compatible interface](https://docs.pinecone.io/reference/api/2025-04/assistant/chat_completion_assistant.md): Chat with an assistant. This endpoint is based on the OpenAI Chat Completion API, a commonly used and adopted API. #### Evaluation - [Evaluate an answer](https://docs.pinecone.io/reference/api/2025-04/assistant/metrics_alignment.md): Evaluate the correctness and completeness of a response from an assistant or a RAG system. The correctness and completeness are evaluated based on the precision and recall of the generated answer with respect to the ground truth answer facts. Alignment is the harmonic mean of correctness and complet… #### Context snippets - [Retrieve context from an assistant](https://docs.pinecone.io/reference/api/2025-04/assistant/context_assistant.md): Retrieve context snippets from an assistant to use as part of RAG or any agentic flow. #### Admin ##### API keys - [Create an API key](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/create_api_key.md): 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. - [List API keys](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/list_api_keys.md): List all API keys in a project. - [Get API key details](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/fetch_api_key.md): Get the details of an API key, excluding the API key secret. - [Update an API key](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/update_api_key.md): Update the name and roles of an API key. - [Delete an API key](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/delete_api_key.md): Delete an API key from a project. ##### Projects - [Create a new project](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/create_project.md): Creates a new project. - [List projects](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/list_projects.md): List all projects in an organization. - [Get project details](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/fetch_project.md): Get details about a project. - [Update a project](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/update_project.md): Update a project's configuration details. You can update the project's name, maximum number of Pods, or enable encryption with a customer-managed encryption key (CMEK). - [Delete a project](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/delete_project.md): Delete a project and all its associated configuration. Before deleting a project, you must delete all indexes, assistants, backups, and collections associated with the project. Other project resources, such as API keys, are automatically deleted when the project is deleted. ##### Service accounts - [Get an access token](https://docs.pinecone.io/reference/api/2025-04/admin-assistant/get_token.md): Obtain an access token for a service account using the OAuth2 client credentials flow. An access token is needed to authorize requests to the Pinecone Admin API. The host domain for OAuth endpoints is `login.pinecone.io`. #### Architecture - [Pinecone Assistant architecture](https://docs.pinecone.io/reference/architecture/assistant-architecture.md): Pinecone Assistant architecture overview covering document ingestion, chunking, vector retrieval, and LLM response generation for RAG. ### 2025-01 #### APIs - [Assistant API reference](https://docs.pinecone.io/reference/api/assistant/introduction.md): Assistant API reference overview covering document upload, chat, and RAG endpoints supported by the Pinecone Python and Node.js SDKs. - [Authentication](https://docs.pinecone.io/reference/api/assistant/authentication.md): Assistant API authentication with API keys, HTTP headers, and SDK client initialization for Pinecone Assistant requests and RAG apps. - [Pinecone Assistant limits](https://docs.pinecone.io/reference/api/assistant/assistant-limits.md): Reference for Pinecone Assistant limits, including file size, storage, chat token, and rate limits across the Starter, Builder, Standard, and Enterprise plans. #### Assistants - [List assistants](https://docs.pinecone.io/reference/api/2025-01/assistant/list_assistants.md): List of all assistants in a project. - [Create an assistant](https://docs.pinecone.io/reference/api/2025-01/assistant/create_assistant.md): Create an assistant. This is where you specify the underlying training model, which cloud provider you would like to deploy with, and more. - [Check assistant status](https://docs.pinecone.io/reference/api/2025-01/assistant/describe_assistant.md): Get the status of an assistant. - [Update an assistant](https://docs.pinecone.io/reference/api/2025-01/assistant/update_assistant.md): Update an existing assistant. You can modify the assistant's instructions. - [Delete an assistant](https://docs.pinecone.io/reference/api/2025-01/assistant/delete_assistant.md): Delete an existing assistant. #### Files - [List Files](https://docs.pinecone.io/reference/api/2025-01/assistant/list_files.md): List all files in an assistant, with an option to filter files with metadata. - [Upload file to assistant](https://docs.pinecone.io/reference/api/2025-01/assistant/upload_file.md): Upload a file to the specified assistant. - [Describe a file upload](https://docs.pinecone.io/reference/api/2025-01/assistant/describe_file.md): Get the status and metadata of a file uploaded to an assistant. - [Delete an uploaded file](https://docs.pinecone.io/reference/api/2025-01/assistant/delete_file.md): Delete an uploaded file from an assistant. #### Chat - [Chat with an assistant](https://docs.pinecone.io/reference/api/2025-01/assistant/chat_assistant.md): Chat with an assistant and get back citations in structured form. - [Chat through an OpenAI-compatible interface](https://docs.pinecone.io/reference/api/2025-01/assistant/chat_completion_assistant.md): Chat with an assistant. This endpoint is based on the OpenAI Chat Completion API, a commonly used and adopted API. #### Evaluation - [Evaluate an answer](https://docs.pinecone.io/reference/api/2025-01/assistant/metrics_alignment.md): Evaluate the correctness and completeness of a response from an assistant or a RAG system. The correctness and completeness are evaluated based on the precision and recall of the generated answer with respect to the ground truth answer facts. Alignment is the harmonic mean of correctness and complet… #### Context snippets - [Retrieve context from an assistant](https://docs.pinecone.io/reference/api/2025-01/assistant/context_assistant.md): Retrieve context snippets from an assistant to use as part of RAG or any agentic flow. #### Architecture - [Pinecone Assistant architecture](https://docs.pinecone.io/reference/architecture/assistant-architecture.md): Pinecone Assistant architecture overview covering document ingestion, chunking, vector retrieval, and LLM response generation for RAG. ## OpenAPI Specs - [assistant_control_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_control_2026-04.oas.yaml) - [assistant_data_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_data_2026-04.oas.yaml) - [assistant_evaluation_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/assistant_evaluation_2026-04.oas.yaml) - [admin_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/admin_2026-04.oas.yaml) - [oauth_2026-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-04/oauth_2026-04.oas.yaml) - [assistant_control_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_control_2025-10.oas.yaml) - [assistant_data_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_data_2025-10.oas.yaml) - [assistant_evaluation_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/assistant_evaluation_2025-10.oas.yaml) - [admin_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/admin_2025-10.oas.yaml) - [oauth_2025-10.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-10/oauth_2025-10.oas.yaml) - [assistant_control_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_control_2025-04.oas.yaml) - [assistant_data_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_data_2025-04.oas.yaml) - [assistant_evaluation_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/assistant_evaluation_2025-04.oas.yaml) - [admin_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/admin_2025-04.oas.yaml) - [oauth_2025-04.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-04/oauth_2025-04.oas.yaml) - [assistant_control_2025-01.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_control_2025-01.oas.yaml) - [assistant_data_2025-01.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_data_2025-01.oas.yaml) - [assistant_evaluation_2025-01.oas](https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2025-01/assistant_evaluation_2025-01.oas.yaml)