Sign in
Baseball Pitch Sessions

Ingest Pitch Sessions

Create or update baseball pitch sessions.

Send one or more pitcher sessions with pitch-level tracking measurements. Stable source identifiers make retries idempotent. The returned gameId can be used with schedule and game detail APIs.

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

velocityUnit'kph' | 'mph'

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

syncMode'snapshot' | 'upsert'

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

maxExitVelocitynumber nullable

Ignore exit velocity values above this source-unit threshold. Set null to keep all values.

Response

Successful Response

successboolean required
warningsstring[]

Changes