Pinecone: poll describe_index until status.ready before first write

TL;DR

Index creation is a queued job across separate subsystems. The create call succeeding means the job was accepted, not that the index exists.

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)

Steps

1. Index creation is a queued job across separate subsystems.
2. The create call succeeding means the job was accepted, not that the index exists.

When to use

You are seeing this: Index creation is a queued job across separate subsystems. Use this skill when you run into "Pinecone: poll describe_index until status.ready before first write".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

Index creation is a queued job across separate subsystems.

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.