Sign in
Baseball Bat Sessions

Ingest Bat Sessions

Create or update baseball batting sessions.

Send one or more hitter sessions with swing-level bat-tracking measurements. Stable source identifiers make retries idempotent. Set dryRun to validate and preview the import without database writes.

post/api/v1/baseball/bat-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

seasonstring nullable

Optional season label. When omitted, each session uses the year from scheduledAt or sessionDate, so one request may span calendar years.

seasonTypestring

Season type.

gameTierstring

Competition tier.

venuestring

Venue or source label.

speedUnit'kph' | 'mph'

Input unit used by batSpeed and exitVelocity. Defaults to kph, meaning kilometres per hour (km/h). Preciser tracking responses are also returned in km/h.

distanceUnit'm' | 'ft'

Unit used by hitDistance. Values are stored as feet.

syncMode'snapshot' | 'upsert'

snapshot treats every submitted session as its complete current state and removes previously stored swings that are omitted. upsert keeps omitted swings.

dryRunboolean

Validate and prepare the import without writing to the database.

Response

Successful Response

successboolean required
dryRunboolean required
warningsstring[]

Changes