curl --request DELETE \
--url https://api.aircaps.com/v1/transcripts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aircaps.com/v1/transcripts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aircaps.com/v1/transcripts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "tr_01k6z3m4q8w7e5r2t1y0u9i8o7",
"object": "transcript",
"status": "completed",
"created_at": "2026-10-06T18:01:02.123Z",
"started_at": "2026-10-06T18:01:02.456Z",
"completed_at": "2026-10-06T18:01:31.789Z",
"audio_url": null,
"file_id": "file_01k6z3m4q8w7e5r2t1y0u9i8o7",
"language_code": "en",
"model": "a5s-async-v1",
"audio_duration": 3600.512,
"metadata": {
"meeting_id": 42
},
"webhook_url": "https://example.com/hooks/aircaps",
"webhook_status_code": 200,
"error": null,
"deleted": true
}{
"error": {
"type": "authentication_error",
"code": "unauthorized",
"message": "invalid API key",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}{
"error": {
"type": "permission_error",
"code": "account_disabled",
"message": "this account is disabled",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}{
"error": {
"type": "invalid_request_error",
"code": "not_found",
"message": "transcript not found",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "internal error",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}Delete a transcript
Cancels a queued or processing job (its error.code becomes canceled), or deletes a finished transcript and its stored data. Afterwards the ID returns 404.
curl --request DELETE \
--url https://api.aircaps.com/v1/transcripts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aircaps.com/v1/transcripts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aircaps.com/v1/transcripts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "tr_01k6z3m4q8w7e5r2t1y0u9i8o7",
"object": "transcript",
"status": "completed",
"created_at": "2026-10-06T18:01:02.123Z",
"started_at": "2026-10-06T18:01:02.456Z",
"completed_at": "2026-10-06T18:01:31.789Z",
"audio_url": null,
"file_id": "file_01k6z3m4q8w7e5r2t1y0u9i8o7",
"language_code": "en",
"model": "a5s-async-v1",
"audio_duration": 3600.512,
"metadata": {
"meeting_id": 42
},
"webhook_url": "https://example.com/hooks/aircaps",
"webhook_status_code": 200,
"error": null,
"deleted": true
}{
"error": {
"type": "authentication_error",
"code": "unauthorized",
"message": "invalid API key",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}{
"error": {
"type": "permission_error",
"code": "account_disabled",
"message": "this account is disabled",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}{
"error": {
"type": "invalid_request_error",
"code": "not_found",
"message": "transcript not found",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "internal error",
"param": null,
"request_id": "req_01k6z3m4q8w7e5r2t1y0u9i8o7"
}
}Authorizations
Your API key: Authorization: Bearer aircaps_sk_...
Path Parameters
Transcript ID.
"tr_01k6z3m4q8w7e5r2t1y0u9i8o7"
Response
The transcript as it was, with deleted: true.
A transcript without its result fields.
Transcript ID.
"tr_01k6z3m4q8w7e5r2t1y0u9i8o7"
transcript "transcript"
queued: waiting for a processing slot. processing: being transcribed. completed: result fields present. error: see error.
queued, processing, completed, error When the transcript was created (UTC).
When processing started.
When the job finished (completed or error).
The submitted audio_url, if any.
The submitted file_id, if any.
Language of the transcript (normalised).
en a5s-async-v1 Audio duration in seconds, once known.
3600.512
Your metadata, echoed back.
Webhook target, if any.
HTTP status of the last webhook delivery.
Set when status is error.
Show child attributes
Show child attributes
true