---
title: "Delete Sessions"
method: DELETE
path: "/api/v1/biomech/sessions"
tags: ["Biomech"]
---

# Delete Sessions

`DELETE /api/v1/biomech/sessions`

Delete complete biomech sessions or individual pitches and their frames.

## 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

- BiomechSessionsDeleteRequest — Delete whole sessions or individual pitches, but never both at once.
  - `session_ids` string[], nullable
  - `pitches` BiomechPitchDeleteTarget[], nullable
    - `session_id` string, required
    - `source_pitch_id` string, nullable
    - `pitch_uuid` string, nullable

## Response `200`

Successful Response

- union
  - BiomechSessionsDeleteResponse
    - `success` boolean, required
    - `sessions_deleted` integer, required
    - `session_ids` string[], required
  - BiomechPitchesDeleteResponse
    - `success` boolean, required
    - `pitches_deleted` integer, required
    - `pitches` BiomechPitchDeleteItem[], required
      - `session_id` string, required
      - `source_pitch_id` string, nullable
      - `pitch_uuid` 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 `session_ids` from the response with the `200` status
  - removed the required property `sessions_deleted` 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/biomech/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)