Tests

tests

---

POST /api/v1/tests/

Create Test

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
refreshed-token	header			No
token	cookie	string		No

Request body

application/json

{
    "title": null,
    "sport": "string",
    "start": "2022-04-13T15:42:05.901Z",
    "end": null,
    "results": null,
    "tags": [
        "string"
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body

{
    "properties": {
        "title": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Title"
        },
        "sport": {
            "type": "string",
            "description": "Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')"
        },
        "start": {
            "type": "string",
            "format": "date-time",
            "title": "Start",
            "description": "Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips."
        },
        "end": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "End",
            "description": "Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips."
        },
        "results": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/TestResults"
                },
                {
                    "type": "null"
                }
            ]
        },
        "tags": {
            "items": {
                "type": "string"
            },
            "type": "array",
            "title": "Tags"
        }
    },
    "type": "object",
    "required": [
        "sport",
        "start"
    ],
    "title": "TestCreate"
}

Responses

200 OK422 Unprocessable Content

application/json

{
    "tags": [
        "string"
    ],
    "id": "string",
    "created_by": null,
    "title": null,
    "sport": "string",
    "start": "2022-04-13T15:42:05.901Z",
    "end": null,
    "results": null,
    "app_metadata": null,
    "start_local": "2022-04-13T15:42:05.901Z",
    "end_local": null
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "tags": {
            "items": {
                "type": "string"
            },
            "type": "array",
            "title": "Tags"
        },
        "id": {
            "type": "string",
            "title": "Id"
        },
        "created_by": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Created By"
        },
        "title": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Title"
        },
        "sport": {
            "type": "string",
            "description": "Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')"
        },
        "start": {
            "type": "string",
            "format": "date-time",
            "title": "Start",
            "description": "Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field."
        },
        "end": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "End",
            "description": "Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field."
        },
        "results": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/TestResults"
                },
                {
                    "type": "null"
                }
            ]
        },
        "app_metadata": {
            "anyOf": [
                {
                    "additionalProperties": true,
                    "type": "object"
                },
                {
                    "type": "null"
                }
            ],
            "title": "App Metadata"
        },
        "start_local": {
            "type": "string",
            "format": "date-time",
            "title": "Start Local",
            "description": "Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.",
            "readOnly": true
        },
        "end_local": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "End Local",
            "description": "Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.",
            "readOnly": true
        }
    },
    "type": "object",
    "required": [
        "id",
        "sport",
        "start",
        "start_local",
        "end_local"
    ],
    "title": "TestSummary"
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

GET /api/v1/tests/

List Tests

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
created_by	query			No
end	query			No
limit	query	integer	50	No
offset	query	integer	0	No
refreshed-token	header			No
sport	query	array		No
start	query			No
tags	query	array		No
token	cookie	string		No

Responses

200 OK422 Unprocessable Content

application/json

[
    {
        "tags": [
            "string"
        ],
        "id": "string",
        "created_by": null,
        "title": null,
        "sport": "string",
        "start": "2022-04-13T15:42:05.901Z",
        "end": null,
        "results": null,
        "app_metadata": null,
        "start_local": "2022-04-13T15:42:05.901Z",
        "end_local": null
    }
]

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "type": "array",
    "items": {
        "$ref": "#/components/schemas/TestSummary"
    },
    "title": "Response List Tests Api V1 Tests  Get"
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

GET /api/v1/tests/{test_id}

Get Test

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
refreshed-token	header			No
test_id	path	string		No
token	cookie	string		No
traces	query		auto	No	How traces are matched to this test. `auto` (default): traces whose timestamp falls in the test's time range, plus any traces explicitly linked to this test, minus any traces explicitly linked to a different test. `linked`: only traces explicitly linked to this test via `test_id`, regardless of timestamp. Affects only the `traces` list; `activities` is always time-overlap matched.

Responses

200 OK422 Unprocessable Content

application/json

{
    "tags": [
        "string"
    ],
    "id": "string",
    "created_by": null,
    "title": null,
    "sport": "string",
    "start": "2022-04-13T15:42:05.901Z",
    "end": null,
    "results": null,
    "app_metadata": null,
    "traces": null,
    "activities": null,
    "start_local": "2022-04-13T15:42:05.901Z",
    "end_local": null
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "tags": {
            "items": {
                "type": "string"
            },
            "type": "array",
            "title": "Tags"
        },
        "id": {
            "type": "string",
            "title": "Id"
        },
        "created_by": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Created By"
        },
        "title": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Title"
        },
        "sport": {
            "type": "string",
            "description": "Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')"
        },
        "start": {
            "type": "string",
            "format": "date-time",
            "title": "Start",
            "description": "Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field."
        },
        "end": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "End",
            "description": "Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field."
        },
        "results": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/TestResults"
                },
                {
                    "type": "null"
                }
            ]
        },
        "app_metadata": {
            "anyOf": [
                {
                    "additionalProperties": true,
                    "type": "object"
                },
                {
                    "type": "null"
                }
            ],
            "title": "App Metadata"
        },
        "traces": {
            "anyOf": [
                {
                    "items": {
                        "$ref": "#/components/schemas/TraceDetails"
                    },
                    "type": "array"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Traces"
        },
        "activities": {
            "anyOf": [
                {
                    "items": {
                        "$ref": "#/components/schemas/ActivitySummary"
                    },
                    "type": "array"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Activities"
        },
        "start_local": {
            "type": "string",
            "format": "date-time",
            "title": "Start Local",
            "description": "Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.",
            "readOnly": true
        },
        "end_local": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "End Local",
            "description": "Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.",
            "readOnly": true
        }
    },
    "type": "object",
    "required": [
        "id",
        "sport",
        "start",
        "start_local",
        "end_local"
    ],
    "title": "TestDetails"
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

PUT /api/v1/tests/{test_id}

Update Test

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
refreshed-token	header			No
test_id	path	string		No
token	cookie	string		No

Request body

application/json

{
    "title": null,
    "sport": "string",
    "start": "2022-04-13T15:42:05.901Z",
    "end": null,
    "results": null,
    "tags": [
        "string"
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the request body

{
    "properties": {
        "title": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Title"
        },
        "sport": {
            "type": "string",
            "description": "Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')"
        },
        "start": {
            "type": "string",
            "format": "date-time",
            "title": "Start",
            "description": "Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips."
        },
        "end": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "End",
            "description": "Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips."
        },
        "results": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/TestResults"
                },
                {
                    "type": "null"
                }
            ]
        },
        "tags": {
            "items": {
                "type": "string"
            },
            "type": "array",
            "title": "Tags"
        }
    },
    "type": "object",
    "required": [
        "sport",
        "start"
    ],
    "title": "TestUpdate",
    "description": "PUT semantics: full replace. Omitted optional fields are set to null."
}

