---
title: "Optimize Metric Prompt"
method: POST
path: "/v1/optimize/metric-prompt"
tags: ["Optimize"]
---

# Optimize Metric Prompt

`POST /v1/optimize/metric-prompt`

Accept a custom metric prompt and return an optimized version using an LLM.
The optimized prompt is clearer, more precise, and easier for evaluators to apply consistently.

## Headers

- `X-API-Key` string, required

## Request body

- OptimizeMetricPromptRequest — Request body for optimizing a metric prompt (no evaluation diffs).
  - `name` string, required — The name of the custom metric to optimize.
  - `prompt` string, required — The current evaluation system prompt to optimize.
  - `additional_instructions` string, nullable — Additional instructions for the optimization.

## Response `200`

Successful Response

- OptimizeMetricPromptResponse — Response containing the optimized prompt.
  - `optimized_prompt` string, required — The optimized version of the custom metric prompt.

## 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)