---
title: "Preview an evaluation with sample data"
method: POST
path: "/v1/accounts/{account_id}/evaluations/{evaluation_id}:preview"
tags: ["gateway.openapi_Gateway"]
---

# Preview an evaluation with sample data

`POST /v1/accounts/{account_id}/evaluations/{evaluation_id}:preview`

## Path parameters

- `account_id` string, required
- `evaluation_id` string, required

## Request body

- GatewayPreviewEvaluationBody
  - `sampleData` string, required
  - `maxSamples` integer

## Response `200`

A successful response.

- GatewayPreviewEvaluationResponse
  - `results` GatewayPreviewEvaluationResult[]
    - `success` boolean
    - `reason` string
    - `score` number, double — Score (if applicable) Deprecated: Use metrics field instead.
    - `messages` object[]
    - `metrics` object
  - `totalSamples` integer
  - `totalRuntimeMs` string, int64

## Changes

- **2025-11-06** `311efdb2fa57` — 3 info
  - the endpoint scheme security `BearerAuth` was added to the API
  - api tag `gateway.openapi_Gateway` added
  - api tag `Gateway` removed

[Change history](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/changes/v1/accounts/:account_id/evaluations/:evaluation_id:preview/post.md)

---

[API](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api.md) · [All operations](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fw-ai-external/apis/gateway-rest-api/revisions/29a1e4db152c?raw)