End Translation Session

curl -X DELETE "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7" \
  -H "Authorization: YOUR_API_KEY"

import requests

response = requests.delete(
    "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    headers={"Authorization": "YOUR_API_KEY"},
)
print(response.json()["data"]["end_reason"])  # "api_terminated"

{
  "data": {
    "session_id": "9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    "status": "ENDED",
    "source_language": "en",
    "target_language": "es",
    "voice_id": null,
    "audio_protocol": "pcm16",
    "sample_rate": 16000,
    "max_duration_seconds": 1800,
    "end_reason": "api_terminated",
    "session_seconds": null,
    "billable_minutes": null,
    "created_at": "2026-06-04T18:05:07.885Z",
    "started_at": null,
    "ended_at": "2026-06-04T18:06:08.684Z"
  },
  "errors": null
}

DELETE

translation

sessions

{session_id}

curl -X DELETE "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7" \
  -H "Authorization: YOUR_API_KEY"

import requests

response = requests.delete(
    "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    headers={"Authorization": "YOUR_API_KEY"},
)
print(response.json()["data"]["end_reason"])  # "api_terminated"

{
  "data": {
    "session_id": "9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    "status": "ENDED",
    "source_language": "en",
    "target_language": "es",
    "voice_id": null,
    "audio_protocol": "pcm16",
    "sample_rate": 16000,
    "max_duration_seconds": 1800,
    "end_reason": "api_terminated",
    "session_seconds": null,
    "billable_minutes": null,
    "created_at": "2026-06-04T18:05:07.885Z",
    "started_at": null,
    "ended_at": "2026-06-04T18:06:08.684Z"
  },
  "errors": null
}

Ends a translation session. If the WebSocket is connected, it receives a final session_ended control message and is closed. Pending sessions (created but never connected) are also cleaned up — useful for releasing a concurrency slot you no longer need. Terminating an already-ended session is a no-op and returns the session’s final state.

Authentication

authorization

string

required

Your API key for authentication

Path Parameters

session_id

string

required

The session UUID returned by POST /v1/translation/sessions

Body Parameters

reason

string

Optional context (max 200 characters) recorded with the session’s end_reason as api_terminated:<reason>.

Response

Returns the same session object as Get Translation Session, with status and end_reason reflecting the termination.

curl -X DELETE "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7" \
  -H "Authorization: YOUR_API_KEY"

import requests

response = requests.delete(
    "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    headers={"Authorization": "YOUR_API_KEY"},
)
print(response.json()["data"]["end_reason"])  # "api_terminated"

{
  "data": {
    "session_id": "9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    "status": "ENDED",
    "source_language": "en",
    "target_language": "es",
    "voice_id": null,
    "audio_protocol": "pcm16",
    "sample_rate": 16000,
    "max_duration_seconds": 1800,
    "end_reason": "api_terminated",
    "session_seconds": null,
    "billable_minutes": null,
    "created_at": "2026-06-04T18:05:07.885Z",
    "started_at": null,
    "ended_at": "2026-06-04T18:06:08.684Z"
  },
  "errors": null
}

Get Translation Session Create Encrypted Key

⌘I

​Authentication

​Path Parameters

​Body Parameters

​Response

Authentication

Path Parameters

Body Parameters

Response