DocsAPI reference

OpenAPI specification

Model IDs and options in examples are illustrative. Select an available model from GET /v1/models and check its capabilities and current prices.

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

ParameterTypeDefaultDescription
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.