# `run_not_ready`

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

A read that needs a settled Run was asked of one that has nothing to serve yet.

## Status

HTTP `409`, title `Run not ready`. One of the [the request itself](https://www.shortsintel.com/docs/reference/errors#the-request-itself) errors. Branch on `code`, never on the status or the prose.

Retryable: yes. Every body carries this as `retryable: true`, beside `action` and `remedy`: the same request can succeed later, after a backoff or the wait the response names.

## Common causes

- The Run is still running.
- The Run failed, so there is nothing to read.

## What to do

Action: Poll the Run until it settles, then read again. If it failed, start a new Run.

A running Run will settle: poll it with `GET /v1/runs/{id}` until it is `completed` or `partial`, then retry the read. A failed Run will not: retrying cannot help, so start a new Run.

## Example

The body arrives as `application/problem+json`, with `retryable` and the `remedy` above. Most responses add `detail` about the occurrence, and some add fields of their own.

```json
{
  "type": "https://www.shortsintel.com/docs/reference/errors/run_not_ready",
  "title": "Run not ready",
  "status": 409,
  "code": "run_not_ready",
  "retryable": true,
  "action": "Poll the Run until it settles, then read again. If it failed, start a new Run.",
  "remedy": "A running Run will settle: poll it with `GET /v1/runs/{id}` until it is `completed` or `partial`, then retry the read. A failed Run will not: retrying cannot help, so start a new Run."
}
```

## Related

- [Runs](https://www.shortsintel.com/docs/concepts/runs)
- [Poll or re-read a run](https://www.shortsintel.com/docs/reference/runs/get-run)
- [Every error code](https://www.shortsintel.com/docs/reference/errors)

[Previous idempotency_conflict](https://www.shortsintel.com/docs/reference/errors/idempotency_conflict)[Next advertiser_ambiguous](https://www.shortsintel.com/docs/reference/errors/advertiser_ambiguous)
