Files

Upload a file

Upload up to 1 GB in the request body. For larger files (up to 5 GB), use an upload URL. An upload that takes longer than about 2.5 minutes is answered with a 303 redirect to its result: follow redirects (most HTTP clients do by default).

post/v1/files

Request

  • Base URL
    https://api.aircaps.com
  • URL
    https://api.aircaps.com/v1/files
  • Auth
    HTTP bearer

Request body application/octet-stream

string binary required

Response

File stored.

idstring required

Use as file_id.

object'file' required
size_bytesinteger required
created_atstring date-time required
expires_atstring date-time required

Usable until this time (24 hours after upload); the file is deleted within the following 24 hours, or right away when a transcript that used it is deleted.

Example response

{
  "id": "file_01k6z3m4q8w7e5r2t1y0u9i8o7",
  "size_bytes": 115200044
}

Changes

No recorded changes to this operation across all 1 revision of this API.