---
title: "Changes to Create custom metric definition"
method: POST
path: "/v1/metric/definitions"
---

# Changes to Create custom metric definition

`POST /v1/metric/definitions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 105 revisions.

- **2026-08-28** `1d61b68e9429` — 3 info
- **2026-08-17** `887b091b3d81` — 10 breaking, 26 warning, 3 info

## Changes

- **2026-08-28** `1d61b68e9429` — 3 info
  - the request property `oneOf[subschema #1: LLM judge metric]/analysisPackageId` became optional
  - the request property `oneOf[subschema #2: Formula metric]/analysisPackageId` became optional
  - the request property `oneOf[subschema #3: Pattern metric]/analysisPackageId` became optional
- **2026-08-17** `887b091b3d81` — 10 breaking, 26 warning, 3 info
  - the request's body type/format changed from `object`/`` to ``/``
  - added `#/components/schemas/LlmJudgeMetricResponse, #/components/schemas/FormulaMetricResponse, #/components/schemas/PatternMetricResponse` to the `data` response property `oneOf` list for the response status `201`
  - the `data` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - removed the required property `data/description` from the response with the `201` status
  - removed the required property `data/id` from the response with the `201` status
  - removed the required property `data/metricId` from the response with the `201` status
  - removed the required property `data/name` from the response with the `201` status
  - removed the required property `data/scope` from the response with the `201` status
  - removed the required property `data/supportedContexts` from the response with the `201` status
  - removed the required property `data/type` from the response with the `201` status
  - removed the request property `analysisPackageId`
  - removed the request property `booleanFalseLabel`
  - removed the request property `booleanTrueLabel`
  - removed the request property `classificationOptions`
  - removed the request property `llmPrompt`
  - removed the request property `maxClassifications`
  - removed the request property `metricId`
  - removed the request property `name`
  - removed the request property `outputType`
  - removed the request property `participantRole`
  - removed the request property `scaleLabels`
  - removed the request property `scaleMax`
  - removed the request property `scaleMin`
  - removed the request property `scope`
  - removed the request property `supportedContexts`
  - removed the optional property `data/unit` from the response with the `201` status
  - added the new `conflict` enum value to the `type` response property for the response status `400`
  - added the new `conflict` enum value to the `type` response property for the response status `401`
  - added the new `conflict` enum value to the `type` response property for the response status `403`
  - added the new `conflict` enum value to the `type` response property for the response status `429`
  - added the new `conflict` enum value to the `type` response property for the response status `500`
  - added the new `payment_required` enum value to the `type` response property for the response status `400`
  - added the new `payment_required` enum value to the `type` response property for the response status `401`
  - added the new `payment_required` enum value to the `type` response property for the response status `403`
  - added the new `payment_required` enum value to the `type` response property for the response status `429`
  - added the new `payment_required` enum value to the `type` response property for the response status `500`
  - added request discriminator
  - added `#/components/schemas/PromptMetricInput, #/components/schemas/FormulaMetricInput, #/components/schemas/PatternMetricInput` to the request body `oneOf` list
  - added discriminator to `data` response property for the response status `201`

---

[Operation](https://skmtc.dev/roarkhq/apis/roark-analytics-api/docs/v1/metric/definitions/post.md) · [API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) · [Page](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/metric/definitions/post)