Troubleshooting

pc auth status
pc logout
pc login
pc target -o "my-org" -p "my-project"

pc target --show   # Verify correct project is targeted

pc config get-api-key   # Verify key is set
# API keys are scoped to org + project — get a new one if needed
pc api-key create -n "new-key" --store

pc target --show
pc target --clear
pc target -o "my-org" -p "my-project"

pc index describe -n my-index
# "Initializing" → wait and retry
# "Terminating" → recreate it

# Check if deletion protection is on
pc index describe -n my-index
pc index configure -n my-index --deletion-protection disabled
pc index delete -n my-index

pc index describe -n my-index   # Check configured dimension
# Ensure all vectors have exactly that many values

# Use max batch size
pc index vector upsert -n my-index --file ./large.json --batch-size 1000

# Or split JSONL and loop
split -l 10000 large.jsonl chunk-
for file in chunk-*; do
  pc index vector upsert -n my-index --file "$file"
done

pc index stats -n my-index          # Check if data exists
pc index namespace list -n my-index # Verify namespace
# Filters use MongoDB query syntax — double-check filter format

pc index describe -n my-index
# Backups are only supported for serverless indexes in "Ready" state

pc backup list --index-name my-index
# Use the UUID (e.g. c84725e5-...) not the name for restore/delete

pc auth status
pc target --show
pc index describe -n my-index

pc index list -j | jq -r '.[] | .name'

pc index vector update -n my-index \
  --filter '{"genre":{"$eq":"old"}}' \
  --metadata '{"genre":"new"}' \
  --dry-run

pc index create -n prod-index -d 1536 -m cosine -c aws -r us-east-1 \
  --deletion-protection enabled

pc backup create -i my-index -n "daily-backup-$(date +%Y%m%d)"