---
title: "POST /v1/evaluators/score"
method: POST
path: "/v1/evaluators/score"
tags: ["api::evaluators"]
---

# POST /v1/evaluators/score

`POST /v1/evaluators/score`

## Request body

- union
  - CreateEvaluatorScoreRequestWithTraceId
    - `name` string, required — Name of the evaluator score
    - `score` number, required — The score value (float)
    - `source` 'Code' | 'Evaluator', required — Source of the score
    - `metadata` object, nullable — Additional metadata for the score
    - `traceId` string, uuid, required — The trace ID to score (will be attached to root span)
  - CreateEvaluatorScoreRequestWithSpanId
    - `name` string, required — Name of the evaluator score
    - `score` number, required — The score value (float)
    - `source` 'Code' | 'Evaluator', required — Source of the score
    - `metadata` object, nullable — Additional metadata for the score
    - `spanId` string, uuid, required — The span ID to score

## Response `200`

Evaluator score created successfully

## Other responses

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

---

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