Metrics
POST
/api/v1/metrics/{metric_id}/children/from-discovered

Promote an LLM-discovered candidate label into a real child metric.

Mirrors add_metric_child but:

  • Works on any parent (single_choice OR multi_label) that has allow_discovery=true.
  • The new child's name is normalized so that slug(name) equals the supplied key. This is critical — without it, the already-scored rows' sequence arrays would not resolve against the promoted child once the candidate disappears from discovered_labels.

Authorization

AuthorizationBearer <token>

JWT access token. Use: Authorization: Bearer .

In: header

Path Parameters

metric_id*Metric Id
Formatuuid

Header Parameters

X-Workspace-Id?string|null
Authorization?string|null
X-API-Key?string|null
X-EFFICIENTAI-API-KEY?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Body for POST /metrics/{parent_id}/children/from-discovered.

key is the slug under which the candidate is currently stored on per-row metric_scores. The newly-created child Metric's name is normalized so slugify(name) == key, which keeps every already-scored row's sequence array resolvable against the promoted child without a backfill.

Response Body

application/json

application/json

curl -X POST "https://example.com/api/v1/metrics/497f6eca-6276-4993-bfeb-53cbbbba6f08/children/from-discovered" \  -H "Content-Type: application/json" \  -d '{    "key": "string",    "name": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",  "scope": "workspace",  "name": "string",  "description": "string",  "example": "string",  "metric_type": "number",  "metric_category": "quality",  "trigger": "always",  "enabled": true,  "is_default": true,  "metric_origin": "string",  "supported_surfaces": [    "string"  ],  "enabled_surfaces": [    "string"  ],  "custom_data_type": "string",  "custom_config": {},  "tags": [    "string"  ],  "capture_rationale": false,  "parent_metric_id": "a4a6359f-6ade-48cb-af32-ccbc80976b98",  "selection_mode": "single_choice",  "allow_discovery": false,  "compare_transcripts": false,  "lifecycle": "active",  "promoted_from_draft_at": "2019-08-24T14:15:22Z",  "studio_notes": "string",  "children": [    {}  ],  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "created_by": "string"}

Community & contact

  1. Found a bug or have a feature request? Open a GitHub issue.
  2. Join our Discord for faster replies!