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

# Delete Pitch Sessions

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

Delete complete pitch sessions or selected pitches 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

- PitchSessionsDeleteRequest — Delete whole sessions or individual pitches, but never both at once.
  - `gameIds` string[], nullable — Delete complete pitch sessions by gameId.
  - `pitches` PitchDeleteTarget[], nullable — Delete individual pitches within their sessions.
    - `gameId` string, required — gameId returned by the pitch-session POST or GET endpoint.
    - `sourcePitchId` string, nullable — Stable physical-pitch identifier supplied by Pitchbio.
    - `eventId` string, nullable — Preciser eventId returned by the pitch-session GET endpoint.

## Response `200`

Successful Response

- union
  - TrackingSessionsDeleteResponse
    - `success` boolean, required
    - `sessionsDeleted` integer, required
    - `gameIds` string[], required
  - PitchDeleteResponse
    - `success` boolean, required
    - `pitchesDeleted` integer, required
    - `pitches` PitchDeleteItem[], required
      - `gameId` string, required
      - `sourcePitchId` 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/pitch-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)