List assistants
List of all assistants in a project.
For guidance and examples, see Manage assistants.
PINECONE_API_KEY="YOUR_API_KEY"
curl -X GET "https://api.pinecone.io/assistant/assistants" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "X-Pinecone-Api-Version: 2026-04"{
"assistants": [
{
"name": "example-assistant",
"instructions": "Use American English for spelling and grammar.",
"metadata": {"team": "customer-support", "version": "1.0"},
"status": "Ready",
"host": "https://prod-1-data.ke.pinecone.io",
"created_at": "2025-10-01T12:30:00Z",
"updated_at": "2025-10-01T12:45:00Z"
}
]
}GET /assistants
Authorizations
Section titled “Authorizations”Api-KeystringrequiredPinecone API Key
Headers
Section titled “Headers”X-Pinecone-Api-VersionstringrequiredRequired date-based version header
Query Parameters
Section titled “Query Parameters”limit?integerLimit on the number of assistants to return. Default is 50. Minimum is 1. Maximum is 100.
pagination_token?stringPagination token to continue a previous listing operation.
Response
Section titled “Response”200 — List all assistants in a project.
assistants?object[]The list of assistants that exist in the project.
Show child attributes
namestringrequiredThe name of the assistant. Resource name must be 1-63 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or -.
Required string length: 1 - 63. Example: example-assistant
instructions?string | nullGuidance applied to all responses generated by the assistant.
Example: Answer questions with clear, helpful answers. Keep the tone friendly and easy to follow.
metadata?object | nullOptional metadata associated with the assistant. Metadata is a JSON object that can store custom organizational data, tags, and attributes.
statusstringrequiredThe current operational status of the assistant.
host?stringThe host where the assistant is deployed.
Example: https://prod-1-data.ke.pinecone.io
region?stringThe region where the assistant is deployed.
created_at?stringThe timestamp when the assistant was created, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
Example: 2025-10-01T12:30:00.000Z
updated_at?stringThe timestamp of the most recent update to the assistant, in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
Example: 2025-10-01T12:45:00.000Z
pagination?objectObject that contains the next pagination token to continue a previous listing operation.
Show child attributes
nextstringrequiredThe token to use to retrieve the next page of results.