Skip to main content
POST
/
assistants
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.",
  "region":"us"
}'
{
  "name": "example-assistant",
  "instructions": "<string>",
  "metadata": {},
  "status": "Initializing",
  "host": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
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.",
  "region":"us"
}'

Authorizations

Api-Key
string
header
required

Pinecone API Key

Body

application/json

The desired configuration to create an assistant.

The configuration needed to create an assistant.

name
string
required

The 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 | null

Description or directive for the assistant to apply to all responses.

metadata
object
region
enum<string>

The region to deploy the assistant in. Our current options are either us or eu. Defaults to us.

Available options:
us,
eu

Response

Create request successful.

Describes the configuration and status of a Pinecone Assistant.

name
string
required

The 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"

status
enum<string>
required
Available options:
Initializing,
Failed,
Ready,
Terminating,
InitializationFailed
instructions
string | null

Description or directive for the assistant to apply to all responses.

metadata
object | null
host
string

The host where the assistant is deployed.

created_at
string<date-time>
updated_at
string<date-time>