Skip to main content
GET
/
assistants
/
{assistant_name}
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"

curl -X GET "https://api.pinecone.io/assistant/assistants/$ASSISTANT_NAME" \
  -H "Api-Key: $PINECONE_API_KEY" \ 
  -H "X-Pinecone-Api-Version: 2025-10"

{
  "name": "example-assistant",
  "status": "<string>",
  "instructions": "<string>",
  "metadata": {},
  "host": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
PINECONE_API_KEY="YOUR_API_KEY"
ASSISTANT_NAME="example-assistant"

curl -X GET "https://api.pinecone.io/assistant/assistants/$ASSISTANT_NAME" \
  -H "Api-Key: $PINECONE_API_KEY" \ 
  -H "X-Pinecone-Api-Version: 2025-10"

Authorizations

​
Api-Key
string
header
required

Pinecone API Key

Headers

​
X-Pinecone-Api-Version
string
default:2025-10
required

Required date-based version header

Path Parameters

​
assistant_name
string
required

The name of the assistant to get a status on.

Response

Poll 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
string
required
​
instructions
string | null

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

​
metadata
object
​
host
string

The host where the assistant is deployed.

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