v1

latestOpenAPI 3.1.02026-08-0410576180.0 KB
Biomech

Ingest Sessions

Ingest biomech sessions, pitches, and frames.

Idempotency: pitch_uuid is derived server-side from uuid5(NAMESPACE_DNS, "{player_id}:{session_id}:{source_pitch_id}:{pitch_index}"). Callers MUST send the same source_pitch_id + pitch_index for the same physical pitch on every retry; otherwise a retry inserts a new pitch row instead of updating the existing one. pitch_index should be unique within a session.

post/api/v1/biomech/sessions

Headers

x-api-keystring nullable
Leaguestring nullable

Request body

Response

Successful Response

successboolean required
sessions_upsertedinteger required
pitches_upsertedinteger required
frames_upsertedinteger required