# Score past production traffic with an observer

Source: <https://everruns.com/docs/api/operations/backfill_observer/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Evaluation & reporting](https://everruns.com/docs/api/groups/evaluation-reporting/)/Score past production traffic with an observer

# Score past production traffic with an observer

Preview

Inspect agent quality, health, observers and notifications.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/observers/{observer_id}/backfill`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**observer_id**

required

string

Prefixed public identifier

## Request Bodyrequired

Media typeapplication/json

Score past production traffic with an observer.

object

**limit**

Most past events to read, newest first (1–5000). Defaults to 500.

integer | null format: int32

### Example

```json
500
```

**sample**

Apply the observer’s sampling rate. Defaults to true; false scores every matching slice read.

boolean | null

**since_hours**

How far back to read, in hours (1–720). Defaults to 24.

integer | null format: int32

### Example

```json
24
```

## Responses

200Success

### 200

Success

Media typeapplication/json

What a backfill read and queued.

object

**enqueued**

required

Scores queued. Turns and tool calls already scored are not queued again; a conversation’s score is refreshed.

integer format: int64

**events_read**

required

Past turn, tool and idle events read.

integer format: int64

### Example generated

```json
{
  "enqueued": 1,
  "events_read": 1
}
```

404Observer not found

### 404

Observer not found

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/observers/example/backfill';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"limit":500,"sample":true,"since_hours":24}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/observers/example/backfill \
  --header 'Content-Type: application/json' \
  --data '{ "limit": 500, "sample": true, "since_hours": 24 }'
```

Additional language examples require JavaScript. The default request example is available above.

200404

200 · Success

```json
{
  "enqueued": 0,
  "events_read": 0
}
```

404 · Observer not found

No response body example is declared for this status.

## Matching endpoints