Files

`POST /v1/files` — upload files for use with batch jobs and audio transcription. Not a general-purpose object store.

Not your CDN.

The Files API is for API request data, not your application data. Files are deleted after 30 days unless attached to an active batch or transcription job. Use S3, R2, or Bunny for production assets.

Upload

curl https://api.tomoul.ai/v1/files \
  -H "Authorization: Bearer $TOMOUL_KEY" \
  -F purpose=transcription \
  -F [email protected]

Response:

{
  "id":         "file_01HV...",
  "object":     "file",
  "purpose":    "transcription",
  "filename":   "meeting.mp3",
  "bytes":      4823104,
  "created_at": "2026-05-13T09:11:02Z"
}

List

curl https://api.tomoul.ai/v1/files \
  -H "Authorization: Bearer $TOMOUL_KEY"

Filter by purpose with ?purpose=transcription.

Retrieve metadata

curl https://api.tomoul.ai/v1/files/$FILE_ID \
  -H "Authorization: Bearer $TOMOUL_KEY"

Download content

curl https://api.tomoul.ai/v1/files/$FILE_ID/content \
  -H "Authorization: Bearer $TOMOUL_KEY" \
  -o downloaded.mp3

Delete

curl -X DELETE https://api.tomoul.ai/v1/files/$FILE_ID \
  -H "Authorization: Bearer $TOMOUL_KEY"

Purposes

Purpose	Used by
`transcription`	Audio for `/v1/audio/transcriptions`.
`batch`	JSONL inputs for batch jobs (Phase 2).
`assistants`	Not supported — no Assistants API.

← Previous

Models

Audio

Last updated 13 May 2026Edit this page on GitHub