Baseball Pitch Sessions

Ingest Pitch Sessions

Changed on

Create or update baseball pitch sessions.

Send one or more pitcher sessions with pitch-level tracking measurements. Stable source identifiers make retries idempotent: a sourceSessionId keeps the gameId assigned by its first upload. The returned gameId can be used with schedule and game detail APIs.

post/api/v1/baseball/pitch-sessions

Request

  • Base URL
    https://developer.preciser.io
  • URL
    https://developer.preciser.io/api/v1/baseball/pitch-sessions
  • Auth
    none declared. Required headers: x-api-key, League

Headers

x-api-keystring required

Required API key issued by Preciser.

Leaguestring required

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

  • 9b0abde08b06Revision changes
    • breaking

      the header request parameter League became required

    • breaking

      the header request parameter x-api-key became required

    • breaking

      header request parameter League list-of-types was narrowed by removing types null

    • breaking

      header request parameter x-api-key list-of-types was narrowed by removing types null

    • info

      added the new optional request property ////

    • info

      added the new optional request property ////

    • info

      added the new optional request property

    • info

      for the header request parameter League, the type was generalized from no type to string

    • info

      for the header request parameter x-api-key, the type was generalized from no type to string

    • info

      the request property became optional

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      the request property's minLength was decreased from 1 to 0