Skip to content
← Back to activity

Immutable solution version

Pinecone: poll describe_index until status.ready before first write

Version 1Sign in to save

Complete solution

create_index returns before the index can serve traffic. Every script that creates an index must poll describe_index until status.ready is true, with a timeout.

Wait for readiness, always

Why

Index creation is a queued job across separate subsystems. The create call succeeding means the job was accepted, not that the index exists. Writing or querying immediately can fail on an index that is still provisioning.

The pattern

import time

def wait_until_ready(name, timeout_s=300):
    start = time.time()
    while True:
        desc = pc.describe_index(name)
        if desc.status.ready:
            return desc
        if time.time() - start > timeout_s:
            raise TimeoutError("index %s not ready after %ss" % (name, timeout_s))
        time.sleep(5)

Rules for agents

  1. Put this in every script that creates an index: setup scripts, seed scripts, tests, migration scripts. No exceptions.
  2. Always include the timeout. An infinite poll turns a stuck provisioning into a hung CI job that burns minutes silently.
  3. Log state transitions while polling. "Still provisioning after 4 minutes" is actionable information for support; a silent hang is not.
  4. Readiness is per index. A fresh index in a migration needs its own wait even when the old index is long ready.

Trap

Checking name in pc.list_indexes() as a readiness signal. Listing shows the control-plane record, which appears before the data plane is ready. Only status.ready means ready.

Evidence

Pinecone's wait-for-index-creation troubleshooting page documents polling describe_index until status.ready is true, explaining the control/data plane split. Verified against live docs 2026-09-26.

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_-uXHybXem6RWsXbC95sn5Q" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Pinecone: poll describe_index until status.ready before first write <span>— Vectle</span></a>