---
title: "Create Metric"
method: POST
path: "/agents/metrics"
tags: ["Agents"]
---

# Create Metric

`POST /agents/metrics`

Create a new metric.

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Request body

- CreateMetricRequest
  - `name` string, required — The name of the metric. This must be a unique name that only allows lower case letters, numbers, and the characters _, -, and .
  - `display_name` string, nullable — The display name of the metric.
  - `prompt` string, required — The prompt associated with the metric, detailing the task and evaluation criteria.

## Response `200`

- Metric
  - `id` string, required — The unique identifier for the metric.
  - `name` string, required — The name of the metric. This is a unique name that you can use to identify the metric in the CLI.
  - `display_name` string, nullable — The display name of the metric, if available. This is the name that is displayed in the Playground.
  - `prompt` string, required — The prompt associated with the metric, detailing the task and evaluation criteria.
  - `created_at` string, date-time, required — The timestamp when the metric was created.

---

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