Soniox
Docs
API referenceREST APITranscriptions

Delete transcription

Permanently deletes a transcription and its associated files. Cannot delete transcriptions that are currently processing.

DELETE
/v1/transcriptions/{transcription_id}

Headers

AuthorizationRequiredBearer <SONIOX_API_KEY>

Path parameters

transcription_idRequiredstring
Format: "uuid"

Response

204

Transcription deleted.

Errors

Transcription deleted.

Authentication error.

{
  "status_code": 401,
  "error_type": "unauthenticated",
  "message": "Incorrect API key provided. You can get an API key at https://console.soniox.com",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}

Transcription not found.

Error types:

  • transcription_not_found: Transcription could not be found.

{
  "status_code": 400,
  "error_type": "transcription_not_found",
  "message": "Transcription could not be found.",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}

Invalid transcription state.

Error types:

  • transcription_invalid_state:
    • Cannot delete transcription with processing status.

{
  "status_code": 400,
  "error_type": "transcription_invalid_state",
  "message": "Can only get transcript with completed status.",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}

Internal server error.

{
  "status_code": 500,
  "error_type": "internal_error",
  "message": "The server encountered an error. Please try again. If the issue persists contact support@soniox.com.",
  "validation_errors": [],
  "request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda"
}