Sign in
Biomech

Ingest Sessions

Ingest biomech sessions, pitches, and frames.

Idempotency: when source_pitch_id is present, pitch_uuid is derived from the player, session, and source_pitch_id only; pitch_index is a display sequence. The default sync_mode=snapshot removes pitches/frames omitted from a re-upload.

post/api/v1/biomech/sessions

Headers

x-api-keystring required

Required API key issued by Preciser.

Required API key issued by Preciser.

Leaguestring required

Required tenant/database selector, for example pitchbio-master.

Required tenant/database selector, for example pitchbio-master.

Request body

sync_mode'snapshot' | 'upsert'

snapshot treats every submitted session as complete and removes omitted pitches/frames. upsert keeps omitted rows.

Response

Successful Response

successboolean required
sessions_upsertedinteger required
pitches_upsertedinteger required
frames_upsertedinteger required

Changes