List assistants

List of all assistants in a project.

For guidance and examples, see Manage assistants.

GET /assistants

curl

PINECONE_API_KEY="YOUR_API_KEY"

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

curl

{
  "assistants": [
    {
      "name": "example-assistant",
      "instructions": "Use American English for spelling and grammar.",
      "metadata": {"team": "customer-support", "version": "1.0"},
      "status": "Ready",
      "host": "https://prod-1-data.ke.pinecone.io",
      "created_at": "2025-10-01T12:30:00Z",
      "updated_at": "2025-10-01T12:45:00Z"
    }
  ]
}

curl

PINECONE_API_KEY="YOUR_API_KEY"

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

curl

{
  "assistants": [
    {
      "name": "example-assistant",
      "instructions": "Use American English for spelling and grammar.",
      "metadata": {"team": "customer-support", "version": "1.0"},
      "status": "Ready",
      "host": "https://prod-1-data.ke.pinecone.io",
      "created_at": "2025-10-01T12:30:00Z",
      "updated_at": "2025-10-01T12:45:00Z"
    }
  ]
}

Authorizations

Api-Key · string · header · required

Pinecone API Key

Headers

X-Pinecone-Api-Version · string · default: 2026-04 · required

Required date-based version header

Query Parameters

limit · integer

Limit on the number of assistants to return. Default is 50. Minimum is 1. Maximum is 100.

pagination_token · string

Pagination token to continue a previous listing operation.

Response

200

application/json

List all assistants in a project.

assistants · object[]

The list of assistants that exist in the project.

Show child attributes

pagination · object

Object that contains the next pagination token to continue a previous listing operation.

Show child attributes

Example:

{ "next": "dXNlcl9pZD11c2VyXzE=" }