Skip to main content
POST
/
metrics
/
create
Create a new metric
curl --request POST \
  --url https://backend.claros.health/metrics/create/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "calculation_formula": [
    "<string>"
  ],
  "description": "<string>",
  "unit": "<string>",
  "filter_variable_id": 123,
  "low_quality_threshold": 123,
  "high_quality_threshold": 123,
  "is_ascending": true
}
'
{
  "id": 123,
  "name": "<string>",
  "calculation_formula": [
    "<string>"
  ],
  "patient_values_count": 123,
  "description": "<string>",
  "unit": "<string>",
  "filter_variable_id": 123,
  "low_quality_threshold": 123,
  "high_quality_threshold": 123,
  "is_ascending": true
}
This endpoint requires authentication. Include your API key in the request headers as X-API-Key.
This endpoint creates a new metric in the system.

​
Request Body

​
name
string
required
Name of the metric
​
description
string
Description of what the metric measures
​
unit
string
Unit of measurement for the metric
​
calculation_formula
array
required
Array of strings representing the formula used to calculate the metric
​
filter_variable_id
integer
ID of the variable used to filter patients for this metric
​
low_quality_threshold
number
The threshold below which quality is considered low
​
high_quality_threshold
number
The threshold above which quality is considered high
​
is_ascending
boolean
Whether higher values indicate better quality

​
Example Request

{
  "name": "Blood Pressure Control",
  "description": "Percentage of patients with controlled blood pressure",
  "unit": "%",
  "calculation_formula": [
    "count(patients where bp < 140/90) / count(patients) * 100"
  ],
  "filter_variable_id": 1,
  "low_quality_threshold": 50.0,
  "high_quality_threshold": 85.0,
  "is_ascending": true
}

​
Response Fields

​
id
integer
required
Unique identifier of the created metric
​
name
string
required
Name of the metric
​
description
string
Description of what the metric measures
​
unit
string
Unit of measurement for the metric
​
calculation_formula
array
required
Array of strings representing the formula used to calculate the metric
​
filter_variable_id
integer
ID of the variable used to filter patients for this metric
​
low_quality_threshold
number
The threshold below which quality is considered low
​
high_quality_threshold
number
The threshold above which quality is considered high
​
is_ascending
boolean
Whether higher values indicate better quality

​
Example Response

{
  "id": 1,
  "name": "Blood Pressure Control",
  "description": "Percentage of patients with controlled blood pressure",
  "unit": "%",
  "calculation_formula": [
    "count(patients where bp < 140/90) / count(patients) * 100"
  ],
  "filter_variable_id": 1,
  "low_quality_threshold": 50.0,
  "high_quality_threshold": 85.0,
  "is_ascending": true
}

​
Error Responses

​
400
object
Invalid request data. Check the request body format and required fields.
​
401
object
Authentication failed. Invalid or missing API key.

Body

application/json
​
name
string
required

Name of the metric

​
calculation_formula
string[]
required

Array of strings representing the formula used to calculate the metric

​
description
string

Description of what the metric measures

​
unit
string

Unit of measurement for the metric

​
filter_variable_id
integer

ID of the variable used to filter patients for this metric

​
low_quality_threshold
number

The threshold below which quality is considered low

​
high_quality_threshold
number

The threshold above which quality is considered high

​
is_ascending
boolean

Whether higher values indicate better quality

Response

Metric created successfully

​
id
integer
required

Unique identifier of the metric

​
name
string
required

Name of the metric

​
calculation_formula
string[]
required

Array of strings representing the formula used to calculate the metric

​
patient_values_count
integer
required

Number of patients with values for this metric

​
description
string

Description of what the metric measures

​
unit
string

Unit of measurement for the metric

​
filter_variable_id
integer

ID of the variable used to filter patients for this metric

​
low_quality_threshold
number

The threshold below which quality is considered low

​
high_quality_threshold
number

The threshold above which quality is considered high

​
is_ascending
boolean

Whether higher values indicate better quality