Responses

200 OK422 Unprocessable Content

application/json

Schema of the response body

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

DELETE /api/v1/tests/{test_id}

Delete Test

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
refreshed-token	header			No
test_id	path	string		No
token	cookie	string		No

Responses

200 OK422 Unprocessable Content

application/json

Schema of the response body

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

PUT /api/v1/tests/{test_id}/app-metadata

Put Test Metadata

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
refreshed-token	header			No
test_id	path	string		No
token	cookie	string		No

Request body

application/json

Schema of the request body

{
    "type": "object",
    "additionalProperties": true,
    "title": "Data"
}

Responses

200 OK422 Unprocessable Content

application/json

Schema of the response body

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

DELETE /api/v1/tests/{test_id}/app-metadata

Delete Test Metadata

Input parameters

Parameter	In	Type	Default	Nullable	Description
HTTPBearer	header	string	N/A	No	JWT Bearer token
refreshed-token	header			No
test_id	path	string		No
token	cookie	string		No

Responses

204 No Content422 Unprocessable Content

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string"
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

---

Schemas

ActivitySummary

Name	Type	Description
app_metadata
duration	string(duration)
end	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
end_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
id	string
laps
metrics	Array<Metric>
source_id	string
sport	string	Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')
start	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
start_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
summary
tags	Array<string>
traces

ActivitySummarySummary

Name	Type	Description
altitude
cadence
core_temperature
distance
heart_rate
power
smo2
speed
temperature

AltitudeSummary

Name	Type	Description
gain
loss
max
mean
min

CadenceSummary

Name	Type	Description
max
mean

CoreTemperatureSummary

Name	Type	Description
end
max
mean
min
start

DistanceSummary

Name	Type	Description
sum

HeartRateSummary

Name	Type	Description
end
max
mean
min
start

HTTPValidationError

Name	Type	Description
detail	Array<ValidationError>

Lap

Name	Type	Description
altitude
cadence
core_temperature
distance
duration	string(duration)
end	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
end_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
heart_rate
power
smo2
speed
start	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
start_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
temperature

Marker

Name	Type	Description
heart_rate
lactate
power
speed
vo2

Metric

Type: string

PowerSummary

Name	Type	Description
max
mean

Smo2Summary

Name	Type	Description
end
max
mean
min
start

SpeedSummary

Name	Type	Description
max
mean

TemperatureSummary

Name	Type	Description
end
max
mean
min
start

TestCreate

Name	Type	Description
end		Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips.
results
sport	string	Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')
start	string(date-time)	Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips.
tags	Array<string>
title

TestDetails

Name	Type	Description
activities
app_metadata
created_by
end		Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
end_local		Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
id	string
results
sport	string	Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')
start	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
start_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
tags	Array<string>
title
traces

TestResults

Name	Type	Description
critical_power
critical_speed
d_prime
economy
efficiency
fatmax
first_threshold
heart_rate_max
lt1
lt2
mlss
second_threshold
vlamax
vo2max
vo2peak
vt1
vt2
w_prime

TestSummary

Name	Type	Description
app_metadata
created_by
end		Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
end_local		Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
id	string
results
sport	string	Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')
start	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
start_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
tags	Array<string>
title

TestUpdate

Name	Type	Description
end		Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips.
results
sport	string	Sport string in OpenSportTaxonomy format (e.g., 'cycling.road+stationary')
start	string(date-time)	Offset-aware ISO 8601 (e.g. `2026-05-18T17:32:00+02:00` or `...Z`). A naive timestamp is rejected; the offset is stored so the local time round-trips.
tags	Array<string>
title

TraceDetails

Name	Type	Description
activity
app_metadata
heart_rate
id	string
lactate
lap
notes
power
rpe
speed
sport
tags	Array<string>
test
test_id
test_match
timestamp	string(date-time)	Absolute instant in UTC (ISO 8601 with `Z`, e.g. `2026-05-18T15:32:00Z`). Sort, compare and merge on this; for the local wall-clock use the matching `*_local` field.
timestamp_local	string(date-time)	Naive local wall-clock at the record's own place/time (ISO 8601 without an offset, e.g. `2026-05-18T17:32:00`). Use for display and for grouping by local calendar date.
vo2

TraceResolution

Type: string

ValidationError

Name	Type	Description
loc	Array<>
msg	string
type	string

Security schemes

Name	Type	Scheme	Description
HTTPBearer	http	bearer
HTTPBasic	http	basic