POST
/
test_framework
/
v1
/
metrics
/
cURL
curl --request POST \
  --url https://api.cekura.ai/test_framework/v1/metrics/ \
  --header 'Content-Type: application/json' \
  --header 'X-CEKURA-API-KEY: <api-key>' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "audio_enabled": true,
  "prompt": "<string>",
  "agent": 123,
  "assistant_id": "<string>",
  "type": "<string>",
  "eval_type": "<string>",
  "enum_values": {},
  "display_order": 123
}'
{
  "id": 123,
  "agent": 123,
  "name": "<string>",
  "description": "<string>",
  "type": "basic",
  "eval_type": "binary_workflow_adherence",
  "enum_values": "<any>",
  "audio_enabled": true,
  "prompt": "<string>",
  "evaluation_trigger": "always",
  "evaluation_trigger_prompt": "<string>",
  "priority_assignment_prompt": "<string>",
  "configuration": "<any>",
  "display_order": -1,
  "overall_score": "<string>",
  "total_score": "<string>",
  "knowledge_base_files": "<string>",
  "observability_enabled": true,
  "simulation_enabled": true,
  "alert_enabled": true,
  "function_name": "<string>",
  "custom_code": "<string>",
  "vocera_defined_metric_code": "<string>",
  "reviews": "<string>"
}

Authorizations

​
X-CEKURA-API-KEY
string
header
required

API Key Authentication. It should be included in the header of each request.

Body

​
name
string
required

Name of the metric

​
description
string
required

Description of what this metric evaluates

​
audio_enabled
boolean
required

Whether this metric evaluates audio content

​
prompt
string
required

The evaluation prompt used for this metric

​
assistant_id
string
required

External identifier for the assistant

​
type
string
required

Type of metric (e.g., basic, custom_prompt, custom_code)

​
eval_type
string
required

Type of evaluation (e.g., boolean, enum, score)

​
enum_values
object
required

Possible values for enum-type metrics

​
display_order
integer
required

Order in which to display this metric in the UI

​
agent
integer

The AI agent this metric is associated with

Response

​
id
integer
required
​
agent
integer
required
​
name
string
required
Maximum length: 255
​
overall_score
string
required

The overall score for this metric across all test sets

​
total_score
string
required

The total score for this metric

​
knowledge_base_files
string
required

Knowledge base files associated with this metric

​
reviews
string
required

Reviews associated with the metric

​
description
string
​
type
enum<string>
  • basic - Basic
  • custom_prompt - Custom Prompt
  • custom_code - Custom Code
Available options:
basic,
custom_prompt,
custom_code
​
eval_type
enum<string>
  • binary_workflow_adherence - Binary Workflow Adherence
  • binary_qualitative - Binary Qualitative
  • continuous_qualitative - Continuous Qualitative
  • numeric - Numeric
  • enum - Enum
Available options:
binary_workflow_adherence,
binary_qualitative,
continuous_qualitative,
numeric,
enum
​
enum_values
any
​
audio_enabled
boolean
​
prompt
string
​
evaluation_trigger
enum<string>
  • always - Always
  • automatic - Automatic
  • custom - Custom
Available options:
always,
automatic,
custom
​
evaluation_trigger_prompt
string
​
priority_assignment_prompt
string
​
configuration
any

Custom configuration parameters for specific metrics

​
display_order
integer
Required range: -2147483648 <= x <= 2147483647
​
observability_enabled
boolean

Enable this metric for observability

​
simulation_enabled
boolean

Enable this metric for simulations

​
alert_enabled
boolean

Enable alerts for this metric when it fails

​
function_name
string | null
Maximum length: 255
​
custom_code
string
​
vocera_defined_metric_code
string
Maximum length: 255