---
title: "Batch Create"
method: POST
path: "/v1/batch-metrics"
tags: ["Legacy"]
---

# Batch Create

`POST /v1/batch-metrics`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/batch-metrics`
- Auth: none declared
- TypeScript: <https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/docs/v1/batch-metrics/post.ts> (a function with typed inputs; its response is checked against the schema)

Deprecated. Use `POST /v1/metrics/batch` instead. Creates a batch of new metrics on your Confident AI project.

## Request body

- CreateBatchMetrics
  - `metrics` Metric[], required: This is the list of metrics you want to add to your project.
    - `id` string, required: This is the unique id of the metric.
    - `name` string, required: This is the name of the metric, it's unique to all metrics.
    - `criteria` string, nullable: This is the criteria this metric uses to evaluate test cases.
    - `evaluationSteps` string[], nullable: An alternative to criteria — a list of steps used to evaluate test cases.
    - `requiredParameters` union, required: The parameters required by this metric for evaluation.
      - string[]
      - string[]
    - `multiTurn` boolean, required: This is true if the metric is used to evaluate multi-turn test cases.
    - `rubric` Rubric[], nullable: A list of score ranges (0–10 inclusive). Must be in order and non-overlapping. Click here to [learn more](https://deepeval.com/docs/metrics-llm-evals#rubric)
      - `scoreRange` number[], required: An array consisting of the ranges of scores to generate.
      - `expectedOutcome` string, required: The expected outcome for your evaluation.

## Response `200`

- CreateBatchMetricsResponse
  - `success` boolean, required: This is true if the metrics were created successfully.
  - `data` object, required: This maps to the ids of the metrics created.
    - `ids` string[], required: The ids of the batch metrics created.
  - `deprecated` boolean, required: This is true if this batch metrics endpoint is deprecated.

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-05-31** `173563ada468`: 2 info
  - api tag `Legacy` added
  - api tag `Metrics` removed
- **2026-05-25** `f30ed420e20f`: 3 breaking, 1 warning, 3 info
  - added the new required request property `metrics/items/requiredParameters`
  - the request property `metrics/items/id` became required
  - the `metrics/items/evaluationSteps` request property type changed from `string` to `array`
  - removed the request property `metrics/items/evaluationParams`
  - …3 more

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/batch-metrics/post.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)