run_analysis_snapshot_not_ready
The run's analysis snapshot is not in a readable state.
run_analysis_snapshot_not_ready is a 409 returned whenever a run's analysis snapshot is read while its status is anything other than succeeded. That includes terminal failures, so the error alone does not tell you whether waiting will help.
Branch on details.status:
details.status | Meaning | Wait? |
|---|---|---|
queued | Not started yet. | Yes. |
processing | Being compiled. | Yes. |
failed | Terminal. | No. |
details.runState carries the run's own state alongside it.
Recovery guidance
Poll only while the status is queued or processing, backing off between reads — a run that has just reached a terminal state may still be compiling.
Stop when the status is failed. The same read cannot change a terminal snapshot, so a client that keeps polling will loop indefinitely. Recovering from failed means having the snapshot materialized again, not re-reading it; escalate with the run ID and the requestId if that is not something your integration can trigger.