POST /v1/files
Uploads an audio file so it can be sent to Transcribe by id, without hosting it anywhere public. Returns a file_id to pass as {"type": "file_id", "file_id": "..."}.
Three ways to upload
# a file from disk
curl -X POST https://ark.dewaweb.com/v1/files \
-H "Authorization: Bearer ark_live_YOUR_KEY" \
-F "[email protected];type=audio/mpeg"
# raw bytes, no encoding overhead
curl -X POST https://ark.dewaweb.com/v1/files \
-H "Authorization: Bearer ark_live_YOUR_KEY" \
-H "Content-Type: audio/mpeg" \
-H "X-Filename: recording.mp3" \
--data-binary @recording.mp3
# base64 in json
curl -X POST https://ark.dewaweb.com/v1/files \
-H "Authorization: Bearer ark_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"data": "SUQzBAAAAA...", "filename": "recording.mp3", "content_type": "audio/mpeg"}'Response
{
"id": "file_8f96360be4d2a854b97d06e6b3c8142e",
"object": "file",
"filename": "recording.mp3",
"content_type": "audio/mpeg",
"bytes": 74062,
"purpose": "audio",
"created_at": "2026-09-24T09:09:31.335Z"
}Managing uploads
| Parameter | Type | Default | Description |
|---|---|---|---|
| GET /v1/files | — | — | Your most recent uploads |
| GET /v1/files/{id} | — | — | One upload, or 404 if it is not yours |
| DELETE /v1/files/{id} | — | — | Removes it from storage immediately |
Retention
An upload is deleted 24 hours after it arrives, whether or not you use it, and you can delete one sooner. A file is only ever readable by the account that uploaded it, and is never exposed on a public URL.