---
title: "Push Samples"
method: POST
path: "/api/v1/evaluations/{evaluation_id}/samples"
tags: ["evals"]
---

# Push Samples

`POST /api/v1/evaluations/{evaluation_id}/samples`

Push evaluation samples

This endpoint can be called multiple times to stream samples as they're generated.

## Path parameters

- `evaluation_id` string, required

## Request body

- PushSamplesRequest — Request to push evaluation samples (replaces traces)
  - `samples` object[], required — List of evaluation samples

## Response `200`

Successful Response

- PushSamplesResponse — Response after pushing samples
  - `evaluation_id` string, required
  - `samples_pushed` integer, required
  - `status` 'PENDING' | 'RUNNING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'TIMEOUT' | 'CANCELLED', required — Evaluation status enum

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/versions/60efc9b3ff2a/schema)