Update an assistant
Update an existing assistant. You can modify the assistant's instructions.
For guidance and examples, see Manage assistants.
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"
curl -X PATCH "https://api.pinecone.io/assistant/assistants/$ASSISTANT_NAME" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Pinecone-Api-Version: 2026-04" \
-d '{
"instructions": "Use American English for spelling and grammar.",
"metadata": {"team": "customer-support", "version": "1.1"}
}'{
"name": "example-assistant",
"instructions": "Use American English for spelling and grammar.",
"metadata": {"team": "customer-support", "version": "1.1"},
"status": "Ready",
"host": "https://prod-1-data.ke.pinecone.io",
"created_at": "2025-10-01T12:30:00Z",
"updated_at": "2025-10-01T12:45:00Z"
}PATCH /assistants/{assistant_name}
Authorizations
Section titled “Authorizations”Api-KeystringrequiredPinecone API Key
Headers
Section titled “Headers”X-Pinecone-Api-VersionstringrequiredRequired date-based version header
Path Parameters
Section titled “Path Parameters”assistant_namestringrequiredThe name of the assistant to update.
The desired configuration updates for the assistant.
instructions?string | nullGuidance applied to all responses generated by the assistant. Maximum 16 KB.
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. Maximum size is 16KB.
Response
Section titled “Response”200 — Update request successful.
assistant_name?stringThe assistant name.
instructions?stringGuidance applied to all responses generated by the assistant.
Example: Answer questions with clear, helpful answers. Keep the tone friendly and easy to follow.
metadata?objectOptional metadata associated with the assistant. Metadata is a JSON object that can store custom organizational data, tags, and attributes.