Delete a session

DELETE /v2/live/{id}

Deletes a session that has ended, its transcript and its recording.

Authentication: your API key in the x-gladia-key header (Authentication).

Example

curl -X DELETE https://eu1.api.gladia.io/v2/live/0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b \
  -H "x-gladia-key: $GLADIA_API_KEY"

import os

from gladiaio_sdk import GladiaClient

client = GladiaClient(
    api_key=os.environ["GLADIA_API_KEY"],
    api_url=os.environ.get("GLADIA_API_URL", "https://eu1.api.gladia.io"),
)

client.live_v2().delete("0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b")
print("deleted")

import { GladiaClient } from "@gladiaio/sdk";

const client = new GladiaClient({
  apiKey: process.env.GLADIA_API_KEY,
  apiUrl: process.env.GLADIA_API_URL ?? "https://eu1.api.gladia.io",
});

await client.liveV2().delete("0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b");
console.log("deleted");

Try it

API address API key (kept in this tab only) id (path, required)

Parameters

id string · path required

Identifier of the session (id of POST /v2/live).

Responses

202 Deleted.

401 No API key, or an unknown one.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}

403 The session is still running.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}

404 No such session for your account.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}

503 The service cannot answer right now: try again.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}