---
title: "POST /v1/evals"
method: POST
path: "/v1/evals"
tags: ["api::evaluations"]
---

# POST /v1/evals

`POST /v1/evals`

## Request body

- InitEvalRequest
  - `name` string — Name of the evaluation. If not specified, a random name will be generated.
  - `groupName` string, nullable — Group name for the evaluation. Defaults to 'default'.

## Response `200`

Evaluation created successfully

- InitEvalResponse
  - `id` string, uuid, required — The unique identifier of the evaluation
  - `name` string, required — The name of the evaluation
  - `projectId` string, uuid, required — The project ID this evaluation belongs to
  - `groupName` string, required — The group name of the evaluation
  - `createdAt` string, date-time — When the evaluation was created

## Other responses

- `400` — Bad request. Cannot parse the JSON payload into a valid request.
- `401` — Unauthorized. Project API key is invalid.

---

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