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

# POST /experimental/eval-runs-v2

`POST /experimental/eval-runs-v2`

Creates an eval run.

## Headers

- `Authorization` string

## Request body

- object
  - `workspaceName` string, required
  - `scenarios` object, required — Per-scenario tarballs and fixtures, keyed by scenario path
  - `evalRunFixtures` object
  - `skipForcedContextActivation` boolean
  - `skipScoring` boolean
  - `variants` union[], required
    - union
      - 'baseline'
      - 'usage-spec'
  - `agent` string
  - `model` string
  - `scorerAgent` string
  - `scorerModel` string
  - `runs` integer
  - `skipSolved` boolean
  - `runQualityCheck` boolean
  - `label` string
  - `metadata` object
    - `originRemoteUrl` string
    - `branchName` string
    - `commitHash` string
    - `dirty` boolean
    - `cwd` string
    - `cliInvocation` string
    - `tileName` string
    - `tileVersion` string
    - `tileSummary` string
    - `tileIsPrivate` boolean
    - `skillName` string
    - `sourceUrl` string
    - `blobSha` string
  - `projectLocator` object
    - `workspaceName` string, required
    - `projectName` string, required
  - `projectProvenance` object
    - `sourceType` string, required
    - `sourceUri` string, required
    - `repoSubpath` string, required
  - `encryptedEnvUpload` object — Reference to an encrypted-input upload (e.g. an env-file) delivered to the solve sandbox. Must be an existing, viewable, encrypted upload.
    - `uploadKey` string, required

## Response `201`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'eval-run', required
    - `attributes` object, required
      - `workflowId` string, required
      - `metadata` object, required
        - `originRemoteUrl` string
        - `branchName` string
        - `commitHash` string
        - `dirty` boolean
        - `cwd` string
        - `cliInvocation` string
        - `tileName` string
        - `tileVersion` string
        - `tileSummary` string
        - `tileIsPrivate` boolean
        - `skillName` string
        - `sourceUrl` string
        - `blobSha` string
      - `label` string, nullable, required
      - `createdBy` string, uuid, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required

## Other responses

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

---

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