Create an assistant
For guidance and examples, see Create an assistant
PINECONE_API_KEY="YOUR_API_KEY"
curl "https://api.pinecone.io/assistant/assistants" \
-H "Api-Key: $PINECONE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Pinecone-Api-Version: 2025-10" \
-d '{
"name": "example-assistant",
"instructions": "Use American English for spelling and grammar.",
"metadata": {"team": "customer-support", "version": "1.0"},
"region":"us"
}'{
"name": "example-assistant",
"instructions": "Use American English for spelling and grammar.",
"metadata": {"team": "customer-support", "version": "1.0"},
"status": "Initializing",
"host": "https://prod-1-data.ke.pinecone.io",
"created_at": "2025-10-01T12:30:00Z",
"updated_at": "2025-10-01T12:30:00Z"
}POST /assistants
Authorizations
Section titled “Authorizations”Api-KeystringrequiredPinecone API Key
Headers
Section titled “Headers”X-Pinecone-Api-VersionstringrequiredRequired date-based version header
The desired configuration to create an assistant.
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 | nullDescription or directive for the assistant to apply to all responses. Maximum 16 KB.
metadata?objectOptional metadata associated with the assistant. Metadata is a JSON object that can store custom organizational data, tags, and attributes. Maximum size is 16KB.
region?stringThe region to deploy the assistant in. Our current options are either us or eu. Defaults to us.
Response
Section titled “Response”200 — Create request successful.
Describes the configuration and status of a Pinecone Assistant.
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 | nullDescription or directive for the assistant to apply to all responses.
metadata?object | nullOptional metadata associated with the assistant. Metadata is a JSON object that can store custom organizational data, tags, and attributes.
statusstringrequiredhost?stringThe host where the assistant is deployed.
created_at?stringupdated_at?string