---
title: "POST /experimental/eval-runs-v2:check"
method: POST
path: "/experimental/eval-runs-v2:check"
tags: ["Evals"]
---

# POST /experimental/eval-runs-v2:check

`POST /experimental/eval-runs-v2:check`

Checks an eval run up front: validates the agent/model selection, workspace access, and the modelSelection entitlement from the selection alone, with no fixture data.

## Headers

- `Authorization` string

## Request body

- object
  - `workspaceName` string, required
  - `agent` string
  - `model` string
  - `scorerAgent` string
  - `scorerModel` string
  - `variants` union[]
    - union
      - 'baseline'
      - 'usage-spec'
  - `arms` object[]
    - `label` string, required
    - `agent` string
    - `model` string
    - `includeContext` boolean
    - `fixtures` object
    - `forceContextActivation` boolean

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, required
    - `type` 'eval-run-check', required
    - `attributes` object, required
      - `ok` true, required
      - `pricing` object, required
        - `baseCreditsPerScenarioRun` number, required
        - `modelMultiplier` number, required
        - `armModelMultipliers` number[], required
      - `quota` object, nullable, required
        - `used` number, required
        - `limit` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2026-09-15** `050f3217cf2c` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `arms/items/fixtures/additionalProperties/anyOf[subschema #1]/` request property `anyOf` list
  - added `subschema #1, subschema #2` to the `arms/items/fixtures/additionalProperties/anyOf[subschema #1]/` request property `anyOf` list
- **2026-09-09** `1de33e42f781` — 3 info
  - added the new optional request property `arms`
  - added the new optional request property `variants`
  - added the required property `data/attributes/pricing/armModelMultipliers` to the response with the `200` status
- **2026-09-03** `538ff8b269b7` — 2 info
  - added the required property `data/attributes/pricing` to the response with the `200` status
  - added the required property `data/attributes/quota` to the response with the `200` status

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/eval-runs-v2:check/post.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tessl/apis/tessl-api/revisions/f4832accd5c3?raw)
