AIaircaps
Transcripts

Delete a transcript

Cancels a queued or processing job (its error.code becomes canceled), or deletes a finished transcript and its stored data, including the uploaded file it used. Afterwards the ID returns 404.

delete/v1/transcripts/{id}

Request

  • Base URL
    https://api.aircaps.com
  • URL
    https://api.aircaps.com/v1/transcripts/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:tr_01k6z3m4q8w7e5r2t1y0u9i8o7

Transcript ID.

Response

The transcript, with deleted: true. Your metadata, audio_url and webhook settings are already removed.

idstring required

Transcript ID.

object'transcript' required
status'queued' | 'processing' | 'completed' | 'error' required

queued: waiting for a processing slot. processing: being transcribed. completed: result fields present. error: see error.

created_atstring date-time required

When the transcript was created (UTC).

started_atstring date-time nullable required

When processing started.

completed_atstring date-time nullable required

When the job finished (completed or error).

audio_urlstring nullable required

The submitted audio_url, if any.

file_idstring nullable required

The submitted file_id, if any.

language_code'en' required

Language of the transcript (normalised).

model'a5s-async-v1' required
audio_durationnumber nullable required

Audio duration in seconds, once known.

metadataobject nullable required

Your metadata, echoed back.

webhook_urlstring nullable required

Webhook target, if any.

webhook_status'pending' | 'delivered' | 'failed' | 'null' nullable required

Webhook delivery state, if webhook_url was set.

webhook_status_codeinteger nullable required

HTTP status of the last webhook delivery.

deletedtrue

Example response

{
  "id": "tr_01k6z3m4q8w7e5r2t1y0u9i8o7",
  "object": "transcript",
  "audio_duration": 3600.512
}

Changes

No recorded changes to this operation across all 1 revision of this API.