---
title: "Delete Bat Sessions"
method: DELETE
path: "/api/v1/baseball/bat-sessions"
tags: ["Baseball Bat Sessions"]
---

# Delete Bat Sessions

`DELETE /api/v1/baseball/bat-sessions`

Delete complete bat sessions or selected swings within a session.

## Headers

- `x-api-key` string, required — Required API key issued by Preciser.
- `League` string, required — Required tenant/database selector, for example pitchbio-master.

## Request body

- BatSessionsDeleteRequest — Delete whole sessions or individual swings, but never both at once.
  - `gameIds` string[], nullable — Delete complete bat sessions by gameId.
  - `swings` SwingDeleteTarget[], nullable — Delete individual swings within their sessions.
    - `gameId` string, required — gameId returned by the bat-session POST or GET endpoint.
    - `sourceSwingId` string, nullable — Stable physical-swing identifier supplied by Pitchbio.
    - `eventId` string, nullable — Preciser eventId returned by the bat-session GET endpoint.

## Response `200`

Successful Response

- union
  - TrackingSessionsDeleteResponse
    - `success` boolean, required
    - `sessionsDeleted` integer, required
    - `gameIds` string[], required
  - SwingDeleteResponse
    - `success` boolean, required
    - `swingsDeleted` integer, required
    - `swings` SwingDeleteItem[], required
      - `gameId` string, required
      - `sourceSwingId` string, nullable
      - `eventId` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `24ef9111adac` — 4 breaking, 4 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `gameIds` from the response with the `200` status
  - removed the required property `sessionsDeleted` from the response with the `200` status
  - removed the required property `success` from the response with the `200` status
  - …4 more
- **2026-08-27** `9b0abde08b06` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/baseball/bat-sessions/delete.md)

---

[API](https://skmtc.dev/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.dev/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/revisions/24ef9111adac/schema)