Skip to content
/
Delete transcription
Last updated

Delete transcription

Delete a transcription by ID. Performs a soft delete locally and attempts to delete the associated data from the upstream provider.

DELETEhttps://api.aitronos.com/v1/audio/transcribe/{transcription_id}

Soft-deletes the transcription record from the database and attempts to delete the associated data from the upstream transcription provider. If the upstream deletion fails, the local record is still marked as deleted and the upstream deletion is scheduled for retry.

The response includes a deleted_upstream flag indicating whether the upstream deletion was successful.

Path Parameters

transcription_id string required

The transcription ID with trans_ prefix (e.g., trans_a1b2c3d4e5f6...).

Returns

Returns a success envelope with:

  • data.deleted -- true confirming the deletion.
  • data.transcription_id -- The ID of the deleted transcription.
  • data.deleted_at -- ISO 8601 timestamp of when the deletion occurred.
  • data.deleted_upstream -- true if the upstream provider data was also deleted, false if the upstream deletion failed (will be retried).
  • metadata -- Request metadata: request_id, timestamp, processing_time_ms.
cURL
curl -s -X DELETE https://api.aitronos.com/v1/audio/transcribe/trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 \
  -H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool
Previous page
Next page