Skip to main content
POST
/
v2
/
projects
/
{project_id}
/
metrics-testing
/
{run_id}
/
health-score
Compute Health Score Endpoint
curl --request POST \
  --url https://api.galileo.ai/v2/projects/{project_id}/metrics-testing/{run_id}/health-score \
  --header 'Content-Type: application/json' \
  --header 'Galileo-API-Key: <api-key>' \
  --data '
{
  "scorer_id": "<string>",
  "output_type": "boolean",
  "scoreable_node_types": [
    "llm"
  ],
  "mgt_overlay": {}
}
'
{
  "health_score_type": "macro_f1",
  "value": 123,
  "skipped_rows": 123,
  "secondary": {},
  "total_scored_rows": 123,
  "total_mgt_rows": 123,
  "joined_rows": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.galileo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Galileo-API-Key
string
header
required

Path Parameters

​
project_id
string<uuid4>
required
​
run_id
string<uuid4>
required

Body

application/json
​
scorer_id
string<uuid4>
required
​
output_type
enum<string>
required

The scorer's output type, used to dispatch the correct metric.

Available options:
boolean,
categorical,
count,
discrete,
freeform,
percentage,
multilabel,
retrieved_chunk_list_boolean,
boolean_multilabel
​
scoreable_node_types
enum<string>[]

The scorer's scoreable_node_types. Determines which record type carries the score.

Available options:
llm,
retriever,
tool,
workflow,
agent,
control,
trace,
session
​
mgt_overlay
Mgt Overlay · object

Client-side pending MGT edits: {row_id: value}. Overrides committed dataset values.

Response

Successful Response

​
health_score_type
enum<string> | null
required
Available options:
macro_f1,
micro_f1,
mse,
mae
​
value
number | null
required

Primary health score metric value, or None if no valid rows.

​
skipped_rows
integer
required

Rows excluded because MGT or score could not be parsed.

​
secondary
Secondary · object
required

Secondary metrics (MAE, RMSE, R², per-class F1, etc.).

​
total_scored_rows
integer
required

Rows with a successful scorer result.

​
total_mgt_rows
integer
required

Rows with a non-null MGT value after overlay.

​
joined_rows
integer
required

Rows with both a score and a MGT value (used for computation).