# pip install --upgrade pinecone
import os
from pinecone import Pinecone
pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
response = pc.assistants.context(
assistant_name="example-assistant",
query="Who is the CFO of Netflix?",
)
for snippet in response.snippets:
print(snippet.score, snippet.content)
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();
const assistant = pc.assistant({ name: 'example-assistant' });
const response = await assistant.context({
query: 'Who is the CFO of Netflix?',
});
console.log(response.snippets);
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
curl "https://prod-1-data.ke.pinecone.io/assistant/chat/$ASSISTANT_NAME/context" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Pinecone-Api-Version: 2026-07" \
-d '{
"query": "Who is the CFO of Netflix?"
}'
{
"snippets": [
{
"type": "<string>",
"content": "<string>",
"score": 123,
"reference": {
"type": "<string>",
"file": {
"name": "<string>",
"id": "<string>",
"size": 1048576,
"metadata": {
"created_by": "Jane Doe",
"published": "2025-10-01T00:00:00.000Z",
"tags": [
"report",
"Q4",
"analytics"
]
},
"created_on": "2025-10-01T12:30:00.000Z",
"updated_on": "2025-10-01T12:45:00.000Z",
"status": "<string>",
"signed_url": "https://storage.googleapis.com/bucket/file.pdf?...",
"multimodal": true
}
}
}
],
"usage": {
"prompt_tokens": 123,
"completion_tokens": 123,
"total_tokens": 123
},
"id": "<string>"
}{
"error": {
"code": "INVALID_ARGUMENT",
"message": "Uploaded file can only currently be either a pdf or txt file"
},
"status": 400
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid API key."
},
"status": 401
}{
"error": {
"code": "NOT_FOUND",
"message": "Assistant \"example-assistant\" not found."
},
"status": 404
}{
"error": {
"code": "UNKNOWN",
"message": "Internal server error"
},
"status": 500
}Retrieve context from an assistant
Retrieve context snippets from an assistant to use as part of RAG or any agentic flow.
For guidance and examples, see Retrieve context snippets.
# pip install --upgrade pinecone
import os
from pinecone import Pinecone
pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
response = pc.assistants.context(
assistant_name="example-assistant",
query="Who is the CFO of Netflix?",
)
for snippet in response.snippets:
print(snippet.score, snippet.content)
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();
const assistant = pc.assistant({ name: 'example-assistant' });
const response = await assistant.context({
query: 'Who is the CFO of Netflix?',
});
console.log(response.snippets);
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
curl "https://prod-1-data.ke.pinecone.io/assistant/chat/$ASSISTANT_NAME/context" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Pinecone-Api-Version: 2026-07" \
-d '{
"query": "Who is the CFO of Netflix?"
}'
{
"snippets": [
{
"type": "<string>",
"content": "<string>",
"score": 123,
"reference": {
"type": "<string>",
"file": {
"name": "<string>",
"id": "<string>",
"size": 1048576,
"metadata": {
"created_by": "Jane Doe",
"published": "2025-10-01T00:00:00.000Z",
"tags": [
"report",
"Q4",
"analytics"
]
},
"created_on": "2025-10-01T12:30:00.000Z",
"updated_on": "2025-10-01T12:45:00.000Z",
"status": "<string>",
"signed_url": "https://storage.googleapis.com/bucket/file.pdf?...",
"multimodal": true
}
}
}
],
"usage": {
"prompt_tokens": 123,
"completion_tokens": 123,
"total_tokens": 123
},
"id": "<string>"
}{
"error": {
"code": "INVALID_ARGUMENT",
"message": "Uploaded file can only currently be either a pdf or txt file"
},
"status": 400
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid API key."
},
"status": 401
}{
"error": {
"code": "NOT_FOUND",
"message": "Assistant \"example-assistant\" not found."
},
"status": 404
}{
"error": {
"code": "UNKNOWN",
"message": "Internal server error"
},
"status": 500
}# pip install --upgrade pinecone
import os
from pinecone import Pinecone
pc = Pinecone(api_key=os.environ["PINECONE_API_KEY"])
response = pc.assistants.context(
assistant_name="example-assistant",
query="Who is the CFO of Netflix?",
)
for snippet in response.snippets:
print(snippet.score, snippet.content)
// npm install @pinecone-database/pinecone
import { Pinecone } from '@pinecone-database/pinecone';
// Reads PINECONE_API_KEY from the environment
const pc = new Pinecone();
const assistant = pc.assistant({ name: 'example-assistant' });
const response = await assistant.context({
query: 'Who is the CFO of Netflix?',
});
console.log(response.snippets);
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
curl "https://prod-1-data.ke.pinecone.io/assistant/chat/$ASSISTANT_NAME/context" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Pinecone-Api-Version: 2026-07" \
-d '{
"query": "Who is the CFO of Netflix?"
}'
Authorizations
Pinecone API Key
Headers
Required date-based version header
Path Parameters
The name of the assistant to be described.
Body
The desired configuration to retrieve context from an assistant.
Parameters to retrieve context from an assistant.
The query that is used to generate the context. Exactly one of query or messages should be provided.
Optionally filter which documents can be retrieved using the following metadata fields.
{ "genre": { "$ne": "documentary" } }
The list of messages to use for generating the context. Exactly one of query or messages should be provided.
Show child attributes
Show child attributes
The maximum number of context snippets to return. Default is 16. Maximum is 64.
20
The maximum context snippet size. Default is 2048 tokens. Minimum is 512 tokens. Maximum is 8192 tokens.
4096
Whether or not to retrieve image-related context snippets. If false, only text snippets are returned.
If image-related context snippets are returned, this field determines whether or not they should include base64 image data. If false, only the image captions are returned. Only available when multimodal=true.
Response
Context retrieval process successful.
Describes the context returned by an assistant in response to a query.
A list of context snippets relevant to the user's query.
Represents a text context snippet.
- Text context snippet
- Multimodal context snippet
Show child attributes
Show child attributes
Describes the token usage associated with interactions with an assistant.
Show child attributes
Show child attributes
A unique identifier for this context response.
Was this page helpful?