End Translation Session

Terminate a translation session from the server side

DELETE /v1/translation/sessions/{session_id}

cURL

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

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

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

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
}