---
title: "Create Metric Revision"
method: POST
path: "/v1/metrics-lab/lab/{lab_id}/metric-revisions"
tags: ["Metrics Lab"]
---

# Create Metric Revision

`POST /v1/metrics-lab/lab/{lab_id}/metric-revisions`

Create a new metric revision for a lab. Revision number is auto-incremented by DB trigger.

## Path parameters

- `lab_id` string, uuid, required

## Headers

- `X-API-Key` string, required

## Request body

- CreateMetricRevisionRequest — Request model for creating a metric revision
  - `custom_metric_id` string, required — Custom metric ID (UUID as string)
  - `description` string, nullable — Description of the metric revision
  - `scoring_guidance` string, nullable — Scoring guidance for the metric revision
  - `eval_route` string, nullable — Evaluation route (e.g., 'AUDIO', 'TEXT', 'AUTO')
  - `model` string, nullable — Model to use for evaluation
  - `audio_model` string, nullable — Audio model to use for evaluation
  - `temperature` number, nullable — Temperature for evaluation (0-2)
  - `allow_not_applicable` boolean — Whether to allow 'not applicable' responses

## Response `200`

Successful Response

- MetricRevisionResponse — Response model for metric revision operations
  - `id` string, required — Revision ID (UUID as string)
  - `lab_id` string, required — Lab ID (UUID as string)
  - `custom_metric_id` string, required — Custom metric ID (UUID as string)
  - `revision_number` integer, required — Revision number (auto-incremented)
  - `description` string, nullable — Description of the metric revision
  - `scoring_guidance` string, nullable — Scoring guidance for the metric revision
  - `eval_route` string, nullable — Evaluation route
  - `model` string, nullable — Model to use for evaluation
  - `audio_model` string, nullable — Audio model to use for evaluation
  - `temperature` number, nullable — Temperature for evaluation
  - `allow_not_applicable` boolean, nullable — Whether to allow 'not applicable' responses
  - `created_at` string, date-time, required — When the revision was created

## Other responses

- `422` — Validation Error

---

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