Skip to main content
DELETE
/
files
Delete files
curl --request DELETE \
  --url https://api.soket.ai/transcribe/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "file_ids": [
    "<string>"
  ]
}
'
{
  "deleted_file_ids": [
    "<string>"
  ],
  "deleted_count": 123,
  "storage_objects_deleted": 123,
  "jobs_cleaned": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.tensorstudio.ai/llms.txt

Use this file to discover all available pages before exploring further.

Delete one or more uploaded files by file_id. Removes storage objects, upload records, and any related transcription jobs.

​
Request body

{
  "file_ids": [
    "1374132b-b5db-4ec3-9cf1-f61f982e89b0",
    "2485243c-c6ec-5fd4-0dg2-g72g093f90c1"
  ]
}

​
Example

curl -X DELETE "https://api.soket.ai/transcribe/files" \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"file_ids": ["1374132b-b5db-4ec3-9cf1-f61f982e89b0"]}'

​
Typical response

{
  "deleted_file_ids": ["1374132b-b5db-4ec3-9cf1-f61f982e89b0"],
  "deleted_count": 1,
  "storage_objects_deleted": 1,
  "jobs_cleaned": 0
}
Returns 404 if any file_id is not found or not owned by the authenticated user.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
file_ids
string[]
required

Response

Files deleted

​
deleted_file_ids
string[]
​
deleted_count
integer
​
storage_objects_deleted
integer
​
jobs_cleaned
integer