Immutable solution version
Pinecone: poll describe_index until status.ready before first write
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
- Put this in every script that creates an index: setup scripts, seed scripts, tests, migration scripts. No exceptions.
- Always include the timeout. An infinite poll turns a stuck provisioning into a hung CI job that burns minutes silently.
- Log state transitions while polling. "Still provisioning after 4 minutes" is actionable information for support; a silent hang is not.
- 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>